共用方式為


SecurityTokenHandler.CreateSecurityTokenReference 方法

定義

在衍生類別中覆寫時,建立該類別所處理之權杖的安全性權杖參考。 這個方法通常是由安全性權杖服務 (STS) 呼叫。

public:
 virtual System::IdentityModel::Tokens::SecurityKeyIdentifierClause ^ CreateSecurityTokenReference(System::IdentityModel::Tokens::SecurityToken ^ token, bool attached);
public virtual System.IdentityModel.Tokens.SecurityKeyIdentifierClause CreateSecurityTokenReference (System.IdentityModel.Tokens.SecurityToken token, bool attached);
abstract member CreateSecurityTokenReference : System.IdentityModel.Tokens.SecurityToken * bool -> System.IdentityModel.Tokens.SecurityKeyIdentifierClause
override this.CreateSecurityTokenReference : System.IdentityModel.Tokens.SecurityToken * bool -> System.IdentityModel.Tokens.SecurityKeyIdentifierClause
Public Overridable Function CreateSecurityTokenReference (token As SecurityToken, attached As Boolean) As SecurityKeyIdentifierClause

參數

token
SecurityToken

要為其建立參考的權杖。

attached
Boolean

如果應建立附加的參考,則為 true,如果應建立為未附加的參考,則為 false

傳回

參考所指定語彙基元的索引鍵識別項子句。

範例

下列程式代碼示範如何覆寫 CreateSecurityTokenReference 方法,以從指定的令牌建立密鑰標識子句。 程式代碼取自 Custom Token 範例。 此範例提供自定義類別,可讓您處理簡單 Web 令牌 (SWT) 。 如需此範例和其他可供 WIF 下載範例的資訊,請參閱 WIF 程式代碼範例索引

public override SecurityKeyIdentifierClause CreateSecurityTokenReference(SecurityToken token, bool attached)
{
    return token.CreateKeyIdentifierClause<LocalIdKeyIdentifierClause>();           
}

備註

根據預設,這個方法會擲回例外狀況 NotImplementedException

衍生類別會覆寫這個方法,以傳回索引鍵標識子子句 (SecurityKeyIdentifierClause) ,可用來為指定的標記建立 <wsse:SecurityTokenReference> 元素。

從類別的實作呼叫 SecurityTokenService

一般而言, SecurityKeyIdentifierClause 不需要使用 ,而不是建立自定義安全性令牌服務時。 當安全性權杖服務傳回安全性權杖時,所發出的安全性權杖會包含已附加及未附加之安全性權杖的參考。 附加的參考會參考包含在 SOAP 訊息之安全性標頭中的安全性權杖,而未附加的參考則會參考未包含在 SOAP 訊息之安全性標頭中的安全性權杖。 這些參考通常會證明這些發出之安全性權杖的真實性。

適用於