‫دسترسی آسان‌تر به بازتاب با [UnsafeAccessorType] در NET 10.

• محدودیت visibility: انواع داخلی یا خصوصی که نمی‌توانید در کد خود import کنید.
• محدودیت کامپایل‌تایم: زمانی که انواع در لایبرری‌های دیگر هستند و به دلیل وابستگی‌های چرخه‌ای (circular dependencies) یا مسائل نسخه‌بندی، نمی‌توانید به آن‌ها ارجاع دهید. مثلاً در لایبرری‌های instrumentation مانند Datadog، یا حتی در خود runtime .NET برای لایبرری‌های HTTP و Cryptography.

var itemsFieldInfo = typeof(List<int>).GetField("_items", BindingFlags.NonPublic | BindingFlags.Instance);
var list = new List<int>(16);
var items = (int[])itemsFieldInfo.GetValue(list);
Console.WriteLine($"{items.Length} items"); // خروجی: 16 items

var list = new List<int>(16);
int[] items = Accessors<int>.GetItems(list);
Console.WriteLine($"{items.Length} items"); // خروجی: 16 items

static class Accessors<T>
{
    [UnsafeAccessor(UnsafeAccessorKind.Field, Name = "_items")]
    public static extern ref T[] GetItems(List<T> list);
}

bool isCompat = Accessors<int?>.IsCompatibleObject(null, 123); // true

static class Accessors<T>
{
    [UnsafeAccessor(UnsafeAccessorKind.StaticMethod, Name = "IsCompatibleObject")]
    public static extern bool IsCompatibleObject(List<T> instance, object? value);
}

var list = new List<int>(16);
Accessors<int>.GetItems(list) = Array.Empty<int>();
Console.WriteLine($"Capacity: {list.Capacity}"); // خروجی: 0

public class PublicClass
{
    private readonly PrivateClass _private = new("Hello world!");
    internal PrivateClass GetPrivate() => _private;
}

internal class PrivateClass(string someValue)
{
    internal string SomeValue { get; } = someValue;
}

[UnsafeAccessor(UnsafeAccessorKind.Method, Name = "GetPrivate")]
[return: UnsafeAccessorType("PrivateClass")]
static extern object GetByMethod(PublicClass instance);

[UnsafeAccessor(UnsafeAccessorKind.Method, Name = "get_SomeValue")]
static extern string GetSomeValue([UnsafeAccessorType("PrivateClass")] object instance);

var publicClass = new PublicClass();
object privateClass = GetByMethod(publicClass);
string value = GetSomeValue(privateClass);
Console.WriteLine(value); // خروجی: Hello world!

[UnsafeAccessor(UnsafeAccessorKind.Method, Name = "GenericWithConstraints")]
public extern static bool CallGenericClassGenericWithConstraints<V, W>(
    [UnsafeAccessorType("PrivateLib.GenericClass`1[[!0]], PrivateLib")] object tgt,
    [UnsafeAccessorType("System.Collections.Generic.List`1[[!0]]")] object a,
    [UnsafeAccessorType("System.Collections.Generic.List`1[[!!0]]")] object b,
    List<W> c,
    [UnsafeAccessorType("System.Collections.Generic.List`1[[PrivateLib.Class1, PrivateLib]]")] object d) where W : T;

• نمی‌توانید برای انواع ژنریک که پارامتر نوع غیرقابل ارجاع است، instance بسازید.
• فیلدها یا متدهای ref-returning که نوعشان نیاز به [UnsafeAccessorType] دارد، پشتیبانی نمی‌شوند (خطای NotSupportedException).