Compartilhar via


MemoryMarshal.GetArrayDataReference Método

Definição

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
Origem:
MemoryMarshal.CoreCLR.cs
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

Uma referência ao 0º elemento de array.

Exceções

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.

Aplica-se a

GetArrayDataReference<T>(T[])

Origem:
MemoryMarshal.CoreCLR.cs
Origem:
MemoryMarshal.CoreCLR.cs
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

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.

Aplica-se a