ClaimsIdentity 建構函式

定義

命名空間:

System.Security.Claims

組件:

System.Security.Claims.dll

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

多載

ClaimsIdentity()	使用空的宣告集合，初始化 ClaimsIdentity 類別的新執行個體。
ClaimsIdentity(IIdentity, IEnumerable<Claim>, String, String, String)	從指定的 ClaimsIdentity，使用指定的宣告、驗證類型、名稱宣告型別，以及角色宣告類型，初始化 IIdentity 類別的新執行個體。
ClaimsIdentity(IEnumerable<Claim>, String, String, String)	使用指定的宣告、驗證類型、名稱宣告類型，以及角色宣告類型，初始化 ClaimsIdentity 類別的新執行個體。
ClaimsIdentity(String, String, String)	使用指定的驗證類型、宣告類型和角色宣告類型，初始化 ClaimsIdentity 類別的新執行個體。
ClaimsIdentity(SerializationInfo, StreamingContext)	已淘汰. 從使用 ISerializable 建立的序列化資料流，初始化 ClaimsIdentity 類別的新執行個體。
ClaimsIdentity(IEnumerable<Claim>, String)	使用指定的宣告和驗證類型，初始化 ClaimsIdentity 類別的新執行個體。
ClaimsIdentity(IIdentity, IEnumerable<Claim>)	使用指定的宣告和指定的 ClaimsIdentity，初始化 IIdentity 類別的新執行個體。
ClaimsIdentity(IIdentity)	使用名稱和驗證類型，從指定的 ClaimsIdentity 初始化 IIdentity 類別的新執行個體。
ClaimsIdentity(ClaimsIdentity)	從現有的 ClaimsIdentity 執行個體初始化 ClaimsIdentity 類別的新執行個體。
ClaimsIdentity(SerializationInfo)	已淘汰. 從使用 ISerializable 建立的序列化資料流，初始化 ClaimsIdentity 類別的新執行個體。
ClaimsIdentity(BinaryReader)	使用指定的 BinaryReader，初始化 ClaimsIdentity 的執行個體。
ClaimsIdentity(IEnumerable<Claim>)	使用 ClaimsIdentity 物件的列舉集合，初始化 Claim 類別的新執行個體。
ClaimsIdentity(String)	使用空白宣告集合和指定的驗證類型，初始化 ClaimsIdentity 類別的新執行個體。

ClaimsIdentity()

來源:

ClaimsIdentity.cs

使用空的宣告集合，初始化 ClaimsIdentity 類別的新執行個體。

public:
 ClaimsIdentity();

public ClaimsIdentity ();

Public Sub New ()

備註

下表所顯示的是 ClaimsIdentity 類別之執行個體的初始屬性值。

屬性	值
Actor	null.
AuthenticationType	null.
BootstrapContext	null.
Claims	空的集合。
IsAuthenticated	注意： 存取時， IsAuthenticated 會根據 屬性的值傳回 屬性的值 AuthenticationType 。
Label	null.
Name	注意：存取時，會根據 NameClaimType 和 Claims 集合傳回 屬性的值 Name 。
NameClaimType	DefaultNameClaimType.
RoleClaimType	DefaultRoleClaimType.

ClaimsIdentity(IIdentity, IEnumerable<Claim>, String, String, String)

來源:

ClaimsIdentity.cs

從指定的 ClaimsIdentity，使用指定的宣告、驗證類型、名稱宣告型別，以及角色宣告類型，初始化 IIdentity 類別的新執行個體。

public:
 ClaimsIdentity(System::Security::Principal::IIdentity ^ identity, System::Collections::Generic::IEnumerable<System::Security::Claims::Claim ^> ^ claims, System::String ^ authenticationType, System::String ^ nameType, System::String ^ roleType);

public ClaimsIdentity (System.Security.Principal.IIdentity? identity, System.Collections.Generic.IEnumerable<System.Security.Claims.Claim>? claims, string? authenticationType, string? nameType, string? roleType);

new System.Security.Claims.ClaimsIdentity : System.Security.Principal.IIdentity * seq<System.Security.Claims.Claim> * string * string * string -> System.Security.Claims.ClaimsIdentity

Public Sub New (identity As IIdentity, claims As IEnumerable(Of Claim), authenticationType As String, nameType As String, roleType As String)

參數

identity

IIdentity

新宣告識別的基底識別。

claims

IEnumerable<Claim>

用來填入新宣告識別的宣告。

authenticationType

String

使用的驗證 (Authentication) 類型。

nameType

String

要用於名稱宣告的宣告類型。

roleType

String

要用於角色宣告的宣告類型。

例外狀況

InvalidOperationException

identity 是傳回給 this 之循環參考中的 ClaimsIdentity 和 Actor 結果。

備註

下表所顯示的是 ClaimsIdentity 類別之執行個體的初始屬性值。

屬性	值
Actor	如果 identity 可從 指派 ClaimsIdentity ，則為 屬性的值 identity.Actor ，否則為 null 。
AuthenticationType	authenticationType 參數。 authenticationType如果 參數為 null 或空字串，則會使用 () IIdentity.AuthenticationType 屬性的值 identity.AuthenticationType 。
BootstrapContext	如果 identity 可從 指派 ClaimsIdentity ，則為 屬性的值 identity.BootStrapContext ，否則為 null 。
Claims	從 claims 參數初始化。 如果 identity 可從 指派 ClaimsIdentity ，則會在 參數指定的 claims 實例之前，將 來自 的宣告 identity 新增至新的實例。
IsAuthenticated	注意： 存取時， IsAuthenticated 會根據 屬性的值傳回 屬性的值 AuthenticationType 。
Label	如果 identity 可從 指派 ClaimsIdentity ，則為 屬性的值 identity.Label ，否則為 null 。
Name	如果 identity 無法從 ClaimsIdentity 指派，則不是 ，而且具有 IIdentity.Name 不是 nullnull 的屬性;則會使用 屬性的值 IIdentity.Name ，將名稱宣告新增至新的實例。 注意：存取時，會根據 NameClaimType 和 Claims 集合傳回 屬性的值 Name 。
NameClaimType	nameType 參數的值。 不過，如果 參數的值 nameType 是 null 或空字串，而且 identity 可從 ClaimsIdentity 指派，則會使用 屬性的值 identity.NameClaimType ， DefaultNameClaimType 否則會使用 。
RoleClaimType	roleClaimType 參數的值。 不過，如果 參數的值 roleClaimType 是 null 或空字串，且識別可從 ClaimsIdentity 指派，則會使用 屬性的值 identity.RoleClaimType ， DefaultRoleClaimType 否則會使用 。

ClaimsIdentity(IEnumerable<Claim>, String, String, String)

來源:

ClaimsIdentity.cs

使用指定的宣告、驗證類型、名稱宣告類型，以及角色宣告類型，初始化 ClaimsIdentity 類別的新執行個體。

public:
 ClaimsIdentity(System::Collections::Generic::IEnumerable<System::Security::Claims::Claim ^> ^ claims, System::String ^ authenticationType, System::String ^ nameType, System::String ^ roleType);

public ClaimsIdentity (System.Collections.Generic.IEnumerable<System.Security.Claims.Claim>? claims, string? authenticationType, string? nameType, string? roleType);

new System.Security.Claims.ClaimsIdentity : seq<System.Security.Claims.Claim> * string * string * string -> System.Security.Claims.ClaimsIdentity

Public Sub New (claims As IEnumerable(Of Claim), authenticationType As String, nameType As String, roleType As String)

參數

claims

IEnumerable<Claim>

用來填入宣告識別的宣告。

authenticationType

String

使用的驗證 (Authentication) 類型。

nameType

String

要用於名稱宣告的宣告類型。

roleType

String

要用於角色宣告的宣告類型。

備註

下表所顯示的是 ClaimsIdentity 類別之執行個體的初始屬性值。

屬性	值
Actor	null.
AuthenticationType	authenticationType 參數的值。 authenticationType如果 參數為 null 或空字串，屬性會設定為 null 。
BootstrapContext	null.
Claims	從 claims 參數初始化。
IsAuthenticated	注意： 存取時， IsAuthenticated 會根據 屬性的值傳回 屬性的值 AuthenticationType 。
Label	null.
Name	注意：存取時，會根據 NameClaimType 和 Claims 集合傳回 屬性的值 Name 。
NameClaimType	nameType 參數的值。 不過，如果 nameType 參數為 null 或空字串，則 屬性會設定為 DefaultNameClaimType 。
RoleClaimType	roleClaimType 參數的值。 不過，如果 roleClaimType 參數為 null 或空字串，則 屬性會設定為 DefaultRoleClaimType 。

ClaimsIdentity(String, String, String)

來源:

ClaimsIdentity.cs

使用指定的驗證類型、宣告類型和角色宣告類型，初始化 ClaimsIdentity 類別的新執行個體。

public:
 ClaimsIdentity(System::String ^ authenticationType, System::String ^ nameType, System::String ^ roleType);

public ClaimsIdentity (string? authenticationType, string? nameType, string? roleType);

new System.Security.Claims.ClaimsIdentity : string * string * string -> System.Security.Claims.ClaimsIdentity

Public Sub New (authenticationType As String, nameType As String, roleType As String)

參數

authenticationType

String

使用的驗證 (Authentication) 類型。

nameType

String

要用於名稱宣告的宣告類型。

roleType

String

要用於角色宣告的宣告類型。

備註

下表所顯示的是 ClaimsIdentity 類別之執行個體的初始屬性值。

屬性	值
Actor	null.
AuthenticationType	authenticationType 參數的值。 authenticationType如果 參數為 null 或空字串，屬性會設定為 null 。
BootstrapContext	null.
Claims	空的集合。
IsAuthenticated	注意： 存取時， IsAuthenticated 會根據 屬性的值傳回 屬性的值 AuthenticationType 。
Label	null.
Name	注意：存取時，會根據 NameClaimType 和 Claims 集合傳回 屬性的值 Name 。
NameClaimType	nameType 參數的值。 nameType如果 參數為 null 或空字串，則 屬性會設定為 DefaultNameClaimType 。
RoleClaimType	roleType 參數的值。 roleType如果 參數為 null 或空字串，則 屬性會設定為 DefaultRoleClaimType 。

ClaimsIdentity(SerializationInfo, StreamingContext)

來源:

ClaimsIdentity.cs

警告

This API supports obsolete formatter-based serialization. It should not be called or extended by application code.

從使用 ISerializable 建立的序列化資料流，初始化 ClaimsIdentity 類別的新執行個體。

protected:
 ClaimsIdentity(System::Runtime::Serialization::SerializationInfo ^ info, System::Runtime::Serialization::StreamingContext context);

[System.Obsolete("This API supports obsolete formatter-based serialization. It should not be called or extended by application code.", DiagnosticId="SYSLIB0051", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
protected ClaimsIdentity (System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);

[<System.Obsolete("This API supports obsolete formatter-based serialization. It should not be called or extended by application code.", DiagnosticId="SYSLIB0051", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
new System.Security.Claims.ClaimsIdentity : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> System.Security.Claims.ClaimsIdentity

Protected Sub New (info As SerializationInfo, context As StreamingContext)

參數

info

SerializationInfo

序列化的資料。

context

StreamingContext

序列化的內容。

屬性

ObsoleteAttribute

例外狀況

ArgumentNullException

info 為 null。

ClaimsIdentity(IEnumerable<Claim>, String)

來源:

ClaimsIdentity.cs

使用指定的宣告和驗證類型，初始化 ClaimsIdentity 類別的新執行個體。

public:
 ClaimsIdentity(System::Collections::Generic::IEnumerable<System::Security::Claims::Claim ^> ^ claims, System::String ^ authenticationType);

public ClaimsIdentity (System.Collections.Generic.IEnumerable<System.Security.Claims.Claim>? claims, string? authenticationType);

new System.Security.Claims.ClaimsIdentity : seq<System.Security.Claims.Claim> * string -> System.Security.Claims.ClaimsIdentity

Public Sub New (claims As IEnumerable(Of Claim), authenticationType As String)

參數

claims

IEnumerable<Claim>

用來填入宣告識別的宣告。

authenticationType

String

使用的驗證 (Authentication) 類型。

備註

下表所顯示的是 ClaimsIdentity 類別之執行個體的初始屬性值。

屬性	值
Actor	null.
AuthenticationType	authenticationType 參數的值。 authenticationType如果 參數為 null 或空字串，則 屬性會設定為 null 。
BootstrapContext	null.
Claims	從 claims 參數初始化。
IsAuthenticated	注意： 存取時， IsAuthenticated 會根據 屬性的值傳回 屬性的值 AuthenticationType 。
Label	null.
Name	注意：存取時，會根據 NameClaimType 和 Claims 集合傳回 屬性的值 Name 。
NameClaimType	DefaultNameClaimType.
RoleClaimType	DefaultRoleClaimType.

ClaimsIdentity(IIdentity, IEnumerable<Claim>)

來源:

ClaimsIdentity.cs

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

public:
 ClaimsIdentity(System::Security::Principal::IIdentity ^ identity, System::Collections::Generic::IEnumerable<System::Security::Claims::Claim ^> ^ claims);

public ClaimsIdentity (System.Security.Principal.IIdentity? identity, System.Collections.Generic.IEnumerable<System.Security.Claims.Claim>? claims);

new System.Security.Claims.ClaimsIdentity : System.Security.Principal.IIdentity * seq<System.Security.Claims.Claim> -> System.Security.Claims.ClaimsIdentity

Public Sub New (identity As IIdentity, claims As IEnumerable(Of Claim))

參數

identity

IIdentity

新宣告識別的基底識別。

claims

IEnumerable<Claim>

用來填入宣告識別的宣告。

備註

下表所顯示的是 ClaimsIdentity 類別之執行個體的初始屬性值。

屬性	值
Actor	如果 identity 可從 ClaimsIdentity 指派，則為 屬性的值 identity.Actor ，否則 null 為 。
AuthenticationType	authenticationType 參數。 authenticationType如果 參數為 null 或空字串，則會使用 (IIdentity.AuthenticationType) 屬性的值 identity.AuthenticationType 。
BootstrapContext	如果 identity 可從 ClaimsIdentity 指派，則為 屬性的值 identity.BootStrapContext ，否則 null 為 。
Claims	從 claims 參數初始化。 如果 identity 是可指派自 ClaimsIdentity 的 ，則 從 的宣告 identity 會在 參數指定的 claims 實例之前加入至新的實例。
IsAuthenticated	注意： 存取時， IsAuthenticated 會根據 屬性的值傳回 屬性的值 AuthenticationType 。
Label	如果 identity 可從 ClaimsIdentity 指派，則為 屬性的值 identity.Label ，否則 null 為 。
Name	如果 identity 無法從 ClaimsIdentity 指派，則不是 null ，而且具有 IIdentity.Name 不是 null 的屬性;則會使用 屬性的值 IIdentity.Name ，將名稱宣告新增至新的實例。 注意：存取時，會根據 NameClaimType 和 Claims 集合傳回 屬性的值 Name 。
NameClaimType	如果 identity 可從 ClaimsIdentity 指派，則會使用 屬性的值 identity.NameClaimType ， DefaultNameClaimType 否則會使用 。
RoleClaimType	如果 identity 可從 ClaimsIdentity 指派，則會使用 屬性的值 identity.RoleClaimType ， DefaultRoleClaimType 否則會使用 。

ClaimsIdentity(IIdentity)

來源:

ClaimsIdentity.cs

使用名稱和驗證類型，從指定的 ClaimsIdentity 初始化 IIdentity 類別的新執行個體。

public:
 ClaimsIdentity(System::Security::Principal::IIdentity ^ identity);

public ClaimsIdentity (System.Security.Principal.IIdentity? identity);

new System.Security.Claims.ClaimsIdentity : System.Security.Principal.IIdentity -> System.Security.Claims.ClaimsIdentity

Public Sub New (identity As IIdentity)

參數

identity

IIdentity

新宣告識別的基底識別。

備註

下表所顯示的是 ClaimsIdentity 類別之執行個體的初始屬性值。

屬性	值
Actor	如果 identity 可從 ClaimsIdentity 指派，則為 屬性的值 identity.Actor ，否則 null 為 。
AuthenticationType	會使用 (IIdentity.AuthenticationType) 屬性的值 identity.AuthenticationType 。
BootstrapContext	如果 identity 可從 ClaimsIdentity 指派，則為 屬性的值 identity.BootStrapContext ，否則 null 為 。
Claims	如果 identity 可從 ClaimsIdentity 指派，則宣告會 identity 加入至新的實例，否則為空集合。
IsAuthenticated	注意： 存取時， IsAuthenticated 會根據 屬性的值傳回 屬性的值 AuthenticationType 。
Label	如果 identity 可從 ClaimsIdentity 指派，則為 屬性的值 identity.Label ，否則 null 為 。
Name	如果 identity 無法從 ClaimsIdentity 指派，則不是 null ，而且具有 IIdentity.Name 不是 null 的屬性;則會使用 屬性的值 IIdentity.Name ，將名稱宣告新增至新的實例。 注意：存取時，會根據 NameClaimType 和 Claims 集合傳回 屬性的值 Name 。
NameClaimType	如果 identity 可從 ClaimsIdentity 指派，則會使用 屬性的值 identity.NameClaimType ， DefaultNameClaimType 否則會使用 。
RoleClaimType	如果 identity 可從 ClaimsIdentity 指派，則會使用 屬性的值 identity.RoleClaimType ， DefaultRoleClaimType 否則會使用 。

ClaimsIdentity(ClaimsIdentity)

來源:

ClaimsIdentity.cs

從現有的 ClaimsIdentity 執行個體初始化 ClaimsIdentity 類別的新執行個體。

protected:
 ClaimsIdentity(System::Security::Claims::ClaimsIdentity ^ other);

protected ClaimsIdentity (System.Security.Claims.ClaimsIdentity other);

new System.Security.Claims.ClaimsIdentity : System.Security.Claims.ClaimsIdentity -> System.Security.Claims.ClaimsIdentity

Protected Sub New (other As ClaimsIdentity)

參數

other

ClaimsIdentity

要複製的 ClaimsIdentity。

例外狀況

ArgumentNullException

other 為 null。

備註

下表顯示從提供給建構函式之 ClaimsIdentityClaimsIdentity 類別實例的屬性值指派。

屬性	值
Actor	如果 屬性的值 other.Actor 不是 ，則會 other.ActorClaimsIdentity 複製並指派 ，否則為 nullnull 。
AuthenticationType	other.AuthenticationType 屬性的值。
BootstrapContext	other.BootstrapContext 屬性的值。
Claims	List<Claim>宣告的 ，如果有的話，則為 屬性中的 other.Claims 。
Label	other.Label 屬性的值。
NameClaimType	other.NameClaimType 屬性的值。
RoleClaimType	other.RoleClaimType 屬性的值。
CustomSerializationData	如果 other.CustomSerializationData 不是 null ， other.CustomSerializationData 則會複製並指派 ，否則為 null 。

ClaimsIdentity(SerializationInfo)

來源:

ClaimsIdentity.cs

警告

This API supports obsolete formatter-based serialization. It should not be called or extended by application code.

從使用 ISerializable 建立的序列化資料流，初始化 ClaimsIdentity 類別的新執行個體。

protected:
 ClaimsIdentity(System::Runtime::Serialization::SerializationInfo ^ info);

[System.Obsolete("This API supports obsolete formatter-based serialization. It should not be called or extended by application code.", DiagnosticId="SYSLIB0051", UrlFormat="https://aka.ms/dotnet-warnings/{0}")]
protected ClaimsIdentity (System.Runtime.Serialization.SerializationInfo info);

[<System.Obsolete("This API supports obsolete formatter-based serialization. It should not be called or extended by application code.", DiagnosticId="SYSLIB0051", UrlFormat="https://aka.ms/dotnet-warnings/{0}")>]
new System.Security.Claims.ClaimsIdentity : System.Runtime.Serialization.SerializationInfo -> System.Security.Claims.ClaimsIdentity

Protected Sub New (info As SerializationInfo)

參數

info

SerializationInfo

序列化的資料。

屬性

ObsoleteAttribute

例外狀況

ArgumentNullException

info 為 null。

ClaimsIdentity(BinaryReader)

來源:

ClaimsIdentity.cs

使用指定的 BinaryReader，初始化 ClaimsIdentity 的執行個體。

public:
 ClaimsIdentity(System::IO::BinaryReader ^ reader);

public ClaimsIdentity (System.IO.BinaryReader reader);

new System.Security.Claims.ClaimsIdentity : System.IO.BinaryReader -> System.Security.Claims.ClaimsIdentity

Public Sub New (reader As BinaryReader)

參數

reader

BinaryReader

指向 ClaimsIdentity 的 BinaryReader。

例外狀況

ArgumentNullException

reader 為 null。

備註

一般而言，讀取器是從 傳 WriteTo 回的位元組建構。

ClaimsIdentity(IEnumerable<Claim>)

來源:

ClaimsIdentity.cs

使用 ClaimsIdentity 物件的列舉集合，初始化 Claim 類別的新執行個體。

public:
 ClaimsIdentity(System::Collections::Generic::IEnumerable<System::Security::Claims::Claim ^> ^ claims);

public ClaimsIdentity (System.Collections.Generic.IEnumerable<System.Security.Claims.Claim>? claims);

new System.Security.Claims.ClaimsIdentity : seq<System.Security.Claims.Claim> -> System.Security.Claims.ClaimsIdentity

Public Sub New (claims As IEnumerable(Of Claim))

參數

claims

IEnumerable<Claim>

用來填入宣告識別的宣告。

備註

下表所顯示的是 ClaimsIdentity 類別之執行個體的初始屬性值。

屬性	值
Actor	null.
AuthenticationType	null.
BootstrapContext	null.
Claims	從 claims 參數初始化。
IsAuthenticated	注意： 存取時， IsAuthenticated 會根據 屬性的值傳回 屬性的值 AuthenticationType 。
Label	null.
Name	注意：存取時，會根據 NameClaimType 和 Claims 集合傳回 屬性的值 Name 。
NameClaimType	DefaultNameClaimType.
RoleClaimType	DefaultRoleClaimType.

ClaimsIdentity(String)

來源:

ClaimsIdentity.cs

使用空白宣告集合和指定的驗證類型，初始化 ClaimsIdentity 類別的新執行個體。

public:
 ClaimsIdentity(System::String ^ authenticationType);

public ClaimsIdentity (string? authenticationType);

new System.Security.Claims.ClaimsIdentity : string -> System.Security.Claims.ClaimsIdentity

Public Sub New (authenticationType As String)

參數

authenticationType

String

使用的驗證 (Authentication) 類型。

備註

下表所顯示的是 ClaimsIdentity 類別之執行個體的初始屬性值。

屬性	值
Actor	null.
AuthenticationType	authenticationType 參數的值。 authenticationType如果 參數為 null 或空字串，則 屬性會設定為 null 。
BootstrapContext	null.
Claims	空的集合。
IsAuthenticated	注意： 存取時， IsAuthenticated 會根據 屬性的值傳回 屬性的值 AuthenticationType 。
Label	null.
Name	注意：存取時，會根據 NameClaimType 和 Claims 集合傳回 屬性的值 Name 。
NameClaimType	DefaultNameClaimType.
RoleClaimType	DefaultRoleClaimType.