SessionSecurityTokenHandler.ReadToken 方法

定義

命名空間:

System.IdentityModel.Tokens

組件:

System.IdentityModel.dll

讀取 SessionSecurityToken。

多載

ReadToken(XmlReader)	使用指定的 XML 讀取器讀取 SessionSecurityToken。
ReadToken(Byte[], SecurityTokenResolver)	使用指定的語彙基元解析程式從位元組資料流讀取SessionSecurityToken。
ReadToken(XmlReader, SecurityTokenResolver)	使用指定的 XML 讀取器和權杖解析程式，讀取 SessionSecurityToken。

備註

重要

使用不信任的資料呼叫此方法，會造成安全性上的風險。 呼叫此方法時，請一律使用信任的資料。 如需詳細資訊，請參閱 驗證所有輸入。

默認實作會從 WS-Secure Conversation 2005 或 WS-Secure Conversation 1.3 <wsc:SecurityContextToken> 元素還原串行化令牌。

ReadToken(XmlReader)

使用指定的 XML 讀取器讀取 SessionSecurityToken。

public:
 override System::IdentityModel::Tokens::SecurityToken ^ ReadToken(System::Xml::XmlReader ^ reader);

public override System.IdentityModel.Tokens.SecurityToken ReadToken (System.Xml.XmlReader reader);

override this.ReadToken : System.Xml.XmlReader -> System.IdentityModel.Tokens.SecurityToken

Public Overrides Function ReadToken (reader As XmlReader) As SecurityToken

參數

reader

XmlReader

連入之 XmlReader 上的 SecurityToken。

傳回

SecurityToken

已讀取的工作階段安全性權杖，這是 SessionSecurityToken 的執行個體。

例外狀況

ArgumentNullException

reader 為 null。

SecurityTokenException

讀取器未放置在SessionSecurityToken，或SessionSecurityToken無法讀取。

備註

重要

使用不信任的資料呼叫此方法，會造成安全性上的風險。 呼叫此方法時，請一律使用信任的資料。 如需詳細資訊，請參閱 驗證所有輸入。

讀取器必須位於 WS-Secure Conversation 2005 或 WS-Secure Conversation 1.3 <wsc:SecurityContextToken> 元素。

默認實作會 SessionSecurityTokenHandler.ReadToken(XmlReader, SecurityTokenResolver) 使用預設令牌解析程式叫用 方法。

ReadToken(Byte[], SecurityTokenResolver)

使用指定的語彙基元解析程式從位元組資料流讀取SessionSecurityToken。

public:
 virtual System::IdentityModel::Tokens::SecurityToken ^ ReadToken(cli::array <System::Byte> ^ token, System::IdentityModel::Selectors::SecurityTokenResolver ^ tokenResolver);

public virtual System.IdentityModel.Tokens.SecurityToken ReadToken (byte[] token, System.IdentityModel.Selectors.SecurityTokenResolver tokenResolver);

override this.ReadToken : byte[] * System.IdentityModel.Selectors.SecurityTokenResolver -> System.IdentityModel.Tokens.SecurityToken

Public Overridable Function ReadToken (token As Byte(), tokenResolver As SecurityTokenResolver) As SecurityToken

參數

token

Byte[]

包含權杖的位元組資料流。

tokenResolver

SecurityTokenResolver

要使用的權杖解析程式。

傳回

SecurityToken

已讀取的 SessionSecurityToken。

備註

重要

使用不信任的資料呼叫此方法，會造成安全性上的風險。 呼叫此方法時，請一律使用信任的資料。 如需詳細資訊，請參閱 驗證所有輸入。

默認實作會 XmlDictionaryReader 透過令牌建立 ，並叫用 SessionSecurityTokenHandler.ReadToken(XmlReader, SecurityTokenResolver) 方法。

ReadToken(XmlReader, SecurityTokenResolver)

使用指定的 XML 讀取器和權杖解析程式，讀取 SessionSecurityToken。

public:
 override System::IdentityModel::Tokens::SecurityToken ^ ReadToken(System::Xml::XmlReader ^ reader, System::IdentityModel::Selectors::SecurityTokenResolver ^ tokenResolver);

public override System.IdentityModel.Tokens.SecurityToken ReadToken (System.Xml.XmlReader reader, System.IdentityModel.Selectors.SecurityTokenResolver tokenResolver);

override this.ReadToken : System.Xml.XmlReader * System.IdentityModel.Selectors.SecurityTokenResolver -> System.IdentityModel.Tokens.SecurityToken

Public Overrides Function ReadToken (reader As XmlReader, tokenResolver As SecurityTokenResolver) As SecurityToken

參數

reader

XmlReader

連入之 XmlReader 上的 SecurityToken。

tokenResolver

SecurityTokenResolver

可用來解析 SecurityTokenResolver 的 SessionSecurityToken。

傳回

SecurityToken

已讀取的工作階段安全性權杖，這是 SessionSecurityToken 的執行個體。

例外狀況

ArgumentNullException

reader 為 null。

-或-

tokenResolver 為 null。

SecurityTokenException

讀取器未放置在SessionSecurityToken，或SessionSecurityToken無法讀取。

備註

重要

使用不信任的資料呼叫此方法，會造成安全性上的風險。 呼叫此方法時，請一律使用信任的資料。 如需詳細資訊，請參閱 驗證所有輸入。

讀取器必須位於 WS-Secure Conversation 2005 或 WS-Secure Conversation 1.3 <wsc:SecurityContextToken> 元素。

如果快取令牌數據，則會從令牌快取讀取，這是類別的 SessionSecurityTokenCache 實例。 否則，令牌數據會從 和 CookieNamespace 屬性所CookieElementName指定的元素子<wsc:SecurityContextToken>專案讀取，並ApplyTransforms叫用 方法來譯碼Cookie。

如需如何將會話令牌串行化為 <SecurityContextToken 元素的詳細資訊，請參閱 SessionSecurityTokenHandler.WriteToken(XmlWriter, SecurityToken) 方法。