SamlSubject 建構函式

定義

命名空間:

System.IdentityModel.Tokens

組件:

System.IdentityModel.dll

初始化 SamlSubject 類別的新執行個體。

多載

SamlSubject()	初始化 SamlSubject 類別的新執行個體。
SamlSubject(String, String, String)	使用指定的名稱、名稱所在的網域以及名稱所使用的格式，初始化 SamlSubject 類別的新執行個體。
SamlSubject(String, String, String, IEnumerable<String>, String, SecurityKeyIdentifier)	使用指定的名稱、名稱所在的網域、名稱所使用的格式、驗證通訊協定、其他驗證資訊以及金鑰識別碼，初始化 SamlSubject 類別的新執行個體。

SamlSubject()

初始化 SamlSubject 類別的新執行個體。

public:
 SamlSubject();

public SamlSubject ();

Public Sub New ()

備註

這個建構函式會將 IsReadOnly 屬性初始化為 false。

SamlSubject(String, String, String)

使用指定的名稱、名稱所在的網域以及名稱所使用的格式，初始化 SamlSubject 類別的新執行個體。

public:
 SamlSubject(System::String ^ nameFormat, System::String ^ nameQualifier, System::String ^ name);

public SamlSubject (string nameFormat, string nameQualifier, string name);

new System.IdentityModel.Tokens.SamlSubject : string * string * string -> System.IdentityModel.Tokens.SamlSubject

Public Sub New (nameFormat As String, nameQualifier As String, name As String)

參數

nameFormat

String

表示 name 參數所採用之格式的 URI 參考。 設定 NameFormat 屬性。

nameQualifier

String

name 參數所在的網域。 設定 NameQualifier 屬性。

name

String

主體名稱。 設定 Name 屬性。

例外狀況

ArgumentNullException

name 為 null 或 Empty。

備註

雖然用來指定名稱的格式具有擴充性，但是下表列出的是已定義在 SAML 規格中的格式。

格式	描述
EmailNamespace	URI，表示已用電子郵件地址方式指定了 SAML 判斷提示的主體。
UserNameNamespace	URI，表示會以 Windows 網域帳戶方式來指定 SAML 判斷提示的主體。

SamlSubject(String, String, String, IEnumerable<String>, String, SecurityKeyIdentifier)

使用指定的名稱、名稱所在的網域、名稱所使用的格式、驗證通訊協定、其他驗證資訊以及金鑰識別碼，初始化 SamlSubject 類別的新執行個體。

public:
 SamlSubject(System::String ^ nameFormat, System::String ^ nameQualifier, System::String ^ name, System::Collections::Generic::IEnumerable<System::String ^> ^ confirmations, System::String ^ confirmationData, System::IdentityModel::Tokens::SecurityKeyIdentifier ^ securityKeyIdentifier);

public SamlSubject (string nameFormat, string nameQualifier, string name, System.Collections.Generic.IEnumerable<string> confirmations, string confirmationData, System.IdentityModel.Tokens.SecurityKeyIdentifier securityKeyIdentifier);

new System.IdentityModel.Tokens.SamlSubject : string * string * string * seq<string> * string * System.IdentityModel.Tokens.SecurityKeyIdentifier -> System.IdentityModel.Tokens.SamlSubject

Public Sub New (nameFormat As String, nameQualifier As String, name As String, confirmations As IEnumerable(Of String), confirmationData As String, securityKeyIdentifier As SecurityKeyIdentifier)

參數

nameFormat

String

表示 name 參數所採用之格式的 URI 參考。 設定 NameFormat 屬性。

nameQualifier

String

name 參數所在的網域。 設定 NameQualifier 屬性。

name

String

主體名稱。 設定 Name 屬性。

confirmations

IEnumerable<String>

型別為 IEnumerable<T> 的 String，其中包含的 URI 參考會識別通訊協定，以驗證主體。 設定 ConfirmationMethods 屬性。

confirmationData

String

驗證通訊協定可使用的其他驗證資訊。 設定 SubjectConfirmationData 屬性。

securityKeyIdentifier

SecurityKeyIdentifier

SecurityKeyIdentifier，可讓使用者存取 SamlSecurityToken 安全性權杖主體所持有的密碼編譯金鑰。 設定 KeyIdentifier 屬性。

例外狀況

ArgumentNullException

name 為 null 或 Empty。

ArgumentException

confirmations 包含 null 或 Empty 成員。

-或-

confirmations 不包含任何成員，而且 name 是 null 或 Empty。

-或-

confirmations 不包含任何成員，而且 confirmationData 或 securityKeyIdentifier 不是 null。

備註

用來指定 name 參數名稱的格式具有擴充性；下表列出的是已定義在 SAML 規格中的格式。

格式	描述
EmailNamespace	URI，表示已用電子郵件地址方式指定了 SAML 判斷提示的主體。
UserNameNamespace	URI，表示會以 Windows 網域帳戶方式來指定 SAML 判斷提示的主體。

用來指定 confirmations 參數的驗證通訊協定集合具有擴充性，但下表列出的是已定義在 SAML 規格中的通訊協定。

通訊協定	描述
HolderOfKey	URI，它會指定 SamlSecurityToken 安全性權杖的接收者應該要使用 KeyIdentifier 屬性來確認 SOAP 訊息是否由 SAML 判斷提示的主體所傳送。
SenderVouches	URI，它會指定 SAML 安全性權杖的收件者無法取得其他資訊來確認 SOAP 訊息是否由 SAML 判斷提示的主體所傳送。