在.NET Standard 2.0中如何获取System.IdentityModel及ClaimSet替代类?
刚处理过类似的迁移场景,你遇到的核心问题是:.NET Framework里的ClaimSet在.NET Standard 2.0中没有直接等效类,但它的功能已经被更灵活的ClaimsIdentity和ClaimsPrincipal完全替代了,而Claim类其实是存在的,只是命名空间和引用方式有变化。下面一步步给你讲怎么改:
1. 先搞清楚命名空间的变化
在.NET Framework中,声明相关类型可能在System.IdentityModel.Claims命名空间下,但在.NET Standard 2.0里,所有声明类都统一移到了System.Security.Claims命名空间。所以第一步,把代码里的旧命名空间引用替换掉:
// 原来的(.NET Framework) using System.IdentityModel.Claims; // 替换成(.NET Standard 2.0) using System.Security.Claims;
2. ClaimSet的完全替代方案
.NET Framework里的ClaimSet本质就是一组Claim的集合,用来表示一个身份的所有声明。在.NET Standard 2.0中,这个角色由ClaimsIdentity承担:
ClaimsIdentity自带一个Claims属性(IEnumerable<Claim>),用来存储声明集合- 它还提供了
AddClaim、AddClaims、FindAll等方法,完全覆盖ClaimSet的功能
举个代码对比的例子:
原来的.NET Framework代码
var claimSet = new ClaimSet(); claimSet.Add(new Claim(ClaimTypes.Name, "Alice")); var nameClaims = claimSet.FindClaims(ClaimTypes.Name, null);
迁移后的.NET Standard 2.0代码
var identity = new ClaimsIdentity(); identity.AddClaim(new Claim(ClaimTypes.Name, "Alice")); var nameClaims = identity.FindAll(ClaimTypes.Name); // 或者用LINQ更灵活地查询 var nameClaims = identity.Claims.Where(c => c.Type == ClaimTypes.Name);
如果你的场景需要多个身份的声明集合(比如用户同时拥有多个角色身份),可以用ClaimsPrincipal来包裹多个ClaimsIdentity实例,这比原来的ClaimSet组合方式更符合现代.NET的身份模型。
3. Claim类的兼容使用
放心,Claim类在.NET Standard 2.0中是完全存在的,它的构造函数、核心属性(Type、Value、ValueType等)和.NET Framework版本完全兼容,几乎不需要修改原有代码里的Claim实例化逻辑。
4. 常见迁移坑点解决
- 找不到类型?先检查NuGet引用:如果你的项目里还是找不到
System.Security.Claims下的类型,试着安装System.Security.ClaimsNuGet包(虽然.NET Standard 2.0通常默认包含,但老项目可能需要手动添加)。 - 令牌/身份验证场景的扩展:如果你的代码涉及到JWT、SAML等令牌处理,可以安装
System.IdentityModel.Tokens.JwtNuGet包,它完全支持.NET Standard 2.0,能帮你处理声明的序列化、反序列化和验证。 - 旧方法的替代:如果之前用了
ClaimSet的一些冷门方法,比如RemoveClaim,可以直接操作ClaimsIdentity.Claims集合(或者通过ClaimsIdentity的方法来处理),或者用LINQ实现同等逻辑。
总结迁移步骤
- 替换所有
System.IdentityModel.Claims命名空间引用为System.Security.Claims - 将所有
ClaimSet实例替换为ClaimsIdentity(单身份)或ClaimsPrincipal(多身份) - 调整
ClaimSet相关的方法调用为ClaimsIdentity对应的方法 - 必要时安装相关NuGet包确保依赖完整
这样就能完美迁移到.NET Standard 2.0的声明式身份验证模型了。
内容的提问来源于stack exchange,提问作者user365462

