OpCodes.Mkrefany Field

Definition

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

public static readonly System.Reflection.Emit.OpCode Mkrefany;

Field Value

Remarks

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:

Applies to

Product Versions
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0