ClaimsIdentity 建構函式
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
初始化 ClaimsIdentity 類別的新執行個體。
多載
ClaimsIdentity()
使用空的宣告集合,初始化 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,使用指定的宣告、驗證類型、名稱宣告型別,以及角色宣告類型,初始化 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);
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
要用於角色宣告的宣告類型。
例外狀況
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 不是 null null 的屬性;則會使用 屬性的值 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 類別的新執行個體。
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);
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 類別的新執行個體。
public:
ClaimsIdentity(System::String ^ authenticationType, System::String ^ nameType, System::String ^ roleType);
public ClaimsIdentity (string authenticationType, string nameType, 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)
警告
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);
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.Security.SecurityCritical]
protected ClaimsIdentity (System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);
new System.Security.Claims.ClaimsIdentity : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> System.Security.Claims.ClaimsIdentity
[<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
[<System.Security.SecurityCritical>]
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
序列化的內容。
- 屬性
例外狀況
info
為 null
。
適用於
ClaimsIdentity(IEnumerable<Claim>, String)
使用指定的宣告和驗證類型,初始化 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);
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,初始化 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);
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 初始化 IIdentity 類別的新執行個體。
public:
ClaimsIdentity(System::Security::Principal::IIdentity ^ identity);
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 執行個體初始化 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。
例外狀況
other
為 null
。
備註
下表顯示從提供給建構函式之 ClaimsIdentityClaimsIdentity 類別實例的屬性值指派。
屬性 | 值 |
---|---|
Actor | 如果 屬性的值 other.Actor 不是 ,則會 other.Actor ClaimsIdentity 複製並指派 ,否則為 null null 。 |
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)
警告
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);
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.Security.SecurityCritical]
protected ClaimsIdentity (System.Runtime.Serialization.SerializationInfo info);
new System.Security.Claims.ClaimsIdentity : System.Runtime.Serialization.SerializationInfo -> System.Security.Claims.ClaimsIdentity
[<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
[<System.Security.SecurityCritical>]
new System.Security.Claims.ClaimsIdentity : System.Runtime.Serialization.SerializationInfo -> System.Security.Claims.ClaimsIdentity
Protected Sub New (info As SerializationInfo)
參數
- info
- SerializationInfo
序列化的資料。
- 屬性
例外狀況
info
為 null
。
適用於
ClaimsIdentity(BinaryReader)
使用指定的 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。
例外狀況
reader
為 null
。
備註
一般而言,讀取器是從 傳 WriteTo 回的位元組建構。
適用於
ClaimsIdentity(IEnumerable<Claim>)
使用 ClaimsIdentity 物件的列舉集合,初始化 Claim 類別的新執行個體。
public:
ClaimsIdentity(System::Collections::Generic::IEnumerable<System::Security::Claims::Claim ^> ^ claims);
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 類別的新執行個體。
public:
ClaimsIdentity(System::String ^ authenticationType);
public ClaimsIdentity (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. |
適用於
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應