SessionSecurityTokenHandler.WriteToken 方法

定义

命名空间:

System.IdentityModel.Tokens

程序集:

System.IdentityModel.dll

序列化标记。

重载

WriteToken(SessionSecurityToken)	将指定令牌序列化为字节数组。
WriteToken(XmlWriter, SecurityToken)	使用指定 XML 编写器序列化指定令牌。

注解

默认实现将令牌序列化为 WS-Secure Conversation Feb2005 或 WS-Secure Conversation 1.3 <wsc:SecurityContextToken> 元素。

WriteToken(SessionSecurityToken)

将指定令牌序列化为字节数组。

public:
 virtual cli::array <System::Byte> ^ WriteToken(System::IdentityModel::Tokens::SessionSecurityToken ^ sessionToken);

public virtual byte[] WriteToken (System.IdentityModel.Tokens.SessionSecurityToken sessionToken);

override this.WriteToken : System.IdentityModel.Tokens.SessionSecurityToken -> byte[]

Public Overridable Function WriteToken (sessionToken As SessionSecurityToken) As Byte()

参数

sessionToken

SessionSecurityToken

要写入的标记。

返回

Byte[]

编码的字节数组。

例外

ArgumentNullException

sessiontoken 为 null。

注解

通过在 上 MemoryStream 创建 和 XML 编写器并调用 方法，序列化 SessionSecurityTokenHandler.WriteToken(XmlWriter, SecurityToken) 指定的标记。 有关更多详细信息，请参阅该重载。

另请参阅

• CanWriteToken

WriteToken(XmlWriter, SecurityToken)

使用指定 XML 编写器序列化指定令牌。

public:
 override void WriteToken(System::Xml::XmlWriter ^ writer, System::IdentityModel::Tokens::SecurityToken ^ token);

public override void WriteToken (System.Xml.XmlWriter writer, System.IdentityModel.Tokens.SecurityToken token);

override this.WriteToken : System.Xml.XmlWriter * System.IdentityModel.Tokens.SecurityToken -> unit

Public Overrides Sub WriteToken (writer As XmlWriter, token As SecurityToken)

参数

writer

XmlWriter

用于序列化令牌的 XML 编写器。

token

SecurityToken

要序列化的标记。 SessionSecurityToken 的一个实例。

例外

ArgumentNullException

writer 为 null。

或

token 为 null。

InvalidOperationException

token 无法从 SessionSecurityToken 赋值。

- 或 -

令牌的 SecureConversationVersion 指定处理程序不支持的 WS 安全对话的版本。

注解

默认实现将指定的标记序列化为 WS-Secure Conversation Feb2005 或 WS-Secure Conversation 1.3 <wsc:SecurityContextToken> 元素，具体取决于 属性的值 SessionSecurityToken.SecureConversationVersion 。 属性 SessionSecurityToken.Id 序列化为 Id 属性。 属性 SessionSecurityToken.ContextId 序列化为 <Identifier> 子元素。 如果不是 null ，则 SessionSecurityToken.KeyGeneration 属性序列化为 <Instance> 元素。 最后，如果 SessionSecurityToken.IsReferenceMode 属性为 false，则整个标记将序列化为二进制数组， ApplyTransforms 该数组将传递给要编码的方法。 然后，将编码的标记作为 base64 编码值写入到 由 CookieElementName 和 CookieNamespace 属性指定的元素和命名空间。 SessionSecurityToken.IsReferenceMode如果 属性为 true，则不会序列化令牌。

另请参阅

• CanWriteToken