Expand Minimize

OpCodes.Unbox_Any Field

Converts the boxed representation of a type specified in the instruction to its unboxed form.

Namespace:  System.Reflection.Emit
Assembly:  mscorlib (in mscorlib.dll)

public static readonly OpCode Unbox_Any

The following table lists the instruction's hexadecimal and Microsoft intermediate language (MSIL) assembly format, along with a brief reference summary:

Format

Assembly Format

Description

A5 < T >

unbox.any typeTok

Extract the data from obj, its boxed representation.

The stack transitional behavior, in sequential order, is:

  1. An object reference obj is pushed onto the stack.

  2. The object reference is popped from the stack and unboxed to the type specified in the instruction.

  3. The resulting object reference or value type is pushed onto the stack.

When applied to the boxed form of a value type, the unbox.any instruction extracts the value contained within obj (of type O), and is therefore equivalent to unbox followed by ldobj.

When applied to a reference type, the unbox.any instruction has the same effect as castclass  typeTok.

If the operand typeTok is a generic type parameter, then the runtime behavior is determined by the type that is specified for that generic type parameter.

InvalidCastException is thrown if obj is not a boxed type.

NullReferenceException is thrown if obj is a null reference.

The following Emit method overload can use the unbox.any opcode:

  • ILGenerator.Emit(OpCode, Type)

.NET Framework

Supported in: 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

.NET for Windows Store apps

Supported in: Windows 8

.NET for Windows Phone apps

Supported in: Windows Phone 8.1, Windows Phone Silverlight 8.1, Windows Phone Silverlight 8

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft