<cacheLimit> Element

Sets the limit on the number of security tokens that are cached.

<microsoft.web.services3> Element
  <security> Element
    <securityTokenManager> Element
      <add> Element for <securityTokenManager>

<cacheLimit value="Number of security tokens to cache." />

Attributes and Elements

Attributes

Child Elements

None.

Parent Elements

Remarks

Use the <cacheLimit> element to specify the maximum number of security tokens a security token manager should cache. The <cacheLimit> element applies when the parent <add> Element for <securityTokenManager> references a security token manager that derives from the KeyIdentifierCachedSecurityTokenManager class, such as the built-in SecurityContextTokenManager and KerberosTokenManager security token managers.

Security token managers, such as the built-in SecurityContextTokenManager and KerberosTokenManager cache security tokens on the client and Web service to improve performance.

Before adding the <cacheLimit> element to a configuration file, you must add the microsoft.web.services3 configuration section handler to the configuration file. For information about adding the microsoft.web.services3 configuration section handler, see <section> Element.

Example

The following example sets the maximum number of cached SecurityContextToken security tokens to 30.

<configuration>
  <microsoft.web.services3>
    <securityTokenManager>
      <add 
       type="Microsoft.Web.Services3.Security.Tokens.SecurityContextTokenManager, Microsoft.Web.Services3, Version=3.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35"
       namespace="https://schemas.xmlsoap.org/ws/2004/04/sc"
       localName="SecurityContextToken" >
        <cacheLimit value="30" />
      </add>
    </securityTokenManager>
  </microsoft.web.services3>
</configuration>

See Also

Tasks

How to: Create a Security Token Manager for a Custom Security Token