MemoryMarshal.GetArrayDataReference Método

Definição

Namespace:

System.Runtime.InteropServices

Assembly:

System.Memory.dll

Sobrecargas

GetArrayDataReference(Array)	Retorna uma referência ao elemento 0 de array. Se a matriz estiver vazia, retornará uma referência ao local em que o elemento 0 teria sido armazenado. Essa referência pode ser usada para fixação, mas nunca deve ser desreferenciada.
GetArrayDataReference<T>(T[])	Retorna uma referência ao elemento 0 de array. Se a matriz estiver vazia, retornará uma referência ao local em que o elemento 0 teria sido armazenado. Essa referência pode ser usada para fixação, mas nunca deve ser desreferenciada.

GetArrayDataReference(Array)

Origem:

MemoryMarshal.CoreCLR.cs

Retorna uma referência ao elemento 0 de array. Se a matriz estiver vazia, retornará uma referência ao local em que o elemento 0 teria sido armazenado. Essa referência pode ser usada para fixação, mas nunca deve ser desreferenciada.

public:
 static System::Byte % GetArrayDataReference(Array ^ array);

public static ref byte GetArrayDataReference (Array array);

static member GetArrayDataReference : Array -> byte

Public Shared Function GetArrayDataReference (array As Array) As Byte

Parâmetros

array

Array

A matriz a ser analisada.

Retornos

Byte

Uma referência ao 0º elemento de array.

Exceções

NullReferenceException

array é null.

Comentários

O chamador deve reinterpretar manualmente o byte ref retornado como um ref para o tipo elemento subjacente da matriz, talvez utilizando uma API como System.Runtime.CompilerServices.Unsafe.As para ajudar na reinterpretação. Essa técnica não executa verificações de variação de matriz. O chamador deve executar manualmente todas as verificações de variação de matriz se o chamador quiser gravar na referência retornada.

GetArrayDataReference<T>(T[])

Origem:

MemoryMarshal.CoreCLR.cs

Retorna uma referência ao elemento 0 de array. Se a matriz estiver vazia, retornará uma referência ao local em que o elemento 0 teria sido armazenado. Essa referência pode ser usada para fixação, mas nunca deve ser desreferenciada.

public:
generic <typename T>
 static T % GetArrayDataReference(cli::array <T> ^ array);

public static ref T GetArrayDataReference<T> (T[] array);

static member GetArrayDataReference : 'T[] -> 'T

Public Shared Function GetArrayDataReference(Of T) (array As T()) As T

Parâmetros de tipo

T

O tipo dos elementos da matriz.

Parâmetros

array

T[]

A matriz a ser analisada.

Retornos

T

Referência ao 0º elemento em array.

Exceções

NullReferenceException

array é null.

Comentários

Esse método não executa verificações de variação de matriz. O chamador deve executar manualmente todas as verificações de variação de matriz se o chamador quiser gravar na referência retornada.