SessionSecurityTokenHandler.WriteToken 方法

定義

命名空間:

System.IdentityModel.Tokens

組件:

System.IdentityModel.dll

將語彙基元序列化。

多載

WriteToken(SessionSecurityToken)	將指定的語彙基元序列化至位元組陣列。
WriteToken(XmlWriter, SecurityToken)	使用指定的 XML 寫入器，序列化指定的語彙基元。

備註

默認實作會將令牌串行化為 WS-Secure Conversation 2005 或 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。

備註

透過 建立和 XML 寫入器 MemoryStream 並叫 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-Secure Conversation 版本。

備註

根據 屬性的值SessionSecurityToken.SecureConversationVersion，默認實作會將指定的標記串行化為 WS-Secure Conversation 2005 或 WS-Secure Conversation 1.3 <wsc:SecurityContextToken> 元素。 屬性 SessionSecurityToken.Id 會串行化為 Id 屬性。 屬性 SessionSecurityToken.ContextId 會串行化為 <Identifier> 子專案。 如果不是 null ， SessionSecurityToken.KeyGeneration 則屬性會串行化為 <Instance> 專案。 最後，如果 SessionSecurityToken.IsReferenceMode 屬性為 false，則整個令牌會串行化為二進位數位列，而這個數位會傳遞至 ApplyTransforms 要編碼的方法。 然後，編碼的令牌會以base64編碼值的形式寫入和 CookieNamespace 屬性所CookieElementName指定的元素和命名空間。 SessionSecurityToken.IsReferenceMode如果 屬性為 true，則令牌不會串行化。

另請參閱

• CanWriteToken