SecurityTokenHandler.CreateSecurityTokenReference 方法

定義

命名空間:
System.IdentityModel.Tokens
組件:
System.IdentityModel.dll

在衍生類別中覆寫時，為該類別所處理的令牌建立安全性令牌參考。 這個方法通常由安全性令牌服務 （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 是否應該建立一個未附加的參考。

傳回

SecurityKeyIdentifierClause

一個用於參考指定標記的金鑰識別子句。

範例

以下程式碼說明如何覆寫 CreateSecurityTokenReference 從指定標記建立金鑰識別子句的方法。 程式碼取自樣本 Custom Token 。 本範例提供自訂類別，使簡單網路令牌（SWT）能夠處理。 關於此範例及其他 WIF 範例的資訊，以及下載地點，請參閱 WIF 程式碼範例索引。

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

備註

預設情況下，此方法會 NotImplementedException 拋出例外。

衍生類別會覆寫此方法，回傳一個金鑰識別子句（SecurityKeyIdentifierClause），可用來建立 <wsse:SecurityTokenReference> 指定標記的元素。

從類別的實作 SecurityTokenService 中呼叫。

通常，除非在建立自訂安全令牌服務時，否則不需要使用 a SecurityKeyIdentifierClause 。 當安全權杖服務回傳安全權杖時，已發出的安全權杖會包含附加與未附加的安全權杖的參考。 附加參考指的是包含在 SOAP 訊息安全標頭中的安全權杖，而未附加的參考則指未包含在 SOAP 訊息安全標頭中的安全權杖。 這些參考通常能確認發行證券代幣的真實性。

適用於