This documentation is archived and is not being maintained.

OpCodes.Ldtoken Field

Converts a metadata token to its runtime representation, pushing it onto the evaluation stack.

[Visual Basic]
Public Shared ReadOnly Ldtoken As OpCode
[C#]
public static readonly OpCode Ldtoken;
[C++]
public: static OpCode Ldtoken;
[JScript]
public static var Ldtoken : OpCode;

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
D0 < T > ldtoken token Converts a metadata token to its runtime representation.

The stack transitional behavior, in sequential order, is:

  1. The passed token is converted to a RuntimeHandle and pushed onto the stack.

The ldtoken instruction pushes a RuntimeHandle for the specified metadata token. A RuntimeHandle can be a fieldref/fielddef, a methodref/methoddef, or a typeref/typedef.

The value pushed on the stack can be used in calls to Reflection methods in the system class library.

For information on runtime handles, see the following classes: RuntimeFieldHandle, RuntimeTypeHandle, and RuntimeMethodHandle.

The following Emit constructor overloads can use the ldtoken opcode:

  • ILGenerator.Emit(OpCode, MethodInfo)
  • ILGenerator.Emit(OpCode, FieldInfo)
  • ILGenerator.Emit(OpCode, Type)

Requirements

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family

See Also

OpCodes Class | OpCodes Members | System.Reflection.Emit Namespace

Show: