Idioma

Unsafe.Unbox<T>(Object) Método

Definição

Namespace:
System.Runtime.CompilerServices
Assembly:
System.Runtime.dll
Assembly:
System.Runtime.CompilerServices.Unsafe.dll
Assemblies:
System.Runtime.dll, System.Runtime.CompilerServices.Unsafe.dll
Origem:
Unsafe.cs
Origem:
Unsafe.cs
Origem:
Unsafe.cs
Origem:
Unsafe.cs
Origem:
Unsafe.cs

Retorna um mutable ref valor em caixa.

public:
generic <typename T>
 where T : value class static T % Unbox(System::Object ^ box);
public static ref T Unbox<T>(object box) where T : struct;
static member Unbox : obj -> 'T (requires 'T : struct)
Public Shared Function Unbox(Of T As Structure) (box As Object) As T

Parâmetros de tipo

T

O tipo a ser desamarmado.

Parâmetros

box
Object

O valor a ser desconstalado.

Retornos

T

Um mutable ref para o valor boxem caixa.

Exceções

NullReferenceException

box é null, e T é um tipo de valor não anulável.

InvalidCastException

box não é um tipo de valor em caixa.

- ou -

box não é um boxed T.

TypeLoadException

T não pode ser encontrado.

Comentários

O Unbox<T> método é simplesmente um wrapper para a instrução il unbox . É útil como uma otimização de desempenho. Sempre que uma API que usa uma Object precisa ser chamada repetidamente com valores diferentes de um tipo de valor, o mesmo objeto de caixa pode ser reutilizado em vez de um novo criado a cada vez.

O Unbox<T> método tem uma restrição de uso importante que não é imposta por compiladores de idiomas e essa é a responsabilidade do chamador. A instrução IL unbox retorna um ponteiro gerenciado de mutabilidade controlada. Como os compiladores de linguagem .NET e .NET não podem representar essa restrição, o método Unbox<T> retorna um ref T normal mutável. No entanto, os desenvolvedores não devem alterar a referência retornada, a menos que estejam certos de que T é um tipo de struct mutável. Por exemplo, como os primitivos numéricos, como Int32 não são tipos de struct mutáveis, o código a seguir não é suppported:

// The following line is NOT SUPPORTED.
Unsafe.Unbox<int>(obj) = 30;

Por outro lado, há suporte para um tipo como Point um struct mutável com setters de propriedade pública, portanto, é possível alterar o valor em caixa chamando os setters de propriedade:

// The following lines are legal and supported.
Unsafe.Unbox<System.Drawing.Point>(obj).X = 50;
Unsafe.Unbox<System.Drawing.Point>(obj).Y = 70;

No entanto, não há suporte para substituir todo o atacado de referência, mesmo que a referência seja para um tipo de struct mutável.

// Resetting the reference to default(T) is NOT SUPPORTED.
Unsafe.Unbox<System.Drawing.Point>(obj) = default(System.Drawing.Point);

// Setting the reference to a completely new value is NOT SUPPORTED.
Unsafe.Unbox<System.Drawing.Point>(obj) = new System.Drawing.Point(50, 70);

Para obter mais informações, incluindo a discussão detalhada sobre as restrições de uso desta instrução, consulte as seções III.1.8.1.2.2 ("Ponteiros gerenciados de mutabilidade controlada") e III.4.32 ("unbox -- converter tipo de valor em caixa em sua forma bruta") no ECMA-335: Common Language Infrastructure (CLI).

Aplica-se a