SessionSecurityToken 构造函数

定义

命名空间:: System.IdentityModel.Tokens

程序集:: System.IdentityModel.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

重载

名称	说明
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 为 claimsPrincipalnull.

注解

下表显示了类实例 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 为 claimsPrincipalnull.

注解

下表显示了类实例 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 为 claimsPrincipalnull.

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 为 claimsPrincipalnull.

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` 。 `null`如果是`validFrom`，则属性的值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 为 claimsPrincipalnull.

-或-

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` 。 `null`如果是`validFrom`，则属性的值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 为 claimsPrincipalnull.

-或-

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`如果为`null`生成的 128 位对称密钥，则`key`包含单个元素。注意：默认实现不使用此属性。签名和加密密钥由处理令牌的 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 为 claimsPrincipalnull.

-或-

contextId 是 null。

-或-

endpointId 是 null。

InvalidOperationException

lifetime 小于或等于 Zero。

注解

下表显示了类实例 SessionSecurityToken 的初始属性值。

财产	初始值
ClaimsPrincipal	`claimsPrincipal`
Context	`context`
ContextId	`contextId`或者，如果是`contextIdnull`，则为生成的唯一 ID。
EndpointId	`endpointId`
Id	设置为生成的唯一 ID。
IsPersistent	`false`
IsReferenceMode	`false`
KeyEffectiveTime	`validFrom`
KeyExpirationTime	`validFrom` 加 `lifetime`。
KeyGeneration	`null`
SecurityKeys	包含一个元素，`key`如果为`null`生成的 128 位对称密钥，则`key`包含单个元素。注意：默认实现不使用此属性。签名和加密密钥由处理令牌的 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 为 claimsPrincipalnull.

-或-

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`如果为`null`生成的 128 位对称密钥，则`key`包含单个元素。注意：默认实现不使用此属性。签名和加密密钥由处理令牌的 SessionSecurityTokenHandler Cookie 转换决定。
ValidFrom	参数的值`validFrom`，或者（如果`validFrom`为`null`UtcNow）。
ValidTo	参数的值 `validFrom` 。 `null`如果是`validFrom`，则属性的值ValidFrom（由`validFrom`参数确定）和SessionSecurityTokenHandler.DefaultTokenLifetime属性。

适用于

反馈

此页面是否有帮助？