SecurityTokenManager.CreateSecurityTokenSerializer Method

Definition

Namespace:

System.IdentityModel.Selectors

Assembly:

System.ServiceModel.Primitives.dll

Package:

System.ServiceModel.Primitives v8.0.0

Source:

SecurityTokenManager.cs

Gets an XML serializer that can serialize security tokens in the specified version of the WS-* specifications.

public:
 abstract System::IdentityModel::Selectors::SecurityTokenSerializer ^ CreateSecurityTokenSerializer(System::IdentityModel::Selectors::SecurityTokenVersion ^ version);

public abstract System.IdentityModel.Selectors.SecurityTokenSerializer CreateSecurityTokenSerializer (System.IdentityModel.Selectors.SecurityTokenVersion version);

abstract member CreateSecurityTokenSerializer : System.IdentityModel.Selectors.SecurityTokenVersion -> System.IdentityModel.Selectors.SecurityTokenSerializer

Public MustOverride Function CreateSecurityTokenSerializer (version As SecurityTokenVersion) As SecurityTokenSerializer

Parameters

version

SecurityTokenVersion

A SecurityTokenVersion that specifies the WS-* specification versions that security tokens adhere to.

Returns

SecurityTokenSerializer

A SecurityTokenSerializer to serialize the security tokens.

Remarks

To add serialization support for a custom token, derive a class from WSSecurityTokenSerializer and return an instance of that class for the CreateSecurityTokenSerializer(SecurityTokenVersion) method. The WSSecurityTokenSerializer class, which derives from the SecurityTokenSerializer class, is capable of serializing and deserializing the security tokens that ship with WCF. Thus, to add support for a custom token to the serializer, override the virtual methods in the WSSecurityTokenSerializer class, add code that checks whether the desired security token is the custom token, and, if not, call the base class method.