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.

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

public static readonly OpCode Ldtoken

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 method overloads can use the ldtoken opcode:

  • ILGenerator.Emit(OpCode, MethodInfo)

  • ILGenerator.Emit(OpCode, FieldInfo)

  • ILGenerator.Emit(OpCode, Type)

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

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