SamlAttribute 建構函式

定義

命名空間:

System.IdentityModel.Tokens

組件:

System.IdentityModel.dll

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

多載

SamlAttribute()	初始化 SamlAttribute 類別的新執行個體。
SamlAttribute(Claim)	使用指定的宣告，初始化 SamlAttribute 類別的新執行個體。
SamlAttribute(String, String, IEnumerable<String>)	使用指定的屬性名稱、XML 命名空間 (Namespace) 以及屬性值，初始化 SamlAttribute 類別的新執行個體。

SamlAttribute()

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

public:
 SamlAttribute();

public SamlAttribute ();

Public Sub New ()

SamlAttribute(Claim)

使用指定的宣告，初始化 SamlAttribute 類別的新執行個體。

public:
 SamlAttribute(System::IdentityModel::Claims::Claim ^ claim);

public SamlAttribute (System.IdentityModel.Claims.Claim claim);

new System.IdentityModel.Tokens.SamlAttribute : System.IdentityModel.Claims.Claim -> System.IdentityModel.Tokens.SamlAttribute

Public Sub New (claim As Claim)

參數

claim

Claim

Claim，表示 SamlSecurityToken 安全性權杖主體的屬性。

例外狀況

ArgumentNullException

claim 為 null。

ArgumentException

claim 之 Resource 屬性的型別不是 String。

-或-

claim 的 Right 屬性不是 PossessProperty。

-或-

claim 的 ClaimType 屬性沒有 '/' 字元，或是此字元位於第一個或最後一個索引位置。

備註

使用這個建構函式 (Constructor)，即可將宣告轉換為 SAML 屬性。 為了要轉換為 SAML 屬性 (Attribute)，Right 屬性 (Property) 必須是 PossessProperty、Resource 屬性 (Property) 的型別必須是 String，而且 ClaimType 屬性 (Property) 必須使用 namespace/name 格式。

下表指定 claim 參數會將 Name、Namespace 以及 AttributeValues 等屬性設定成哪些值。

屬性	用來設定屬性的 claim 參數屬性。
AttributeValues	Resource 屬性的值會加入集合中。
Name	ClaimType 屬性中最後一個 '/' 字元之後的字串部分。
Namespace	ClaimType 屬性中最後一個 '/' 字元之前的字串部分。

SamlAttribute(String, String, IEnumerable<String>)

使用指定的屬性名稱、XML 命名空間 (Namespace) 以及屬性值，初始化 SamlAttribute 類別的新執行個體。

public:
 SamlAttribute(System::String ^ attributeNamespace, System::String ^ attributeName, System::Collections::Generic::IEnumerable<System::String ^> ^ attributeValues);

public SamlAttribute (string attributeNamespace, string attributeName, System.Collections.Generic.IEnumerable<string> attributeValues);

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

Public Sub New (attributeNamespace As String, attributeName As String, attributeValues As IEnumerable(Of String))

參數

attributeNamespace

String

XML 命名空間，其中定義了 attributeName 參數。

attributeName

String

SAML 屬性的名稱。

attributeValues

IEnumerable<String>

IEnumerable<T>，其中包含 SAML 屬性的值。

例外狀況

ArgumentNullException

attributeNamespace 為 null。

-或-

attributeName 為 null。

-或-

attributeValues 為 null。

ArgumentException

claim 之 Resource 屬性的型別不是 String。

-或-

claim 的 Right 屬性不是 PossessProperty。

-或-

claim 的 ClaimType 屬性沒有 '/' 字元，或是此字元位於第一個或最後一個索引位置。

備註

下表指定由這個建構函式之參數設定的屬性。

屬性	參數
AttributeValues	attributeValues
Name	attributeName
Namespace	attributeNamespace