SessionSecurityToken 建構函式

定義

命名空間:: System.IdentityModel.Tokens

組件:: System.IdentityModel.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

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

多載

名稱	Description
SessionSecurityToken(ClaimsPrincipal)	初始化指定主體中該類別的新實例 SessionSecurityToken 。
SessionSecurityToken(SerializationInfo, StreamingContext)	初始化一個新的類別實例 SessionSecurityToken ，並使用序列化資料。
SessionSecurityToken(ClaimsPrincipal, String)	從指定的主體與啟動標記初始化該類別的新實例 SessionSecurityToken 。
SessionSecurityToken(ClaimsPrincipal, TimeSpan)	初始化指定主體中該類別的新實例 SessionSecurityToken 。新代幣的有效期會持續 UtcNow 到指定的壽命。
SessionSecurityToken(ClaimsPrincipal, String, Nullable<DateTime>, Nullable<DateTime>)	從指定的主體與啟動標記初始化該類別的新實例 SessionSecurityToken ;並以指定的開始時間與到期時間初始化。
SessionSecurityToken(ClaimsPrincipal, String, String, Nullable<DateTime>, Nullable<DateTime>)	從指定的主體與啟動標記初始化該類別的新實例 SessionSecurityToken ;並以指定的開始時間與到期時間初始化。新的令牌會被限定到指定的端點。
SessionSecurityToken(ClaimsPrincipal, UniqueId, String, String, TimeSpan, SymmetricSecurityKey)	透過使用指定的主體、上下文 ID、上下文、端點、壽命與鍵來初始化該 SessionSecurityToken 類別的新實例。
SessionSecurityToken(ClaimsPrincipal, UniqueId, String, String, DateTime, TimeSpan, SymmetricSecurityKey)	透過使用指定的主體、上下文 ID、上下文、端點、有效時間戳、壽命及鍵來初始化該 SessionSecurityToken 類別的新實例。
SessionSecurityToken(ClaimsPrincipal, UniqueId, String, String, Nullable<DateTime>, Nullable<DateTime>, SymmetricSecurityKey)	透過指定的主體、上下文 ID、上下文、端點、開始時間、到期時間及鍵來初始化類別的新 SessionSecurityToken 實例。

SessionSecurityToken(ClaimsPrincipal)

初始化指定主體中該類別的新實例 SessionSecurityToken 。

public:
 SessionSecurityToken(System::Security::Claims::ClaimsPrincipal ^ claimsPrincipal);

public SessionSecurityToken(System.Security.Claims.ClaimsPrincipal claimsPrincipal);

new System.IdentityModel.Tokens.SessionSecurityToken : System.Security.Claims.ClaimsPrincipal -> System.IdentityModel.Tokens.SessionSecurityToken

Public Sub New (claimsPrincipal As ClaimsPrincipal)

參數

claimsPrincipal: ClaimsPrincipal

該主張的主體，作為初始化代幣的來源。

例外狀況

ArgumentNullException

claimsPrincipal 是 null。

-或-

Identities 的 claimsPrincipal 屬性是 null。

備註

下表顯示該 SessionSecurityToken 類別實例的初始屬性值。

房產	初始值
ClaimsPrincipal	`claimsPrincipal`
Context	`null`
ContextId	設定為產生的唯一 ID。
EndpointId	String.Empty
Id	設定為產生的唯一 ID。
IsPersistent	`false`
IsReferenceMode	`false`
KeyEffectiveTime	UtcNow
KeyExpirationTime	UtcNow加上房產。SessionSecurityTokenHandler.DefaultTokenLifetime
KeyGeneration	`null`
SecurityKeys	包含一個產生的 128 位元對稱金鑰。註：預設實作並未使用此特性。簽約金鑰與加密金鑰由處理該憑證的所施加 SessionSecurityTokenHandler 的 Cookie 轉換所決定。
ValidFrom	UtcNow
ValidTo	UtcNow加上房產。SessionSecurityTokenHandler.DefaultTokenLifetime

適用於

SessionSecurityToken(SerializationInfo, StreamingContext)

初始化一個新的類別實例 SessionSecurityToken ，並使用序列化資料。

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

protected SessionSecurityToken(System.Runtime.Serialization.SerializationInfo info, System.Runtime.Serialization.StreamingContext context);

new System.IdentityModel.Tokens.SessionSecurityToken : System.Runtime.Serialization.SerializationInfo * System.Runtime.Serialization.StreamingContext -> System.IdentityModel.Tokens.SessionSecurityToken

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

參數

info: SerializationInfo

序列化的物件資料。

context: StreamingContext

關於來源的背景資訊。

適用於

SessionSecurityToken(ClaimsPrincipal, String)

從指定的主體與啟動標記初始化該類別的新實例 SessionSecurityToken 。

public:
 SessionSecurityToken(System::Security::Claims::ClaimsPrincipal ^ claimsPrincipal, System::String ^ context);

public SessionSecurityToken(System.Security.Claims.ClaimsPrincipal claimsPrincipal, string context);

new System.IdentityModel.Tokens.SessionSecurityToken : System.Security.Claims.ClaimsPrincipal * string -> System.IdentityModel.Tokens.SessionSecurityToken

Public Sub New (claimsPrincipal As ClaimsPrincipal, context As String)

參數

claimsPrincipal: ClaimsPrincipal

由自舉令牌產生的理賠主體。

context: String

一個可選的、針對特定應用程式的上下文字串。

例外狀況

ArgumentNullException

claimsPrincipal 是 null。

-或-

Identities 的 claimsPrincipal 屬性是 null。

備註

下表顯示該 SessionSecurityToken 類別實例的初始屬性值。

房產	初始值
ClaimsPrincipal	`claimsPrincipal`
Context	`context`
ContextId	設定為產生的唯一 ID。
EndpointId	String.Empty
Id	設定為產生的唯一 ID。
IsPersistent	`false`
IsReferenceMode	`false`
KeyEffectiveTime	UtcNow
KeyExpirationTime	UtcNow加上房產。SessionSecurityTokenHandler.DefaultTokenLifetime
KeyGeneration	`null`
SecurityKeys	包含一個產生的 128 位元對稱金鑰。註：預設實作並未使用此特性。簽約金鑰與加密金鑰由處理該憑證的所施加 SessionSecurityTokenHandler 的 Cookie 轉換所決定。
ValidFrom	UtcNow
ValidTo	UtcNow加上房產。SessionSecurityTokenHandler.DefaultTokenLifetime

適用於

SessionSecurityToken(ClaimsPrincipal, TimeSpan)

初始化指定主體中該類別的新實例 SessionSecurityToken 。新代幣的有效期會持續 UtcNow 到指定的壽命。

public:
 SessionSecurityToken(System::Security::Claims::ClaimsPrincipal ^ claimsPrincipal, TimeSpan lifetime);

public SessionSecurityToken(System.Security.Claims.ClaimsPrincipal claimsPrincipal, TimeSpan lifetime);

new System.IdentityModel.Tokens.SessionSecurityToken : System.Security.Claims.ClaimsPrincipal * TimeSpan -> System.IdentityModel.Tokens.SessionSecurityToken

Public Sub New (claimsPrincipal As ClaimsPrincipal, lifetime As TimeSpan)

參數

claimsPrincipal: ClaimsPrincipal

該主張的主體，作為初始化代幣的來源。

lifetime: TimeSpan

從當前時間起，該代幣有效期間。 ValidFrom屬性將設為，UtcNow屬性ValidTo將被設定為加上ValidFrom此參數指定的週期。

例外狀況

ArgumentNullException

claimsPrincipal 是 null。

-或-

Identities 的 claimsPrincipal 屬性是 null。

InvalidOperationException

lifetime 小於或等於 Zero。

備註

下表顯示該 SessionSecurityToken 類別實例的初始屬性值。

房產	初始值
ClaimsPrincipal	`claimsPrincipal`
Context	`null`
ContextId	設定為產生的唯一 ID。
EndpointId	String.Empty
Id	設定為產生的唯一 ID。
IsPersistent	`false`
IsReferenceMode	`false`
KeyEffectiveTime	UtcNow
KeyExpirationTime	UtcNow 加 `lifetime`。
KeyGeneration	`null`
SecurityKeys	包含一個產生的 128 位元對稱金鑰。註：預設實作並未使用此特性。簽約金鑰與加密金鑰由處理該憑證的所施加 SessionSecurityTokenHandler 的 Cookie 轉換所決定。
ValidFrom	UtcNow
ValidTo	UtcNow 加 `lifetime`。

適用於

SessionSecurityToken(ClaimsPrincipal, String, Nullable<DateTime>, Nullable<DateTime>)

從指定的主體與啟動標記初始化該類別的新實例 SessionSecurityToken ;並以指定的開始時間與到期時間初始化。

public:
 SessionSecurityToken(System::Security::Claims::ClaimsPrincipal ^ claimsPrincipal, System::String ^ context, Nullable<DateTime> validFrom, Nullable<DateTime> validTo);

public SessionSecurityToken(System.Security.Claims.ClaimsPrincipal claimsPrincipal, string context, DateTime? validFrom, DateTime? validTo);

new System.IdentityModel.Tokens.SessionSecurityToken : System.Security.Claims.ClaimsPrincipal * string * Nullable<DateTime> * Nullable<DateTime> -> System.IdentityModel.Tokens.SessionSecurityToken

Public Sub New (claimsPrincipal As ClaimsPrincipal, context As String, validFrom As Nullable(Of DateTime), validTo As Nullable(Of DateTime))

參數

claimsPrincipal: ClaimsPrincipal

由自舉令牌產生的理賠主體。

context: String

一個可選的、針對特定應用程式的上下文字串。

validFrom: Nullable<DateTime>

標記生效的時間點。 null 以指定 UtcNow。

validTo: Nullable<DateTime>

即該代幣不再有效的時間瞬間。 null 指定應將屬性值 DefaultTokenLifetime 加到參數指定 validFrom 時間內來決定。

例外狀況

ArgumentNullException

claimsPrincipal 是 null。

-或-

Identities 的 claimsPrincipal 屬性是 null。

ArgumentOutOfRangeException

validFrom和validTo參數無法驗證;例如，指定validTo一個發生在 validFrom之前的時間點。

備註

下表顯示該 SessionSecurityToken 類別實例的初始屬性值。

房產	初始值
ClaimsPrincipal	`claimsPrincipal`
Context	`context`
ContextId	設定為產生的唯一 ID。
EndpointId	String.Empty
Id	設定為產生的唯一 ID。
IsPersistent	`false`
IsReferenceMode	`false`
KeyEffectiveTime	設定為由ValidFrom參數決定的屬性值`ValidFrom`。
KeyExpirationTime	該屬性的價值 ValidTo 由 `ValidTo` 參數決定。
KeyGeneration	`null`
SecurityKeys	包含一個產生的 128 位元對稱金鑰。註：預設實作並未使用此特性。簽約金鑰與加密金鑰由處理該憑證的所施加 SessionSecurityTokenHandler 的 Cookie 轉換所決定。
ValidFrom	參數值，或若`validFrom`為`validFrom`，則`null`為UtcNow。
ValidTo	參數的 `validFrom` 值。若`validFrom`為`null`，則為該性質的ValidFrom值（由`validFrom`參數決定）加上該性質。SessionSecurityTokenHandler.DefaultTokenLifetime

適用於

SessionSecurityToken(ClaimsPrincipal, String, String, Nullable<DateTime>, Nullable<DateTime>)

從指定的主體與啟動標記初始化該類別的新實例 SessionSecurityToken ;並以指定的開始時間與到期時間初始化。新的令牌會被限定到指定的端點。

public:
 SessionSecurityToken(System::Security::Claims::ClaimsPrincipal ^ claimsPrincipal, System::String ^ context, System::String ^ endpointId, Nullable<DateTime> validFrom, Nullable<DateTime> validTo);

public SessionSecurityToken(System.Security.Claims.ClaimsPrincipal claimsPrincipal, string context, string endpointId, DateTime? validFrom, DateTime? validTo);

new System.IdentityModel.Tokens.SessionSecurityToken : System.Security.Claims.ClaimsPrincipal * string * string * Nullable<DateTime> * Nullable<DateTime> -> System.IdentityModel.Tokens.SessionSecurityToken

Public Sub New (claimsPrincipal As ClaimsPrincipal, context As String, endpointId As String, validFrom As Nullable(Of DateTime), validTo As Nullable(Of DateTime))

參數

claimsPrincipal: ClaimsPrincipal

由自舉令牌產生的理賠主體。

context: String

一個可選的、針對特定應用程式的上下文字串。

endpointId: String

這個標記綁定到的端點。空字串會產生一個無作用域的標記。

validFrom: Nullable<DateTime>

標記生效的時間點。 null 以指定 UtcNow。

validTo: Nullable<DateTime>

即該代幣不再有效的時間瞬間。 null 指定應將屬性值 DefaultTokenLifetime 加到參數指定 validFrom 時間內來決定。

例外狀況

ArgumentNullException

claimsPrincipal 是 null。

-或-

Identities 的 claimsPrincipal 屬性是 null。

-或-

endpointId 是 null。

ArgumentOutOfRangeException

validFrom和validTo參數無法驗證;例如，指定validTo一個發生在 validFrom之前的時間點。

備註

下表顯示該 SessionSecurityToken 類別實例的初始屬性值。

房產	初始值
ClaimsPrincipal	`claimsPrincipal`
Context	`context`
ContextId	設定為產生的唯一 ID。
EndpointId	`endpointId`
Id	設定為產生的唯一 ID。
IsPersistent	`false`
IsReferenceMode	`false`
KeyEffectiveTime	設定為由ValidFrom參數決定的屬性值`ValidFrom`。
KeyExpirationTime	該屬性的價值 ValidTo 由 `ValidTo` 參數決定。
KeyGeneration	`null`
SecurityKeys	包含一個產生的 128 位元對稱金鑰。註：預設實作並未使用此特性。簽約金鑰與加密金鑰由處理該憑證的所施加 SessionSecurityTokenHandler 的 Cookie 轉換所決定。
ValidFrom	參數值，或若`validFrom`為`validFrom`，則`null`為UtcNow。
ValidTo	參數的 `validFrom` 值。若`validFrom`為`null`，則為該性質的ValidFrom值（由`validFrom`參數決定）加上該性質。SessionSecurityTokenHandler.DefaultTokenLifetime

適用於

SessionSecurityToken(ClaimsPrincipal, UniqueId, String, String, TimeSpan, SymmetricSecurityKey)

透過使用指定的主體、上下文 ID、上下文、端點、壽命與鍵來初始化該 SessionSecurityToken 類別的新實例。

public:
 SessionSecurityToken(System::Security::Claims::ClaimsPrincipal ^ claimsPrincipal, System::Xml::UniqueId ^ contextId, System::String ^ context, System::String ^ endpointId, TimeSpan lifetime, System::IdentityModel::Tokens::SymmetricSecurityKey ^ key);

public SessionSecurityToken(System.Security.Claims.ClaimsPrincipal claimsPrincipal, System.Xml.UniqueId contextId, string context, string endpointId, TimeSpan lifetime, System.IdentityModel.Tokens.SymmetricSecurityKey key);

new System.IdentityModel.Tokens.SessionSecurityToken : System.Security.Claims.ClaimsPrincipal * System.Xml.UniqueId * string * string * TimeSpan * System.IdentityModel.Tokens.SymmetricSecurityKey -> System.IdentityModel.Tokens.SessionSecurityToken

Public Sub New (claimsPrincipal As ClaimsPrincipal, contextId As UniqueId, context As String, endpointId As String, lifetime As TimeSpan, key As SymmetricSecurityKey)

參數

claimsPrincipal: ClaimsPrincipal

與本次會議相關的理賠原則。

contextId: UniqueId

與此標記相關的上下文識別碼。

context: String

一個可選的、針對特定應用程式的上下文字串。

endpointId: String

這個標記綁定到的端點。空字串會產生一個無作用域的標記。

lifetime: TimeSpan

會話代幣的壽命。 ValidFrom屬性將設為，UtcNow屬性ValidTo將被設定為加上ValidFrom此參數指定的週期。

key: SymmetricSecurityKey

一個可選的對稱會話金鑰。

例外狀況

ArgumentNullException

claimsPrincipal 是 null。

-或-

Identities 的 claimsPrincipal 屬性是 null。

-或-

contextId 是 null。

-或-

endpointId 是 null。

InvalidOperationException

lifetime 小於或等於 Zero。

備註

下表顯示該 SessionSecurityToken 類別實例的初始屬性值。

房產	初始值
ClaimsPrincipal	`claimsPrincipal`
Context	`context`
ContextId	`contextId`
EndpointId	`endpointId`
Id	設定為產生的唯一 ID。
IsPersistent	`false`
IsReferenceMode	`false`
KeyEffectiveTime	UtcNow
KeyExpirationTime	UtcNow 加 `lifetime`
KeyGeneration	`null`
SecurityKeys	包含一個元素，若為`key`，則為`keynull`生成的128位元對稱金鑰。註：預設實作並未使用此特性。簽約金鑰與加密金鑰由處理該憑證的所施加 SessionSecurityTokenHandler 的 Cookie 轉換所決定。
ValidFrom	UtcNow
ValidTo	UtcNow 加 `lifetime`

適用於

SessionSecurityToken(ClaimsPrincipal, UniqueId, String, String, DateTime, TimeSpan, SymmetricSecurityKey)

透過使用指定的主體、上下文 ID、上下文、端點、有效時間戳、壽命及鍵來初始化該 SessionSecurityToken 類別的新實例。

public:
 SessionSecurityToken(System::Security::Claims::ClaimsPrincipal ^ claimsPrincipal, System::Xml::UniqueId ^ contextId, System::String ^ context, System::String ^ endpointId, DateTime validFrom, TimeSpan lifetime, System::IdentityModel::Tokens::SymmetricSecurityKey ^ key);

public SessionSecurityToken(System.Security.Claims.ClaimsPrincipal claimsPrincipal, System.Xml.UniqueId contextId, string context, string endpointId, DateTime validFrom, TimeSpan lifetime, System.IdentityModel.Tokens.SymmetricSecurityKey key);

new System.IdentityModel.Tokens.SessionSecurityToken : System.Security.Claims.ClaimsPrincipal * System.Xml.UniqueId * string * string * DateTime * TimeSpan * System.IdentityModel.Tokens.SymmetricSecurityKey -> System.IdentityModel.Tokens.SessionSecurityToken

Public Sub New (claimsPrincipal As ClaimsPrincipal, contextId As UniqueId, context As String, endpointId As String, validFrom As DateTime, lifetime As TimeSpan, key As SymmetricSecurityKey)

參數

claimsPrincipal: ClaimsPrincipal

與本次會議相關的理賠原則。

contextId: UniqueId

與此標記相關的上下文識別碼。

context: String

一個可選的、針對特定應用程式的上下文字串。

endpointId: String

這個標記綁定到的端點。空字串會產生一個無作用域的標記。

validFrom: DateTime

代幣生效的時間點。

lifetime: TimeSpan

會話代幣的壽命。屬性 ValidTo 將設為 ValidFrom 加此參數所指定的週期。

key: SymmetricSecurityKey

一個可選的對稱會話金鑰。

例外狀況

ArgumentNullException

claimsPrincipal 是 null。

-或-

Identities 的 claimsPrincipal 屬性是 null。

-或-

contextId 是 null。

-或-

endpointId 是 null。

InvalidOperationException

lifetime 小於或等於 Zero。

備註

下表顯示該 SessionSecurityToken 類別實例的初始屬性值。

房產	初始值
ClaimsPrincipal	`claimsPrincipal`
Context	`context`
ContextId	`contextId` 或者，若 `contextId` 為， `null`則為產生的唯一ID。
EndpointId	`endpointId`
Id	設定為產生的唯一 ID。
IsPersistent	`false`
IsReferenceMode	`false`
KeyEffectiveTime	`validFrom`
KeyExpirationTime	`validFrom` 加 `lifetime`。
KeyGeneration	`null`
SecurityKeys	包含一個元素，若為`key`，則為`keynull`生成的128位元對稱金鑰。註：預設實作並未使用此特性。簽約金鑰與加密金鑰由處理該憑證的所施加 SessionSecurityTokenHandler 的 Cookie 轉換所決定。
ValidFrom	`validFrom`
ValidTo	`validFrom` 加 `lifetime`。

適用於

SessionSecurityToken(ClaimsPrincipal, UniqueId, String, String, Nullable<DateTime>, Nullable<DateTime>, SymmetricSecurityKey)

透過指定的主體、上下文 ID、上下文、端點、開始時間、到期時間及鍵來初始化類別的新 SessionSecurityToken 實例。

public:
 SessionSecurityToken(System::Security::Claims::ClaimsPrincipal ^ claimsPrincipal, System::Xml::UniqueId ^ contextId, System::String ^ context, System::String ^ endpointId, Nullable<DateTime> validFrom, Nullable<DateTime> validTo, System::IdentityModel::Tokens::SymmetricSecurityKey ^ key);

public SessionSecurityToken(System.Security.Claims.ClaimsPrincipal claimsPrincipal, System.Xml.UniqueId contextId, string context, string endpointId, DateTime? validFrom, DateTime? validTo, System.IdentityModel.Tokens.SymmetricSecurityKey key);

new System.IdentityModel.Tokens.SessionSecurityToken : System.Security.Claims.ClaimsPrincipal * System.Xml.UniqueId * string * string * Nullable<DateTime> * Nullable<DateTime> * System.IdentityModel.Tokens.SymmetricSecurityKey -> System.IdentityModel.Tokens.SessionSecurityToken

Public Sub New (claimsPrincipal As ClaimsPrincipal, contextId As UniqueId, context As String, endpointId As String, validFrom As Nullable(Of DateTime), validTo As Nullable(Of DateTime), key As SymmetricSecurityKey)

參數

claimsPrincipal: ClaimsPrincipal

與本次會議相關的理賠原則。

contextId: UniqueId

與此標記相關的上下文識別碼。

context: String

一個可選的、針對特定應用程式的上下文字串。

endpointId: String

這個標記綁定到的端點。空字串會產生一個無作用域的標記。

validFrom: Nullable<DateTime>

標記生效的時間點。 null 以指定 UtcNow。

validTo: Nullable<DateTime>

即該代幣不再有效的時間瞬間。 null 指定應將屬性值 DefaultTokenLifetime 加到參數指定 validFrom 時間內來決定。

key: SymmetricSecurityKey

一個可選的對稱會話金鑰。

例外狀況

ArgumentNullException

claimsPrincipal 是 null。

-或-

Identities 的 claimsPrincipal 屬性是 null。

-或-

contextId 是 null。

ArgumentOutOfRangeException

validFrom大於或等於。validTo

-或-

validTo 比目前的時間還要少。

備註

下表顯示該 SessionSecurityToken 類別實例的初始屬性值。

房產	初始值
ClaimsPrincipal	`claimsPrincipal`
Context	`context`
ContextId	`contextId`
EndpointId	`endpointId`
Id	設定為產生的唯一 ID。
IsPersistent	`false`
IsReferenceMode	`false`
KeyEffectiveTime	設定為由ValidFrom參數決定的屬性值`ValidFrom`。
KeyExpirationTime	該屬性的價值 ValidTo 由 `ValidTo` 參數決定。
KeyGeneration	`null`
SecurityKeys	包含一個元素，若為`key`，則為`keynull`生成的128位元對稱金鑰。註：預設實作並未使用此特性。簽約金鑰與加密金鑰由處理該憑證的所施加 SessionSecurityTokenHandler 的 Cookie 轉換所決定。
ValidFrom	參數值，或若`validFrom`為`validFrom`，則`null`為UtcNow。
ValidTo	參數的 `validFrom` 值。若`validFrom`為`null`，則為該性質的ValidFrom值（由`validFrom`參數決定）加上該性質。SessionSecurityTokenHandler.DefaultTokenLifetime

適用於

意見反應

此頁面對您有幫助嗎？