语言

ClaimsIdentity 类

定义

表示基于声明的标识。

public ref class ClaimsIdentity : System::Security::Principal::IIdentity
public class ClaimsIdentity : System.Security.Principal.IIdentity
[System.Runtime.InteropServices.ComVisible(true)]
[System.Serializable]
public class ClaimsIdentity : System.Security.Principal.IIdentity
type ClaimsIdentity = class
    interface IIdentity
[<System.Runtime.InteropServices.ComVisible(true)>]
[<System.Serializable>]
type ClaimsIdentity = class
    interface IIdentity
Public Class ClaimsIdentity
Implements IIdentity
继承
ClaimsIdentity
派生
特性
实现

注解

此类 ClaimsIdentity 是基于声明的标识的具体实现;即声明集合描述的标识。 声明是有关颁发者所创建的实体的声明,该实体描述该实体的属性、权利或其他一些质量。 这种实体据说是索赔的主题。 声明由 Claim 类表示。 包含在描述 ClaimsIdentity 相应标识所表示的实体中的声明,可用于做出授权和身份验证决策。 基于声明的访问模型比依赖角色的传统访问模型具有许多优势。 例如,声明可以提供更丰富的标识信息,并且可以以更具体的方式评估其授权或身份验证。

从 .NET Framework 4.5 开始,Windows Identity Foundation(WIF)和基于声明的标识已完全集成到 .NET Framework 中。 这意味着许多表示 .NET Framework 中的标识的类现在通过声明集合派 ClaimsIdentity 生并描述其属性。 这不同于 .NET Framework 的早期版本,在这些版本中,这些类直接实现了 IIdentity 接口。 可以通过属性访问描述标识的 Claims 声明集合。 该 ClaimsIdentity 类提供了多种用于查找和修改声明的方法,并且完全支持语言集成查询(LINQ)。 在应用程序代码中, ClaimsIdentity 对象通常通过 ClaimsPrincipal 对象访问;例如,由该对象返回的 Thread.CurrentPrincipal主体。

注释

该 ClaimsPrincipal 类也有一个 Claims 属性。 在大多数情况下,应通过 ClaimsPrincipal.Claims 集合而不是 Claims 集合访问用户的声明。 只有在主体包含多个ClaimsIdentity且需要评估或修改特定标识的情况下,才需要访问个人ClaimsIdentity声明。

Important

若要添加或删除集合中的 Claims 声明,调用方必须具有完全信任。

在基于声明的模型中, IIdentity.Name 属性和 IPrincipal.IsInRole(String) 方法通过评估标识所包含的声明来实现。 基于声明的模型中的基本实现由 ClaimsIdentity.Name 属性和 ClaimsPrincipal.IsInRole 方法提供。 使用 NameClaimType 和 RoleClaimType 属性可以指定一个声明类型,该类型应该用于在执行这些操作时评估标识所包含的声明。

通过 Actor 属性 BootstrapContext 支持委派方案。

构造函数

名称 说明
ClaimsIdentity()

使用空声明集合初始化类的新实例 ClaimsIdentity 。

ClaimsIdentity(BinaryReader, StringComparison)

使用指定的ClaimsIdentity实例BinaryReader初始化实例。

ClaimsIdentity(BinaryReader)

使用指定的ClaimsIdentity实例BinaryReader初始化实例。

ClaimsIdentity(ClaimsIdentity, StringComparison)

从现有ClaimsIdentity实例初始化类的新实例ClaimsIdentity。

ClaimsIdentity(ClaimsIdentity)

从现有ClaimsIdentity实例初始化类的新实例ClaimsIdentity。

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

使用指定的声明、身份验证类型、名称声明类型和角色声明类型初始化类的新实例 ClaimsIdentity 。

ClaimsIdentity(IEnumerable<Claim>, String)

使用指定的声明和身份验证类型初始化类的新实例 ClaimsIdentity 。

ClaimsIdentity(IEnumerable<Claim>)

使用枚举的对象ClaimsIdentity集合初始化类的新实例Claim。

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

初始化 ClaimsIdentity 类的新实例。

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

使用指定的ClaimsIdentity声明、身份验证类型、名称声明类型和角色声明类型初始化类的新实例IIdentity。

ClaimsIdentity(IIdentity, IEnumerable<Claim>)

使用指定的声明和指定的ClaimsIdentity声明初始化类的新实例IIdentity。

ClaimsIdentity(IIdentity)

使用指定ClaimsIdentity的名称和身份验证类型初始化类的新实例IIdentity。

ClaimsIdentity(SerializationInfo, StreamingContext)
已过时.

从使用 <a0/> 创建的序列化流初始化类的新实例。

ClaimsIdentity(SerializationInfo)
已过时.

从使用 <a0/> 创建的序列化流初始化类的新实例。

ClaimsIdentity(String, String, String)

使用指定的身份验证类型、名称声明类型和角色声明类型初始化类的新实例 ClaimsIdentity 。

ClaimsIdentity(String)

使用空声明集合和指定的身份验证类型初始化类的新实例 ClaimsIdentity 。

字段

名称 说明
DefaultIssuer

默认颁发者;“LOCAL AUTHORITY”。

DefaultNameClaimType

默认名称声明类型; Name。

DefaultRoleClaimType

默认角色声明类型; Role。

属性

名称 说明
Actor

获取或设置已授予委派权限的调用方的身份。

AuthenticationType

获取身份验证类型。

BootstrapContext

获取或设置用于创建此声明标识的令牌。

Claims

获取与此声明标识关联的声明。

CustomSerializationData

包含派生类型提供的任何其他数据。 通常在调用 WriteTo(BinaryWriter, Byte[])时设置 。

IsAuthenticated

获取一个值,该值指示是否已对标识进行身份验证。

Label

获取或设置此声明标识的标签。

Name

获取此声明标识的名称。

NameClaimType

获取用于确定哪些声明提供此声明标识属性的值 Name 的声明类型。

RoleClaimType

获取将解释为此声明标识中声明中的 .NET 角色的声明类型。

方法

名称 说明
AddClaim(Claim)

向此声明标识添加单个声明。

AddClaims(IEnumerable<Claim>)

向此声明标识添加声明列表。

Clone()

返回从此声明标识复制的新 ClaimsIdentity 值。

CreateClaim(BinaryReader)

为派生类型提供扩展点以创建自定义 Claim。

Equals(Object)

确定指定的对象是否等于当前对象。

(继承自 Object)
FindAll(Predicate<Claim>)

检索由指定谓词匹配的所有声明。

FindAll(String)

检索具有指定声明类型的所有声明。

FindFirst(Predicate<Claim>)

检索与指定谓词匹配的第一个声明。

FindFirst(String)

检索具有指定声明类型的第一个声明。

GetHashCode()

用作默认哈希函数。

(继承自 Object)
GetObjectData(SerializationInfo, StreamingContext)

使用 SerializationInfo 序列化当前 ClaimsIdentity 对象所需的数据填充数据。

GetType()

获取当前实例的 Type。

(继承自 Object)
HasClaim(Predicate<Claim>)

确定此声明标识是否具有与指定谓词匹配的声明。

HasClaim(String, String)

确定此声明标识是否具有具有指定声明类型和值的声明。

MemberwiseClone()

创建当前 Object的浅表副本。

(继承自 Object)
RemoveClaim(Claim)

尝试从声明标识中删除声明。

ToString()

返回一个表示当前对象的字符串。

(继承自 Object)
TryRemoveClaim(Claim)

尝试从声明标识中删除声明。

WriteTo(BinaryWriter, Byte[])

使用 BinaryWriter.

WriteTo(BinaryWriter)

使用 BinaryWriter.

适用于

另请参阅