SessionSecurityToken 建構函式
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
初始化 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
宣告主體,會從其中初始化語彙基元。
例外狀況
備註
下表所顯示的是 SessionSecurityToken 類別之執行個體的初始屬性值。
屬性 | 初始值 |
---|---|
ClaimsPrincipal | claimsPrincipal |
Context | null |
ContextId | 設定為產生的唯一識別碼。 |
EndpointId | String.Empty |
Id | 設定為產生的唯一識別碼。 |
IsPersistent | false |
IsReferenceMode | false |
KeyEffectiveTime | UtcNow |
KeyExpirationTime | UtcNowSessionSecurityTokenHandler.DefaultTokenLifetime加上 屬性。 |
KeyGeneration | null |
SecurityKeys | 包含產生的 128 位對稱金鑰。 注意: 預設實作不會使用這個屬性。 簽署和加密金鑰是由處理權杖的 所套用 SessionSecurityTokenHandler 的 Cookie 轉換所決定。 |
ValidFrom | UtcNow |
ValidTo | UtcNowSessionSecurityTokenHandler.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
應用程式特定的選擇性內容字串。
例外狀況
備註
下表所顯示的是 SessionSecurityToken 類別之執行個體的初始屬性值。
屬性 | 初始值 |
---|---|
ClaimsPrincipal | claimsPrincipal |
Context | context |
ContextId | 設定為產生的唯一識別碼。 |
EndpointId | String.Empty |
Id | 設定為產生的唯一識別碼。 |
IsPersistent | false |
IsReferenceMode | false |
KeyEffectiveTime | UtcNow |
KeyExpirationTime | UtcNowSessionSecurityTokenHandler.DefaultTokenLifetime加上 屬性。 |
KeyGeneration | null |
SecurityKeys | 包含產生的 128 位對稱金鑰。 注意: 預設實作不會使用這個屬性。 簽署和加密金鑰是由處理權杖的 所套用 SessionSecurityTokenHandler 的 Cookie 轉換所決定。 |
ValidFrom | UtcNow |
ValidTo | UtcNowSessionSecurityTokenHandler.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再加上此參數所指定的期間。
例外狀況
lifetime
小於或等於 Zero。
備註
下表所顯示的是 SessionSecurityToken 類別之執行個體的初始屬性值。
屬性 | 初始值 |
---|---|
ClaimsPrincipal | claimsPrincipal |
Context | null |
ContextId | 設定為產生的唯一識別碼。 |
EndpointId | String.Empty |
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
應用程式特定的選擇性內容字串。
瞬間,超過此瞬間之後權杖不再有效。 null
會指定該值應藉由將 DefaultTokenLifetime 屬性的值與 validFrom
參數指定的時間相加來決定。
例外狀況
無法驗證 validFrom
和 validTo
參數,例如 validTo
指定了比 validFrom
還要早發生的時間。
備註
下表所顯示的是 SessionSecurityToken 類別之執行個體的初始屬性值。
屬性 | 初始值 |
---|---|
ClaimsPrincipal | claimsPrincipal |
Context | context |
ContextId | 設定為產生的唯一識別碼。 |
EndpointId | String.Empty |
Id | 設定為產生的唯一識別碼。 |
IsPersistent | false |
IsReferenceMode | false |
KeyEffectiveTime | 設定為 參數所 ValidFrom 決定的 ValidFrom 屬性值。 |
KeyExpirationTime | 由 參數決定 ValidTo 的 ValidTo 屬性值。 |
KeyGeneration | null |
SecurityKeys | 包含產生的 128 位對稱金鑰。 注意: 預設實作不會使用這個屬性。 簽署和加密金鑰是由處理權杖的 所套用 SessionSecurityTokenHandler 的 Cookie 轉換所決定。 |
ValidFrom | 參數的值 validFrom ,如果 為 , UtcNow 則為 validFrom null 。 |
ValidTo | validFrom 參數的值。 如果 validFrom 為 null ,則屬性的值 ValidFrom (由 參數) 加上 SessionSecurityTokenHandler.DefaultTokenLifetime 屬性所決定 validFrom 。 |
適用於
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
這個權杖要繫結至的端點。 空字串會建立不限範圍的權杖。
瞬間,超過此瞬間之後權杖不再有效。 null
會指定該值應藉由將 DefaultTokenLifetime 屬性的值與 validFrom
參數指定的時間相加來決定。
例外狀況
無法驗證 validFrom
和 validTo
參數,例如 validTo
指定了比 validFrom
還要早發生的時間。
備註
下表所顯示的是 SessionSecurityToken 類別之執行個體的初始屬性值。
屬性 | 初始值 |
---|---|
ClaimsPrincipal | claimsPrincipal |
Context | context |
ContextId | 設定為產生的唯一識別碼。 |
EndpointId | endpointId |
Id | 設定為產生的唯一識別碼。 |
IsPersistent | false |
IsReferenceMode | false |
KeyEffectiveTime | 設定為 參數所 ValidFrom 決定的 ValidFrom 屬性值。 |
KeyExpirationTime | 由 參數決定 ValidTo 的 ValidTo 屬性值。 |
KeyGeneration | null |
SecurityKeys | 包含產生的 128 位對稱金鑰。 注意: 預設實作不會使用這個屬性。 簽署和加密金鑰是由處理權杖的 所套用 SessionSecurityTokenHandler 的 Cookie 轉換所決定。 |
ValidFrom | 參數的值 validFrom ,如果 為 , UtcNow 則為 validFrom null 。 |
ValidTo | validFrom 參數的值。 如果 validFrom 為 null ,則屬性的值 ValidFrom (由 參數) 加上 SessionSecurityTokenHandler.DefaultTokenLifetime 屬性所決定 validFrom 。 |
適用於
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
這個權杖要繫結至的端點。 空字串會建立不限範圍的權杖。
選擇性對稱工作階段金鑰。
例外狀況
claimsPrincipal
為 null
。
-或-
claimsPrincipal
的 Identities 屬性為 null
。
-或-
contextId
為 null
。
-或-
endpointId
為 null
。
lifetime
小於或等於 Zero。
備註
下表所顯示的是 SessionSecurityToken 類別之執行個體的初始屬性值。
屬性 | 初始值 |
---|---|
ClaimsPrincipal | claimsPrincipal |
Context | context |
ContextId | contextId |
EndpointId | endpointId |
Id | 設定為產生的唯一識別碼。 |
IsPersistent | false |
IsReferenceMode | false |
KeyEffectiveTime | UtcNow |
KeyExpirationTime | UtcNow 加 lifetime |
KeyGeneration | null |
SecurityKeys | 包含單一專案, key 如果 key 為 null ,則為 ,則為產生的 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
權杖變成有效的時間。
選擇性對稱工作階段金鑰。
例外狀況
claimsPrincipal
為 null
。
-或-
claimsPrincipal
的 Identities 屬性為 null
。
-或-
contextId
為 null
。
-或-
endpointId
為 null
。
lifetime
小於或等於 Zero。
備註
下表所顯示的是 SessionSecurityToken 類別之執行個體的初始屬性值。
屬性 | 初始值 |
---|---|
ClaimsPrincipal | claimsPrincipal |
Context | context |
ContextId | contextId 或者,如果 contextId 是 null ,則為產生的唯一識別碼。 |
EndpointId | endpointId |
Id | 設定為產生的唯一識別碼。 |
IsPersistent | false |
IsReferenceMode | false |
KeyEffectiveTime | validFrom |
KeyExpirationTime | validFrom 加上 lifetime 。 |
KeyGeneration | null |
SecurityKeys | 包含單一專案, key 如果 key 為 null ,則為 ,則為產生的 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
這個權杖要繫結至的端點。 空字串會建立不限範圍的權杖。
瞬間,超過此瞬間之後權杖不再有效。 null
會指定該值應藉由將 DefaultTokenLifetime 屬性的值與 validFrom
參數指定的時間相加來決定。
選擇性對稱工作階段金鑰。
例外狀況
備註
下表所顯示的是 SessionSecurityToken 類別之執行個體的初始屬性值。
屬性 | 初始值 |
---|---|
ClaimsPrincipal | claimsPrincipal |
Context | context |
ContextId | contextId |
EndpointId | endpointId |
Id | 設定為產生的唯一識別碼。 |
IsPersistent | false |
IsReferenceMode | false |
KeyEffectiveTime | 設定為 參數所 ValidFrom 決定的 ValidFrom 屬性值。 |
KeyExpirationTime | 由 參數決定 ValidTo 的 ValidTo 屬性值。 |
KeyGeneration | null |
SecurityKeys | 包含單一元素, key 如果 key 為 null ,則為 產生的 128 位對稱金鑰。 注意: 預設實作不會使用這個屬性。 簽署和加密金鑰是由處理權杖之 所 SessionSecurityTokenHandler 套用的 Cookie 轉換所決定。 |
ValidFrom | 參數的值 validFrom ,如果 為 , UtcNow 則為 validFrom null 。 |
ValidTo | validFrom 參數的值。 如果 為 null validFrom ,則屬性的值 ValidFrom (由 validFrom 參數所決定) 加上 SessionSecurityTokenHandler.DefaultTokenLifetime 屬性。 |