C#中UnsafeAccessor私有访问_C#访问私有成员教程【精通】-C#.Net教程-PHP中文网

unsafeaccessor是.net 8+中专为高性能底层场景设计的不安全访问机制，需启用unsafe上下文、ref返回、extern声明，仅适用于序列化器、内存池等零开销需求，误用将导致jit崩溃或verificationexception。

c#中unsafeaccessor私有访问_c#访问私有成员教程【精通】

UnsafeAccessor 不是“访问私有成员的通用教程工具”，它只在 .NET 8+ 中为极少数高性能、底层场景提供绕过封装的合法通道；用错地方会直接导致 JIT 崩溃或运行时 VerificationException，且编译器不报错。

UnsafeAccessor 必须显式启用 unsafe 上下文

即使只声明一个 [UnsafeAccessor] 方法，项目也必须开启 AllowUnsafeBlocks。否则编译直接失败，错误信息是：CS0227: Unsafe code may only appear if compiling with /unsafe。

操作步骤：

在 .csproj 文件中添加：

<propertygroup><allowunsafeblocks>true</allowunsafeblocks></propertygroup>

所有含 [UnsafeAccessor] 的源文件顶部需加 unsafe 关键字（哪怕没写指针）：
```
unsafe static class Accessors { ... }
```
VS 中若未识别，需重启项目或清除 obj/ 目录重新加载

字段访问必须用 ref 返回 + extern 声明

想读写 List<t>._items</t> 这类私有字段，不能返回值类型，必须用 ref T —— 因为 JIT 需要直接映射内存地址，返回副本会失去意义，且编译器会拒绝。

常见错误写法：

[UnsafeAccessor(UnsafeAccessorKind.Field, Name = "_items")]
static extern int[] GetItems(List<int> list); // ❌ 编译失败：必须是 ref</int>

正确写法：

[UnsafeAccessor(UnsafeAccessorKind.Field, Name = "_items")]
static extern ref int[] GetItems(List<int> list); // ✅</int>

使用时注意：

Wikclawpedia Archive Access

访问、搜索、检索并提交 Wikclawpedia 代理档案中经核实的代理、平台、瞬间、语录和创作者条目。

下载

调用后得到的是 ref int[]，可直接赋值或索引：GetItems(list)[0] = 42;
不能用于 readonly 字段，除非目标字段本身不是 readonly（JIT 会校验字段实际修饰符）
字段名拼错（如 "_Items"）不会编译报错，而是在 JIT 编译该方法时抛出 VerificationException

Method 和 Property 访问需匹配签名与 extern 修饰

访问私有方法（如 get_Value）或属性访问器，[UnsafeAccessor] 声明必须和 IL 签名完全一致，包括 extern、static、返回类型、参数类型 —— 少一个 ref 或多一个 in 都会失败。

例如访问 class A { private int Value { get; set; } }：

[UnsafeAccessor(UnsafeAccessorKind.Method, Name = "get_Value")]
static extern int GetValueUnsafe(A a);

[UnsafeAccessor(UnsafeAccessorKind.Method, Name = "set_Value")]
static extern void SetValueUnsafe(A a, int value);

关键点：

Name 必须是编译期确定的字面量，不能是变量或字符串拼接
属性访问器在 IL 中是独立方法（get_XXX/set_XXX），不能写成 Name = "Value"
若方法有 ref 参数，声明中必须体现，否则 JIT 校验失败
不支持泛型方法特化（如 get_Item<t></t>），仅支持具体签名

它不适合单元测试或业务逻辑代码

很多人误以为 UnsafeAccessor 是反射的“更快替代品”，用来测私有方法 —— 这是危险的误用。它的设计目标明确：序列化框架、内存池管理器、高性能集合包装器等需要零开销访问内部状态的底层库。

真正该用的地方：

自定义 Span<t></t> 或 Memory<t></t> 的底层适配器，需直触 List<t>._items</t> 和 ._size
JSON 序列化器（如 System.Text.Json）跳过属性 getter，直接序列化字段布局
测试框架内建的高性能对象快照比对（如 PrivateProxy 生成的代理）

不该用的地方：

业务类中临时读一个 _cache 字段做调试
单元测试里调用私有方法验证逻辑分支
跨程序集访问 internal 成员（它不解决可见性，只绕过封装检查）

最易被忽略的一点：它不提供任何运行时兼容性兜底 —— 如果目标类在后续版本中重命名字段、改变布局或转为 record，你的 [UnsafeAccessor] 会静默失效，直到 JIT 编译那一刻才崩溃，且堆栈里看不到源码行号。