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

一个 URI 引用，表示 name 参数所使用的格式。 设置 NameFormat 属性。

nameQualifier

String

name 参数所在的域。 设置 NameQualifier 属性。

name

String

主题名称。 设置 Name 属性。

例外

ArgumentNullException

name 为 null 或 Empty。

注解

用于指定名称的格式是可扩展的，下表列出了 SAML 规范所定义的格式。

格式	描述
EmailNamespace	一个 URI，表明 SAML 断言的主题指定为电子邮件地址。
UserNameNamespace	一个 URI，表明 SAML 断言的主题是使用 Windows 域帐户指定的。

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

一个 URI 引用，表示 name 参数所使用的格式。 设置 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，表明 SAML 断言的主题是使用 Windows 域帐户指定的。

要为 confirmations 参数指定的身份验证协议的集合是可扩展的；但是下表列出了 SAML 规范所定义的协议。

协议	描述
HolderOfKey	一个 URI，指定 SamlSecurityToken 安全令牌的接收方应使用 KeyIdentifier 属性来确认 SOAP 消息是否是由 SAML 断言的主题发送的。
SenderVouches	一个 URI，指定 SAML 安全令牌的接收方无法使用附加信息来确认 SOAP 消息是由 SAML 断言的主题发送的。