This documentation is archived and is not being maintained.

SamlDoNotCacheCondition Class

Represents a condition that must be taken into account when assessing the validity of a SAML assertion.


Namespace:  System.IdentityModel.Tokens
Assembly:  System.IdentityModel (in System.IdentityModel.dll)

public class SamlDoNotCacheCondition : SamlCondition

The SamlDoNotCacheCondition type exposes the following members.

Public methodSamlDoNotCacheConditionInitializes a new instance of the SamlDoNotCacheCondition class.

Public propertyIsReadOnlyGets a value indicating whether the properties of this instance are read-only. (Overrides SamlCondition.IsReadOnly.)

Public methodEquals(Object)Determines whether the specified Object is equal to the current Object. (Inherited from Object.)
Protected methodFinalizeAllows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
Public methodGetHashCodeServes as a hash function for a particular type. (Inherited from Object.)
Public methodGetTypeGets the Type of the current instance. (Inherited from Object.)
Public methodMakeReadOnlyCauses this instance to be read-only. (Overrides SamlCondition.MakeReadOnly().)
Protected methodMemberwiseCloneCreates a shallow copy of the current Object. (Inherited from Object.)
Public methodReadXmlReads the <saml:DoNotCacheCondition> element from the specified XML reader. (Overrides SamlCondition.ReadXml(XmlDictionaryReader, SamlSerializer, SecurityTokenSerializer, SecurityTokenResolver).)
Public methodToStringReturns a string that represents the current object. (Inherited from Object.)
Public methodWriteXmlWrites the <saml:DoNotCacheCondition> element into the specified XML serializer. (Overrides SamlCondition.WriteXml(XmlDictionaryWriter, SamlSerializer, SecurityTokenSerializer).)

SamlSecurityToken security tokens specify their claims using SAML assertions and a set of conditions that must be taken into account when assessing the validity of the SAML assertion. The SamlDoNotCacheCondition class represents one of the conditions defined by the SAML specification and it asserts that the SAML assertion must not be cached. To specify this condition for a SAML assertion, add the SamlDoNotCacheCondition class to the collection returned by the Conditions property.


When the SamlDoNotCacheCondition is added as a condition to a SamlSecurityToken security token that is issued by a security token service for the client, a client does cache the security token. Because the client does not inspect the contents of the issued token, the token is cached. The client is token agnostic for issued tokens type and processes it the returned issued token as an opaque XML element. However, security never caches the received issued token on the service side; it only caches the claims that are extracted from it during the token authentication process.

.NET Framework

Supported in: 4, 3.5, 3.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.