<cacheLimit> Element

Article
09/13/2006

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

Attribute	Description
value	Specifies the limit on the number of security tokens that are cached. The default value is 2048.

Child Elements

None.

Parent Elements

Element	Description
<add> Element for <securityTokenManager>	Adds a user-supplied custom security token manager for an XML-based security token to the application domain.

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>