UnsafeAccessorAttribute 클래스

정의

네임스페이스:

System.Runtime.CompilerServices

어셈블리:

System.Runtime.dll

Source:

UnsafeAccessorAttribute.cs

특정 형식의 액세스할 수 없는 멤버에 대한 액세스를 제공합니다.

public ref class UnsafeAccessorAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Method, AllowMultiple=false, Inherited=false)]
public sealed class UnsafeAccessorAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Method, AllowMultiple=false, Inherited=false)>]
type UnsafeAccessorAttribute = class
    inherit Attribute

Public NotInheritable Class UnsafeAccessorAttribute
Inherits Attribute

상속

Object

Attribute

UnsafeAccessorAttribute

특성

AttributeUsageAttribute

예제

public class Class
{
    static void StaticPrivateMethod() { }
    static int StaticPrivateField;
    Class(int i) { PrivateField = i; }
    void PrivateMethod() { }
    int PrivateField;
    int PrivateProperty { get => PrivateField; }
}

public void CallStaticPrivateMethod()
{
    StaticPrivateMethod(null);

    [UnsafeAccessor(UnsafeAccessorKind.StaticMethod, Name = nameof(StaticPrivateMethod))]
    extern static void StaticPrivateMethod(Class c);
}
public void GetSetStaticPrivateField()
{
    ref int f = ref GetSetStaticPrivateField(null);

    [UnsafeAccessor(UnsafeAccessorKind.StaticField, Name = "StaticPrivateField")]
    extern static ref int GetSetStaticPrivateField(Class c);
}
public void CallPrivateConstructor()
{
    Class c1 = PrivateCtor(1);

    Class c2 = (Class)RuntimeHelpers.GetUninitializedObject(typeof(Class));

    PrivateCtorAsMethod(c2, 2);

    [UnsafeAccessor(UnsafeAccessorKind.Constructor)]
    extern static Class PrivateCtor(int i);

    [UnsafeAccessor(UnsafeAccessorKind.Method, Name = ".ctor")]
    extern static void PrivateCtorAsMethod(Class c, int i);

}
public void CallPrivateMethod(Class c)
{
    PrivateMethod(c);

    [UnsafeAccessor(UnsafeAccessorKind.Method, Name = nameof(PrivateMethod))]
    extern static void PrivateMethod(Class c);
}
public void GetPrivateProperty(Class c)
{
    int f = GetPrivateProperty(c);

    [UnsafeAccessor(UnsafeAccessorKind.Method, Name = "get_PrivateProperty")]
    extern static int GetPrivateProperty(Class c);
}
public void GetSetPrivateField(Class c)
{
    ref int f = ref GetSetPrivateField(c);

    [UnsafeAccessor(UnsafeAccessorKind.Field, Name = "PrivateField")]
    extern static ref int GetSetPrivateField(Class c);
}

// Generic example
public class Class<T>
{
    private T _field;
    private void M(T t) { }
    private void GM<U>(U u) { }
    private void GMWithConstraints<U, V>(U u, V v) where U : V, IEquatable<U> { }
}

class Accessors<V>
{
    [UnsafeAccessor(UnsafeAccessorKind.Field, Name = "_field")]
    public extern static ref V GetSetPrivateField(Class<V> c);

    [UnsafeAccessor(UnsafeAccessorKind.Method, Name = "M")]
    public extern static void CallM(Class<V> c, V v);

    [UnsafeAccessor(UnsafeAccessorKind.Method, Name = "GM")]
    public extern static void CallGM<X>(Class<V> c, X x);

    [UnsafeAccessor(UnsafeAccessorKind.Method, Name = "GMWithConstraints")]
    public extern static void CallGMWithConstraints<X, Y>(Class<V> c, X x, Y y) where X : Y, IEquatable<X>;
}

public void AccessGenericType(Class<int> c)
{
    ref int f = ref Accessors<int>.GetSetPrivateField(c);

    Accessors<int>.CallM(c, 1);

    Accessors<int>.CallGM<string>(c, string.Empty);

    Accessors<int>.CallGMWithConstraints<string, object>(c, string.Empty, new object());
}

설명

메서드에 이 특성을 적용할 extern static 수 있습니다. 이 특성으로 주석이 추가된 메서드의 구현은 특성의 extern static 정보 및 특성이 적용되는 메서드의 서명을 기반으로 런타임에서 제공됩니다. 런타임은 일치하는 메서드 또는 필드를 찾아 호출을 전달하려고 합니다. 일치하는 메서드 또는 필드를 찾을 수 없는 경우 메서드의 본문이 또는 MissingMethodException을 extern static throw MissingFieldException 합니다.

제네릭 매개 변수는 .NET 9부터 지원됩니다. 제네릭 매개 변수는 형식 및 인덱스에서 대상과 일치해야 합니다(즉, 형식 매개 변수는 형식 매개 변수여야 하고 메서드 매개 변수는 메서드 매개 변수여야 합니다). 또한 메서드의 제네릭 매개 변수는 extern static 대상에 반영된 제약 조건과 정확히 일치해야 합니다. 제약 조건이 일치하지 않으면 메서드는 을 throw합니다 InvalidProgramException.

, , 및 의 경우 Method주석이 추가된 extern static 메서드의 첫 번째 인수 형식은 소유 형식을 식별합니다.StaticFieldFieldStaticMethod 정의된 특정 형식만 액세스할 수 없는 멤버에 대해 검사됩니다. 형식 계층 구조에서 일치 항목을 찾지 않습니다.

첫 번째 인수의 값은 instance 필드 및 메서드에 대한 포인터로 this 처리됩니다.

구조체의 instance 필드 및 메서드에 대해 첫 번째 인수를 로 전달 ref 해야 합니다.

첫 번째 인수의 값은 구현에서 필드 및 메서드에 static 사용되지 않으며 일 수 있습니다 null.

필드의 설정이 필요한 경우 필드에 대한 접근자의 반환 값이 될 ref 수 있습니다.

생성자는 또는 Method을 사용하여 Constructor 액세스할 수 있습니다.

반환 형식은 서명 일치에 대해 고려됩니다. Modreqs 및 modopts는 처음에 서명 일치에 대해 고려되지 않습니다. 그러나 modreqs 및 modopts를 무시하는 모호성이 있으면 정확한 일치가 시도됩니다. 모호성이 여전히 있으면 AmbiguousMatchException 이 throw됩니다.

기본적으로 특성이 지정된 메서드의 이름은 메서드/필드의 이름을 지정합니다. C# 로컬 함수와 같은 언어 추상화가 IL 이름을 생성하기 때문에 경우에 따라 혼동을 일으킬 수 있습니다. 이에 대한 해결 방법은 메커니즘을 nameof 사용하고 속성을 정의하는 것입니다 Name .

생성자

UnsafeAccessorAttribute(UnsafeAccessorKind)

종류의 UnsafeAccessorKind멤버에 UnsafeAccessorAttribute 대한 제공 액세스를 인스턴스화합니다.

속성

Kind	액세스가 제공되는 멤버의 종류를 가져옵니다.
Name	액세스가 제공되는 멤버의 이름을 가져오거나 설정합니다.
TypeId	파생 클래스에서 구현된 경우 이 Attribute에 대한 고유 식별자를 가져옵니다. (다음에서 상속됨 Attribute)

메서드

Equals(Object)	이 인스턴스가 지정된 개체와 같은지를 나타내는 값을 반환합니다. (다음에서 상속됨 Attribute)
GetHashCode()	이 인스턴스의 해시 코드를 반환합니다. (다음에서 상속됨 Attribute)
GetType()	현재 인스턴스의 Type을 가져옵니다. (다음에서 상속됨 Object)
IsDefaultAttribute()	파생 클래스에서 재정의된 경우 이 인스턴스 값이 파생 클래스에 대한 기본값인지 여부를 표시합니다. (다음에서 상속됨 Attribute)
Match(Object)	파생 클래스에서 재정의된 경우 이 인스턴스가 지정된 개체와 같은지 여부를 나타내는 값을 반환합니다. (다음에서 상속됨 Attribute)
MemberwiseClone()	현재 Object의 단순 복사본을 만듭니다. (다음에서 상속됨 Object)
ToString()	현재 개체를 나타내는 문자열을 반환합니다. (다음에서 상속됨 Object)