Expand Minimize

OpCodes.Mkrefany Field

Pushes a typed reference to an instance of a specific type onto the evaluation stack.

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

public static readonly OpCode Mkrefany

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

C6 < T >

mkrefany class

Pushes a typed reference of type class onto the stack.

The stack transitional behavior, in sequential order, is:

  1. A pointer to piece of data is pushed onto the stack.

  2. The pointer is popped and converted to a typed reference of type class.

  3. The typed reference is pushed onto the stack.

The mkrefany instruction supports the passing of dynamically typed references. The pointer must be of type &, *, or native int, and hold the valid address of a piece of data. Class is the class token describing the type of the data referenced by the pointer. Mkrefany pushes a typed reference on the stack, providing an opaque descriptor of the pointer and the type class.

The only valid operation permitted upon a typed reference is to pass it to a method that requires a typed reference as a parameter. The callee can then use the Refanytype and Refanyval instructions to retrieve the type (class) and the address respectively.

TypeLoadException is thrown if class cannot be found. This is typically detected when Microsoft Intermediate Language (MSIL) instructions are converted to native code rather than at runtime.

The following Emit method overload can use the mkrefany opcode:

  • ILGenerator.Emit(OpCode, Type)

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

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

.NET Framework

Supported in: 3.5, 3.0, 2.0, 1.1, 1.0
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft