Unsafe.AsRef Метод

Определение

Пространство имен:

System.Runtime.CompilerServices

Сборка:

System.Runtime.CompilerServices.Unsafe.dll

Сборка:

System.Runtime.dll

Перегрузки

AsRef<T>(Void*)	Преобразует неуправляемый указатель в управляемый указатель в значение типа T.
AsRef<T>(T)	Повторно интерпретирует указанную ссылку только для чтения в качестве изменяемой ссылки.

AsRef<T>(Void*)

Важно!

Этот API несовместим с CLS.

Преобразует неуправляемый указатель в управляемый указатель в значение типа T.

public:
generic <typename T>
 static T % AsRef(void* source);

public static ref T AsRef<T> (void* source);

[System.CLSCompliant(false)]
public static ref T AsRef<T> (void* source);

static member AsRef : nativeptr<unit> -> 'T

[<System.CLSCompliant(false)>]
static member AsRef : nativeptr<unit> -> 'T

Параметры типа

T

Элементный тип управляемого указателя.

Параметры

source

Void*

Неуправляемый указатель для преобразования.

Возвращаемое значение

T

Управляемый указатель на значение типа T.

Атрибуты

CLSCompliantAttribute

Комментарии

Вызывающий объект отвечает за правильное выравнивание полученного управляемого указателя для указанного типа. Дополнительные сведения о требованиях к выравниванию см. в разделе ECMA-335, Sec. I.12.6.2 (Выравнивание).

AsRef<T>(T)

Повторно интерпретирует указанную ссылку только для чтения в качестве изменяемой ссылки.

public:
generic <typename T>
 static T % AsRef(T % source);

public static ref T AsRef<T> (scoped in T source);

static member AsRef : 'T -> 'T

Public Shared Function AsRef(Of T) (ByRef source As T) As T

Параметры типа

T

Базовый тип ссылки.

Параметры

source

T

Повторно интерпретируемая ссылка с доступом только для чтения.

Возвращаемое значение

T

Изменяемая ссылка на значение типа T.

Комментарии

Этот API концептуально похож на C++ const_cast<>. Это ответственность вызывающего объекта, чтобы гарантировать, что данные не записываются в указанное расположение. Среда выполнения содержит внутреннюю логику, определяемую предположением о том, что ссылки только для чтения являются неизменяемыми, и вызывающие лица, которые нарушают эту инвариантную функцию, могут вызвать неопределенное поведение в среде выполнения.

AsRef обычно используется для передачи ссылки на чтение в такие методы, как Addметоды, которые принимают изменяемые управляемые указатели в качестве аргументов. Рассмотрим следующий пример.

int ComputeSumOfElements(ref int refToFirstElement, nint numElements)
{
  int sum = 0;
  for (nint i = 0; i < numElements; i++)
  {
    sum += Unsafe.Add(ref refToFirstElement, i);
  }
}

Если входной параметр не ref int refToFirstElementявляетсяref readonly int refToFirstElement, предыдущий пример не будет компилироваться, так как ссылки только для чтения не могут использоваться в качестве аргументовAdd. Вместо этого AsRef можно использовать для удаления ограничения неизменяемости и обеспечения успешной компиляции, как показано в следующем примере.

int ComputeSumOfElements(ref readonly int refToFirstElement, nint numElements)
{
  int sum = 0;
  for (nint i = 0; i < numElements; i++)
  {
    sum += Unsafe.Add(ref Unsafe.AsRef(ref refToFirstElement), i);
  }
}