OpCodes Class (System.Reflection.Emit)

Switch View :
ScriptFree
.NET Framework Class Library
OpCodes Class

Provides field representations of the Microsoft Intermediate Language (MSIL) instructions for emission by the ILGenerator class members (such as Emit).

Inheritance Hierarchy

System.Object
  System.Reflection.Emit.OpCodes

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

Visual Basic
<ComVisibleAttribute(True)> _
Public Class OpCodes
C#
[ComVisibleAttribute(true)]
public class OpCodes
Visual C++
[ComVisibleAttribute(true)]
public ref class OpCodes
F#
[<ComVisibleAttribute(true)>]
type OpCodes =  class end

The OpCodes type exposes the following members.

Methods

  Name Description
Public method Equals(Object) Determines whether the specified Object is equal to the current Object. (Inherited from Object.)
Protected method Finalize Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
Public method GetHashCode Serves as a hash function for a particular type. (Inherited from Object.)
Public method GetType Gets the Type of the current instance. (Inherited from Object.)
Protected method MemberwiseClone Creates a shallow copy of the current Object. (Inherited from Object.)
Public method Static member TakesSingleByteArgument Returns true or false if the supplied opcode takes a single byte argument.
Public method ToString Returns a string that represents the current object. (Inherited from Object.)
Top
Fields

  Name Description
Public field Static member Add Adds two values and pushes the result onto the evaluation stack.
Public field Static member Add_Ovf Adds two integers, performs an overflow check, and pushes the result onto the evaluation stack.
Public field Static member Add_Ovf_Un Adds two unsigned integer values, performs an overflow check, and pushes the result onto the evaluation stack.
Public field Static member And Computes the bitwise AND of two values and pushes the result onto the evaluation stack.
Public field Static member Arglist Returns an unmanaged pointer to the argument list of the current method.
Public field Static member Beq Transfers control to a target instruction if two values are equal.
Public field Static member Beq_S Transfers control to a target instruction (short form) if two values are equal.
Public field Static member Bge Transfers control to a target instruction if the first value is greater than or equal to the second value.
Public field Static member Bge_S Transfers control to a target instruction (short form) if the first value is greater than or equal to the second value.
Public field Static member Bge_Un Transfers control to a target instruction if the first value is greater than the second value, when comparing unsigned integer values or unordered float values.
Public field Static member Bge_Un_S Transfers control to a target instruction (short form) if the first value is greater than the second value, when comparing unsigned integer values or unordered float values.
Public field Static member Bgt Transfers control to a target instruction if the first value is greater than the second value.
Public field Static member Bgt_S Transfers control to a target instruction (short form) if the first value is greater than the second value.
Public field Static member Bgt_Un Transfers control to a target instruction if the first value is greater than the second value, when comparing unsigned integer values or unordered float values.
Public field Static member Bgt_Un_S Transfers control to a target instruction (short form) if the first value is greater than the second value, when comparing unsigned integer values or unordered float values.
Public field Static member Ble Transfers control to a target instruction if the first value is less than or equal to the second value.
Public field Static member Ble_S Transfers control to a target instruction (short form) if the first value is less than or equal to the second value.
Public field Static member Ble_Un Transfers control to a target instruction if the first value is less than or equal to the second value, when comparing unsigned integer values or unordered float values.
Public field Static member Ble_Un_S Transfers control to a target instruction (short form) if the first value is less than or equal to the second value, when comparing unsigned integer values or unordered float values.
Public field Static member Blt Transfers control to a target instruction if the first value is less than the second value.
Public field Static member Blt_S Transfers control to a target instruction (short form) if the first value is less than the second value.
Public field Static member Blt_Un Transfers control to a target instruction if the first value is less than the second value, when comparing unsigned integer values or unordered float values.
Public field Static member Blt_Un_S Transfers control to a target instruction (short form) if the first value is less than the second value, when comparing unsigned integer values or unordered float values.
Public field Static member Bne_Un Transfers control to a target instruction when two unsigned integer values or unordered float values are not equal.
Public field Static member Bne_Un_S Transfers control to a target instruction (short form) when two unsigned integer values or unordered float values are not equal.
Public field Static member Box Converts a value type to an object reference (type O).
Public field Static member Br Unconditionally transfers control to a target instruction.
Public field Static member Br_S Unconditionally transfers control to a target instruction (short form).
Public field Static member Break Signals the Common Language Infrastructure (CLI) to inform the debugger that a break point has been tripped.
Public field Static member Brfalse Transfers control to a target instruction if value is false, a null reference (Nothing in Visual Basic), or zero.
Public field Static member Brfalse_S Transfers control to a target instruction if value is false, a null reference, or zero.
Public field Static member Brtrue Transfers control to a target instruction if value is true, not null, or non-zero.
Public field Static member Brtrue_S Transfers control to a target instruction (short form) if value is true, not null, or non-zero.
Public field Static member Call Calls the method indicated by the passed method descriptor.
Public field Static member Calli Calls the method indicated on the evaluation stack (as a pointer to an entry point) with arguments described by a calling convention.
Public field Static member Callvirt Calls a late-bound method on an object, pushing the return value onto the evaluation stack.
Public field Static member Castclass Attempts to cast an object passed by reference to the specified class.
Public field Static member Ceq Compares two values. If they are equal, the integer value 1 (int32) is pushed onto the evaluation stack; otherwise 0 (int32) is pushed onto the evaluation stack.
Public field Static member Cgt Compares two values. If the first value is greater than the second, the integer value 1 (int32) is pushed onto the evaluation stack; otherwise 0 (int32) is pushed onto the evaluation stack.
Public field Static member Cgt_Un Compares two unsigned or unordered values. If the first value is greater than the second, the integer value 1 (int32) is pushed onto the evaluation stack; otherwise 0 (int32) is pushed onto the evaluation stack.
Public field Static member Ckfinite Throws ArithmeticException if value is not a finite number.
Public field Static member Clt Compares two values. If the first value is less than the second, the integer value 1 (int32) is pushed onto the evaluation stack; otherwise 0 (int32) is pushed onto the evaluation stack.
Public field Static member Clt_Un Compares the unsigned or unordered values value1 and value2. If value1 is less than value2, then the integer value 1 (int32) is pushed onto the evaluation stack; otherwise 0 (int32) is pushed onto the evaluation stack.
Public field Static member Constrained Constrains the type on which a virtual method call is made.
Public field Static member Conv_I Converts the value on top of the evaluation stack to native int.
Public field Static member Conv_I1 Converts the value on top of the evaluation stack to int8, then extends (pads) it to int32.
Public field Static member Conv_I2 Converts the value on top of the evaluation stack to int16, then extends (pads) it to int32.
Public field Static member Conv_I4 Converts the value on top of the evaluation stack to int32.
Public field Static member Conv_I8 Converts the value on top of the evaluation stack to int64.
Public field Static member Conv_Ovf_I Converts the signed value on top of the evaluation stack to signed native int, throwing OverflowException on overflow.
Public field Static member Conv_Ovf_I_Un Converts the unsigned value on top of the evaluation stack to signed native int, throwing OverflowException on overflow.
Public field Static member Conv_Ovf_I1 Converts the signed value on top of the evaluation stack to signed int8 and extends it to int32, throwing OverflowException on overflow.
Public field Static member Conv_Ovf_I1_Un Converts the unsigned value on top of the evaluation stack to signed int8 and extends it to int32, throwing OverflowException on overflow.
Public field Static member Conv_Ovf_I2 Converts the signed value on top of the evaluation stack to signed int16 and extending it to int32, throwing OverflowException on overflow.
Public field Static member Conv_Ovf_I2_Un Converts the unsigned value on top of the evaluation stack to signed int16 and extends it to int32, throwing OverflowException on overflow.
Public field Static member Conv_Ovf_I4 Converts the signed value on top of the evaluation stack to signed int32, throwing OverflowException on overflow.
Public field Static member Conv_Ovf_I4_Un Converts the unsigned value on top of the evaluation stack to signed int32, throwing OverflowException on overflow.
Public field Static member Conv_Ovf_I8 Converts the signed value on top of the evaluation stack to signed int64, throwing OverflowException on overflow.
Public field Static member Conv_Ovf_I8_Un Converts the unsigned value on top of the evaluation stack to signed int64, throwing OverflowException on overflow.
Public field Static member Conv_Ovf_U Converts the signed value on top of the evaluation stack to unsigned native int, throwing OverflowException on overflow.
Public field Static member Conv_Ovf_U_Un Converts the unsigned value on top of the evaluation stack to unsigned native int, throwing OverflowException on overflow.
Public field Static member Conv_Ovf_U1 Converts the signed value on top of the evaluation stack to unsigned int8 and extends it to int32, throwing OverflowException on overflow.
Public field Static member Conv_Ovf_U1_Un Converts the unsigned value on top of the evaluation stack to unsigned int8 and extends it to int32, throwing OverflowException on overflow.
Public field Static member Conv_Ovf_U2 Converts the signed value on top of the evaluation stack to unsigned int16 and extends it to int32, throwing OverflowException on overflow.
Public field Static member Conv_Ovf_U2_Un Converts the unsigned value on top of the evaluation stack to unsigned int16 and extends it to int32, throwing OverflowException on overflow.
Public field Static member Conv_Ovf_U4 Converts the signed value on top of the evaluation stack to unsigned int32, throwing OverflowException on overflow.
Public field Static member Conv_Ovf_U4_Un Converts the unsigned value on top of the evaluation stack to unsigned int32, throwing OverflowException on overflow.
Public field Static member Conv_Ovf_U8 Converts the signed value on top of the evaluation stack to unsigned int64, throwing OverflowException on overflow.
Public field Static member Conv_Ovf_U8_Un Converts the unsigned value on top of the evaluation stack to unsigned int64, throwing OverflowException on overflow.
Public field Static member Conv_R_Un Converts the unsigned integer value on top of the evaluation stack to float32.
Public field Static member Conv_R4 Converts the value on top of the evaluation stack to float32.
Public field Static member Conv_R8 Converts the value on top of the evaluation stack to float64.
Public field Static member Conv_U Converts the value on top of the evaluation stack to unsigned native int, and extends it to native int.
Public field Static member Conv_U1 Converts the value on top of the evaluation stack to unsigned int8, and extends it to int32.
Public field Static member Conv_U2 Converts the value on top of the evaluation stack to unsigned int16, and extends it to int32.
Public field Static member Conv_U4 Converts the value on top of the evaluation stack to unsigned int32, and extends it to int32.
Public field Static member Conv_U8 Converts the value on top of the evaluation stack to unsigned int64, and extends it to int64.
Public field Static member Cpblk Copies a specified number bytes from a source address to a destination address.
Public field Static member Cpobj Copies the value type located at the address of an object (type &, * or native int) to the address of the destination object (type &, * or native int).
Public field Static member Div Divides two values and pushes the result as a floating-point (type F) or quotient (type int32) onto the evaluation stack.
Public field Static member Div_Un Divides two unsigned integer values and pushes the result (int32) onto the evaluation stack.
Public field Static member Dup Copies the current topmost value on the evaluation stack, and then pushes the copy onto the evaluation stack.
Public field Static member Endfilter Transfers control from the filter clause of an exception back to the Common Language Infrastructure (CLI) exception handler.
Public field Static member Endfinally Transfers control from the fault or finally clause of an exception block back to the Common Language Infrastructure (CLI) exception handler.
Public field Static member Initblk Initializes a specified block of memory at a specific address to a given size and initial value.
Public field Static member Initobj Initializes each field of the value type at a specified address to a null reference or a 0 of the appropriate primitive type.
Public field Static member Isinst Tests whether an object reference (type O) is an instance of a particular class.
Public field Static member Jmp Exits current method and jumps to specified method.
Public field Static member Ldarg Loads an argument (referenced by a specified index value) onto the stack.
Public field Static member Ldarg_0 Loads the argument at index 0 onto the evaluation stack.
Public field Static member Ldarg_1 Loads the argument at index 1 onto the evaluation stack.
Public field Static member Ldarg_2 Loads the argument at index 2 onto the evaluation stack.
Public field Static member Ldarg_3 Loads the argument at index 3 onto the evaluation stack.
Public field Static member Ldarg_S Loads the argument (referenced by a specified short form index) onto the evaluation stack.
Public field Static member Ldarga Load an argument address onto the evaluation stack.
Public field Static member Ldarga_S Load an argument address, in short form, onto the evaluation stack.
Public field Static member Ldc_I4 Pushes a supplied value of type int32 onto the evaluation stack as an int32.
Public field Static member Ldc_I4_0 Pushes the integer value of 0 onto the evaluation stack as an int32.
Public field Static member Ldc_I4_1 Pushes the integer value of 1 onto the evaluation stack as an int32.
Public field Static member Ldc_I4_2 Pushes the integer value of 2 onto the evaluation stack as an int32.
Public field Static member Ldc_I4_3 Pushes the integer value of 3 onto the evaluation stack as an int32.
Public field Static member Ldc_I4_4 Pushes the integer value of 4 onto the evaluation stack as an int32.
Public field Static member Ldc_I4_5 Pushes the integer value of 5 onto the evaluation stack as an int32.
Public field Static member Ldc_I4_6 Pushes the integer value of 6 onto the evaluation stack as an int32.
Public field Static member Ldc_I4_7 Pushes the integer value of 7 onto the evaluation stack as an int32.
Public field Static member Ldc_I4_8 Pushes the integer value of 8 onto the evaluation stack as an int32.
Public field Static member Ldc_I4_M1 Pushes the integer value of -1 onto the evaluation stack as an int32.
Public field Static member Ldc_I4_S Pushes the supplied int8 value onto the evaluation stack as an int32, short form.
Public field Static member Ldc_I8 Pushes a supplied value of type int64 onto the evaluation stack as an int64.
Public field Static member Ldc_R4 Pushes a supplied value of type float32 onto the evaluation stack as type F (float).
Public field Static member Ldc_R8 Pushes a supplied value of type float64 onto the evaluation stack as type F (float).
Public field Static member Ldelem Loads the element at a specified array index onto the top of the evaluation stack as the type specified in the instruction.
Public field Static member Ldelem_I Loads the element with type native int at a specified array index onto the top of the evaluation stack as a native int.
Public field Static member Ldelem_I1 Loads the element with type int8 at a specified array index onto the top of the evaluation stack as an int32.
Public field Static member Ldelem_I2 Loads the element with type int16 at a specified array index onto the top of the evaluation stack as an int32.
Public field Static member Ldelem_I4 Loads the element with type int32 at a specified array index onto the top of the evaluation stack as an int32.
Public field Static member Ldelem_I8 Loads the element with type int64 at a specified array index onto the top of the evaluation stack as an int64.
Public field Static member Ldelem_R4 Loads the element with type float32 at a specified array index onto the top of the evaluation stack as type F (float).
Public field Static member Ldelem_R8 Loads the element with type float64 at a specified array index onto the top of the evaluation stack as type F (float).
Public field Static member Ldelem_Ref Loads the element containing an object reference at a specified array index onto the top of the evaluation stack as type O (object reference).
Public field Static member Ldelem_U1 Loads the element with type unsigned int8 at a specified array index onto the top of the evaluation stack as an int32.
Public field Static member Ldelem_U2 Loads the element with type unsigned int16 at a specified array index onto the top of the evaluation stack as an int32.
Public field Static member Ldelem_U4 Loads the element with type unsigned int32 at a specified array index onto the top of the evaluation stack as an int32.
Public field Static member Ldelema Loads the address of the array element at a specified array index onto the top of the evaluation stack as type & (managed pointer).
Public field Static member Ldfld Finds the value of a field in the object whose reference is currently on the evaluation stack.
Public field Static member Ldflda Finds the address of a field in the object whose reference is currently on the evaluation stack.
Public field Static member Ldftn Pushes an unmanaged pointer (type native int) to the native code implementing a specific method onto the evaluation stack.
Public field Static member Ldind_I Loads a value of type native int as a native int onto the evaluation stack indirectly.
Public field Static member Ldind_I1 Loads a value of type int8 as an int32 onto the evaluation stack indirectly.
Public field Static member Ldind_I2 Loads a value of type int16 as an int32 onto the evaluation stack indirectly.
Public field Static member Ldind_I4 Loads a value of type int32 as an int32 onto the evaluation stack indirectly.
Public field Static member Ldind_I8 Loads a value of type int64 as an int64 onto the evaluation stack indirectly.
Public field Static member Ldind_R4 Loads a value of type float32 as a type F (float) onto the evaluation stack indirectly.
Public field Static member Ldind_R8 Loads a value of type float64 as a type F (float) onto the evaluation stack indirectly.
Public field Static member Ldind_Ref Loads an object reference as a type O (object reference) onto the evaluation stack indirectly.
Public field Static member Ldind_U1 Loads a value of type unsigned int8 as an int32 onto the evaluation stack indirectly.
Public field Static member Ldind_U2 Loads a value of type unsigned int16 as an int32 onto the evaluation stack indirectly.
Public field Static member Ldind_U4 Loads a value of type unsigned int32 as an int32 onto the evaluation stack indirectly.
Public field Static member Ldlen Pushes the number of elements of a zero-based, one-dimensional array onto the evaluation stack.
Public field Static member Ldloc Loads the local variable at a specific index onto the evaluation stack.
Public field Static member Ldloc_0 Loads the local variable at index 0 onto the evaluation stack.
Public field Static member Ldloc_1 Loads the local variable at index 1 onto the evaluation stack.
Public field Static member Ldloc_2 Loads the local variable at index 2 onto the evaluation stack.
Public field Static member Ldloc_3 Loads the local variable at index 3 onto the evaluation stack.
Public field Static member Ldloc_S Loads the local variable at a specific index onto the evaluation stack, short form.
Public field Static member Ldloca Loads the address of the local variable at a specific index onto the evaluation stack.
Public field Static member Ldloca_S Loads the address of the local variable at a specific index onto the evaluation stack, short form.
Public field Static member Ldnull Pushes a null reference (type O) onto the evaluation stack.
Public field Static member Ldobj Copies the value type object pointed to by an address to the top of the evaluation stack.
Public field Static member Ldsfld Pushes the value of a static field onto the evaluation stack.
Public field Static member Ldsflda Pushes the address of a static field onto the evaluation stack.
Public field Static member Ldstr Pushes a new object reference to a string literal stored in the metadata.
Public field Static member Ldtoken Converts a metadata token to its runtime representation, pushing it onto the evaluation stack.
Public field Static member Ldvirtftn Pushes an unmanaged pointer (type native int) to the native code implementing a particular virtual method associated with a specified object onto the evaluation stack.
Public field Static member Leave Exits a protected region of code, unconditionally transferring control to a specific target instruction.
Public field Static member Leave_S Exits a protected region of code, unconditionally transferring control to a target instruction (short form).
Public field Static member Localloc Allocates a certain number of bytes from the local dynamic memory pool and pushes the address (a transient pointer, type *) of the first allocated byte onto the evaluation stack.
Public field Static member Mkrefany Pushes a typed reference to an instance of a specific type onto the evaluation stack.
Public field Static member Mul Multiplies two values and pushes the result on the evaluation stack.
Public field Static member Mul_Ovf Multiplies two integer values, performs an overflow check, and pushes the result onto the evaluation stack.
Public field Static member Mul_Ovf_Un Multiplies two unsigned integer values, performs an overflow check, and pushes the result onto the evaluation stack.
Public field Static member Neg Negates a value and pushes the result onto the evaluation stack.
Public field Static member Newarr Pushes an object reference to a new zero-based, one-dimensional array whose elements are of a specific type onto the evaluation stack.
Public field Static member Newobj Creates a new object or a new instance of a value type, pushing an object reference (type O) onto the evaluation stack.
Public field Static member Nop Fills space if opcodes are patched. No meaningful operation is performed although a processing cycle can be consumed.
Public field Static member Not Computes the bitwise complement of the integer value on top of the stack and pushes the result onto the evaluation stack as the same type.
Public field Static member Or Compute the bitwise complement of the two integer values on top of the stack and pushes the result onto the evaluation stack.
Public field Static member Pop Removes the value currently on top of the evaluation stack.
Public field Static member Prefix1 Infrastructure. This is a reserved instruction.
Public field Static member Prefix2 Infrastructure. This is a reserved instruction.
Public field Static member Prefix3 Infrastructure. This is a reserved instruction.
Public field Static member Prefix4 Infrastructure. This is a reserved instruction.
Public field Static member Prefix5 Infrastructure. This is a reserved instruction.
Public field Static member Prefix6 Infrastructure. This is a reserved instruction.
Public field Static member Prefix7 Infrastructure. This is a reserved instruction.
Public field Static member Prefixref Infrastructure. This is a reserved instruction.
Public field Static member Readonly Specifies that the subsequent array address operation performs no type check at run time, and that it returns a managed pointer whose mutability is restricted.
Public field Static member Refanytype Retrieves the type token embedded in a typed reference.
Public field Static member Refanyval Retrieves the address (type &) embedded in a typed reference.
Public field Static member Rem Divides two values and pushes the remainder onto the evaluation stack.
Public field Static member Rem_Un Divides two unsigned values and pushes the remainder onto the evaluation stack.
Public field Static member Ret Returns from the current method, pushing a return value (if present) from the callee's evaluation stack onto the caller's evaluation stack.
Public field Static member Rethrow Rethrows the current exception.
Public field Static member Shl Shifts an integer value to the left (in zeroes) by a specified number of bits, pushing the result onto the evaluation stack.
Public field Static member Shr Shifts an integer value (in sign) to the right by a specified number of bits, pushing the result onto the evaluation stack.
Public field Static member Shr_Un Shifts an unsigned integer value (in zeroes) to the right by a specified number of bits, pushing the result onto the evaluation stack.
Public field Static member Sizeof Pushes the size, in bytes, of a supplied value type onto the evaluation stack.
Public field Static member Starg Stores the value on top of the evaluation stack in the argument slot at a specified index.
Public field Static member Starg_S Stores the value on top of the evaluation stack in the argument slot at a specified index, short form.
Public field Static member Stelem Replaces the array element at a given index with the value on the evaluation stack, whose type is specified in the instruction.
Public field Static member Stelem_I Replaces the array element at a given index with the native int value on the evaluation stack.
Public field Static member Stelem_I1 Replaces the array element at a given index with the int8 value on the evaluation stack.
Public field Static member Stelem_I2 Replaces the array element at a given index with the int16 value on the evaluation stack.
Public field Static member Stelem_I4 Replaces the array element at a given index with the int32 value on the evaluation stack.
Public field Static member Stelem_I8 Replaces the array element at a given index with the int64 value on the evaluation stack.
Public field Static member Stelem_R4 Replaces the array element at a given index with the float32 value on the evaluation stack.
Public field Static member Stelem_R8 Replaces the array element at a given index with the float64 value on the evaluation stack.
Public field Static member Stelem_Ref Replaces the array element at a given index with the object ref value (type O) on the evaluation stack.
Public field Static member Stfld Replaces the value stored in the field of an object reference or pointer with a new value.
Public field Static member Stind_I Stores a value of type native int at a supplied address.
Public field Static member Stind_I1 Stores a value of type int8 at a supplied address.
Public field Static member Stind_I2 Stores a value of type int16 at a supplied address.
Public field Static member Stind_I4 Stores a value of type int32 at a supplied address.
Public field Static member Stind_I8 Stores a value of type int64 at a supplied address.
Public field Static member Stind_R4 Stores a value of type float32 at a supplied address.
Public field Static member Stind_R8 Stores a value of type float64 at a supplied address.
Public field Static member Stind_Ref Stores a object reference value at a supplied address.
Public field Static member Stloc Pops the current value from the top of the evaluation stack and stores it in a the local variable list at a specified index.
Public field Static member Stloc_0 Pops the current value from the top of the evaluation stack and stores it in a the local variable list at index 0.
Public field Static member Stloc_1 Pops the current value from the top of the evaluation stack and stores it in a the local variable list at index 1.
Public field Static member Stloc_2 Pops the current value from the top of the evaluation stack and stores it in a the local variable list at index 2.
Public field Static member Stloc_3 Pops the current value from the top of the evaluation stack and stores it in a the local variable list at index 3.
Public field Static member Stloc_S Pops the current value from the top of the evaluation stack and stores it in a the local variable list at index (short form).
Public field Static member Stobj Copies a value of a specified type from the evaluation stack into a supplied memory address.
Public field Static member Stsfld Replaces the value of a static field with a value from the evaluation stack.
Public field Static member Sub Subtracts one value from another and pushes the result onto the evaluation stack.
Public field Static member Sub_Ovf Subtracts one integer value from another, performs an overflow check, and pushes the result onto the evaluation stack.
Public field Static member Sub_Ovf_Un Subtracts one unsigned integer value from another, performs an overflow check, and pushes the result onto the evaluation stack.
Public field Static member Switch Implements a jump table.
Public field Static member Tailcall Performs a postfixed method call instruction such that the current method's stack frame is removed before the actual call instruction is executed.
Public field Static member Throw Throws the exception object currently on the evaluation stack.
Public field Static member Unaligned Indicates that an address currently atop the evaluation stack might not be aligned to the natural size of the immediately following ldind, stind, ldfld, stfld, ldobj, stobj, initblk, or cpblk instruction.
Public field Static member Unbox Converts the boxed representation of a value type to its unboxed form.
Public field Static member Unbox_Any Converts the boxed representation of a type specified in the instruction to its unboxed form.
Public field Static member Volatile Specifies that an address currently atop the evaluation stack might be volatile, and the results of reading that location cannot be cached or that multiple stores to that location cannot be suppressed.
Public field Static member Xor Computes the bitwise XOR of the top two values on the evaluation stack, pushing the result onto the evaluation stack.
Top
Remarks

For a detailed description of the member opcodes, see the Common Language Infrastructure (CLI) documentation, especially "Partition III: CIL Instruction Set" and "Partition II: Metadata Definition and Semantics". The documentation is available online; see ECMA C# and Common Language Infrastructure Standards on MSDN and Standard ECMA-335 - Common Language Infrastructure (CLI) on the Ecma International Web site.

Examples

The following example demonstrates the construction of a dynamic method using ILGenerator to emit OpCodes into a MethodBuilder.

Visual Basic


Imports System
Imports System.Threading
Imports System.Reflection
Imports System.Reflection.Emit

 _

Class EmitWriteLineDemo


   Public Shared Function CreateDynamicType() As Type

      Dim ctorParams() As Type = {GetType(Integer), GetType(Integer)}

      Dim myDomain As AppDomain = Thread.GetDomain()
      Dim myAsmName As New AssemblyName()
      myAsmName.Name = "MyDynamicAssembly"

      Dim myAsmBuilder As AssemblyBuilder = myDomain.DefineDynamicAssembly(myAsmName, AssemblyBuilderAccess.RunAndSave)

      Dim pointModule As ModuleBuilder = myAsmBuilder.DefineDynamicModule("PointModule", "Point.dll")

      Dim pointTypeBld As TypeBuilder = pointModule.DefineType("Point", _
							       TypeAttributes.Public)

      Dim xField As FieldBuilder = pointTypeBld.DefineField("x", _
							    GetType(Integer), _
							    FieldAttributes.Public)
      Dim yField As FieldBuilder = pointTypeBld.DefineField("y", _
							    GetType(Integer), _
						 	    FieldAttributes.Public)


      Dim objType As Type = Type.GetType("System.Object")
      Dim objCtor As ConstructorInfo = objType.GetConstructor(New Type(){})

      Dim pointCtor As ConstructorBuilder = pointTypeBld.DefineConstructor( _
							 MethodAttributes.Public, _
							 CallingConventions.Standard, _
							 ctorParams)
      Dim ctorIL As ILGenerator = pointCtor.GetILGenerator()


      ' First, you build the constructor.

      ctorIL.Emit(OpCodes.Ldarg_0)
      ctorIL.Emit(OpCodes.Call, objCtor)
      ctorIL.Emit(OpCodes.Ldarg_0)
      ctorIL.Emit(OpCodes.Ldarg_1)
      ctorIL.Emit(OpCodes.Stfld, xField)
      ctorIL.Emit(OpCodes.Ldarg_0)
      ctorIL.Emit(OpCodes.Ldarg_2)
      ctorIL.Emit(OpCodes.Stfld, yField)
      ctorIL.Emit(OpCodes.Ret)

      '  Now, you'll build a method to output some information on the
      ' inside your dynamic class. This method will have the following
      ' definition in C#:
      '  Public Sub WritePoint() 

      Dim writeStrMthd As MethodBuilder = pointTypeBld.DefineMethod("WritePoint", _
								    MethodAttributes.Public, _
								    Nothing, Nothing)

      Dim writeStrIL As ILGenerator = writeStrMthd.GetILGenerator()

      ' The below ILGenerator created demonstrates a few ways to create
      ' string output through STDIN. 
      ' ILGenerator.EmitWriteLine(string) will generate a ldstr and a 
      ' call to WriteLine for you.

      writeStrIL.EmitWriteLine("The value of this current instance is:")

      ' Here, you will do the hard work yourself. First, you need to create
      ' the string we will be passing and obtain the correct WriteLine overload
      ' for said string. In the below case, you are substituting in two values,
      ' so the chosen overload is Console.WriteLine(string, object, object).

      Dim inStr As [String] = "({0}, {1})"
      Dim wlParams() As Type = {GetType(String), GetType(Object), GetType(Object)}

      ' We need the MethodInfo to pass into EmitCall later.

      Dim writeLineMI As MethodInfo = GetType(Console).GetMethod("WriteLine", wlParams)

      ' Push the string with the substitutions onto the stack.
      ' This is the first argument for WriteLine - the string one. 

      writeStrIL.Emit(OpCodes.Ldstr, inStr)

      ' Since the second argument is an object, and it corresponds to
      ' to the substitution for the value of our integer field, you 
      ' need to box that field to an object. First, push a reference
      ' to the current instance, and then push the value stored in
      ' field 'x'. We need the reference to the current instance (stored
      ' in local argument index 0) so Ldfld can load from the correct
      ' instance (this one).

      writeStrIL.Emit(OpCodes.Ldarg_0)
      writeStrIL.Emit(OpCodes.Ldfld, xField)

      ' Now, we execute the box opcode, which pops the value of field 'x',
      ' returning a reference to the integer value boxed as an object.

      writeStrIL.Emit(OpCodes.Box, GetType(Integer))

      ' Atop the stack, you'll find our string inStr, followed by a reference
      ' to the boxed value of 'x'. Now, you need to likewise box field 'y'.

      writeStrIL.Emit(OpCodes.Ldarg_0)
      writeStrIL.Emit(OpCodes.Ldfld, yField)
      writeStrIL.Emit(OpCodes.Box, GetType(Integer))

      ' Now, you have all of the arguments for your call to
      ' Console.WriteLine(string, object, object) atop the stack:
      ' the string InStr, a reference to the boxed value of 'x', and
      ' a reference to the boxed value of 'y'.
      ' Call Console.WriteLine(string, object, object) with EmitCall.

      writeStrIL.EmitCall(OpCodes.Call, writeLineMI, Nothing)

      ' Lastly, EmitWriteLine can also output the value of a field
      ' using the overload EmitWriteLine(FieldInfo).

      writeStrIL.EmitWriteLine("The value of 'x' is:")
      writeStrIL.EmitWriteLine(xField)
      writeStrIL.EmitWriteLine("The value of 'y' is:")
      writeStrIL.EmitWriteLine(yField)

      ' Since we return no value (void), the the ret opcode will not
      ' return the top stack value.

      writeStrIL.Emit(OpCodes.Ret)

      Return pointTypeBld.CreateType()

   End Function 'CreateDynamicType


   Public Shared Sub Main()

      Dim ctorParams(1) As Object

      Console.Write("Enter a integer value for X: ")
      Dim myX As String = Console.ReadLine()
      Console.Write("Enter a integer value for Y: ")
      Dim myY As String = Console.ReadLine()

      Console.WriteLine("---")

      ctorParams(0) = Convert.ToInt32(myX)
      ctorParams(1) = Convert.ToInt32(myY)

      Dim ptType As Type = CreateDynamicType()

      Dim ptInstance As Object = Activator.CreateInstance(ptType, ctorParams)

      ptType.InvokeMember("WritePoint", _
			  BindingFlags.InvokeMethod, _
			  Nothing, ptInstance, Nothing)

   End Sub 'Main

End Class 'EmitWriteLineDemo



C#


using System;
using System.Threading;
using System.Reflection;
using System.Reflection.Emit;

class EmitWriteLineDemo {

   public static Type CreateDynamicType() {       
       Type[] ctorParams = new Type[] {typeof(int),
				   typeof(int)};
 	
       AppDomain myDomain = Thread.GetDomain();
       AssemblyName myAsmName = new AssemblyName();
       myAsmName.Name = "MyDynamicAssembly";

       AssemblyBuilder myAsmBuilder = myDomain.DefineDynamicAssembly(
				      myAsmName, 
				      AssemblyBuilderAccess.Run);

       ModuleBuilder pointModule = myAsmBuilder.DefineDynamicModule("PointModule",
								    "Point.dll");

       TypeBuilder pointTypeBld = pointModule.DefineType("Point",
					              TypeAttributes.Public);

       FieldBuilder xField = pointTypeBld.DefineField("x", typeof(int),
                                                      FieldAttributes.Public);
       FieldBuilder yField = pointTypeBld.DefineField("y", typeof(int), 
                                                      FieldAttributes.Public);


       Type objType = Type.GetType("System.Object"); 
       ConstructorInfo objCtor = objType.GetConstructor(new Type[0]);

       ConstructorBuilder pointCtor = pointTypeBld.DefineConstructor(
 				                   MethodAttributes.Public,
				                   CallingConventions.Standard,
				                   ctorParams);
       ILGenerator ctorIL = pointCtor.GetILGenerator();


       // First, you build the constructor.
       ctorIL.Emit(OpCodes.Ldarg_0);
       ctorIL.Emit(OpCodes.Call, objCtor);
       ctorIL.Emit(OpCodes.Ldarg_0);
       ctorIL.Emit(OpCodes.Ldarg_1);
       ctorIL.Emit(OpCodes.Stfld, xField); 
       ctorIL.Emit(OpCodes.Ldarg_0);
       ctorIL.Emit(OpCodes.Ldarg_2);
       ctorIL.Emit(OpCodes.Stfld, yField); 
       ctorIL.Emit(OpCodes.Ret); 

       //  Now, you'll build a method to output some information on the
       // inside your dynamic class. This method will have the following
       // definition in C#:
	//  public void WritePoint()

       MethodBuilder writeStrMthd = pointTypeBld.DefineMethod(
        		                     "WritePoint", 
				             MethodAttributes.Public,
                                             typeof(void), 
                                             null);


       ILGenerator writeStrIL = writeStrMthd.GetILGenerator();

       // The below ILGenerator created demonstrates a few ways to create
       // string output through STDIN. 

       // ILGenerator.EmitWriteLine(string) will generate a ldstr and a 
       // call to WriteLine for you.

       writeStrIL.EmitWriteLine("The value of this current instance is:");

       // Here, you will do the hard work yourself. First, you need to create
       // the string we will be passing and obtain the correct WriteLine overload
       // for said string. In the below case, you are substituting in two values,
       // so the chosen overload is Console.WriteLine(string, object, object).

       String inStr = "({0}, {1})";
       Type[] wlParams = new Type[] {typeof(string),
				     typeof(object),
				     typeof(object)};

       // We need the MethodInfo to pass into EmitCall later.

       MethodInfo writeLineMI = typeof(Console).GetMethod(
					        "WriteLine",
						wlParams);

       // Push the string with the substitutions onto the stack.
       // This is the first argument for WriteLine - the string one. 

       writeStrIL.Emit(OpCodes.Ldstr, inStr);

       // Since the second argument is an object, and it corresponds to
       // to the substitution for the value of our integer field, you 
       // need to box that field to an object. First, push a reference
       // to the current instance, and then push the value stored in
       // field 'x'. We need the reference to the current instance (stored
       // in local argument index 0) so Ldfld can load from the correct
       // instance (this one).

       writeStrIL.Emit(OpCodes.Ldarg_0);
       writeStrIL.Emit(OpCodes.Ldfld, xField);

       // Now, we execute the box opcode, which pops the value of field 'x',
       // returning a reference to the integer value boxed as an object.

       writeStrIL.Emit(OpCodes.Box, typeof(int));

       // Atop the stack, you'll find our string inStr, followed by a reference
       // to the boxed value of 'x'. Now, you need to likewise box field 'y'.

       writeStrIL.Emit(OpCodes.Ldarg_0);
       writeStrIL.Emit(OpCodes.Ldfld, yField);
       writeStrIL.Emit(OpCodes.Box, typeof(int));

       // Now, you have all of the arguments for your call to
       // Console.WriteLine(string, object, object) atop the stack:
       // the string InStr, a reference to the boxed value of 'x', and
       // a reference to the boxed value of 'y'.

       // Call Console.WriteLine(string, object, object) with EmitCall.

       writeStrIL.EmitCall(OpCodes.Call, writeLineMI, null);

       // Lastly, EmitWriteLine can also output the value of a field
       // using the overload EmitWriteLine(FieldInfo).

       writeStrIL.EmitWriteLine("The value of 'x' is:");
       writeStrIL.EmitWriteLine(xField);
       writeStrIL.EmitWriteLine("The value of 'y' is:");
       writeStrIL.EmitWriteLine(yField);

       // Since we return no value (void), the the ret opcode will not
       // return the top stack value.

       writeStrIL.Emit(OpCodes.Ret);

       return pointTypeBld.CreateType();

   }

   public static void Main() {

      object[] ctorParams = new object[2];

      Console.Write("Enter a integer value for X: "); 
      string myX = Console.ReadLine();
      Console.Write("Enter a integer value for Y: "); 
      string myY = Console.ReadLine();

      Console.WriteLine("---");

      ctorParams[0] = Convert.ToInt32(myX);
      ctorParams[1] = Convert.ToInt32(myY);

      Type ptType = CreateDynamicType();

      object ptInstance = Activator.CreateInstance(ptType, ctorParams);
      ptType.InvokeMember("WritePoint",
			  BindingFlags.InvokeMethod,
			  null,
			  ptInstance,
			  new object[0]);
   }
}



Visual C++

using namespace System;
using namespace System::Threading;
using namespace System::Reflection;
using namespace System::Reflection::Emit;
Type^ CreateDynamicType()
{
   array<Type^>^ctorParams = {int::typeid,int::typeid};
   AppDomain^ myDomain = Thread::GetDomain();
   AssemblyName^ myAsmName = gcnew AssemblyName;
   myAsmName->Name = "MyDynamicAssembly";
   AssemblyBuilder^ myAsmBuilder = myDomain->DefineDynamicAssembly( myAsmName, AssemblyBuilderAccess::Run );
   ModuleBuilder^ pointModule = myAsmBuilder->DefineDynamicModule( "PointModule", "Point.dll" );
   TypeBuilder^ pointTypeBld = pointModule->DefineType( "Point", TypeAttributes::Public );
   FieldBuilder^ xField = pointTypeBld->DefineField( "x", int::typeid, FieldAttributes::Public );
   FieldBuilder^ yField = pointTypeBld->DefineField( "y", int::typeid, FieldAttributes::Public );
   Type^ objType = Type::GetType( "System.Object" );
   ConstructorInfo^ objCtor = objType->GetConstructor( gcnew array<Type^>(0) );
   ConstructorBuilder^ pointCtor = pointTypeBld->DefineConstructor( MethodAttributes::Public, CallingConventions::Standard, ctorParams );
   ILGenerator^ ctorIL = pointCtor->GetILGenerator();

   // First, you build the constructor.
   ctorIL->Emit( OpCodes::Ldarg_0 );
   ctorIL->Emit( OpCodes::Call, objCtor );
   ctorIL->Emit( OpCodes::Ldarg_0 );
   ctorIL->Emit( OpCodes::Ldarg_1 );
   ctorIL->Emit( OpCodes::Stfld, xField );
   ctorIL->Emit( OpCodes::Ldarg_0 );
   ctorIL->Emit( OpCodes::Ldarg_2 );
   ctorIL->Emit( OpCodes::Stfld, yField );
   ctorIL->Emit( OpCodes::Ret );

   //  Now, you'll build a method to output some information on the
   // inside your dynamic class. This method will have the following
   // definition in C#:
   //  public void WritePoint()
   MethodBuilder^ writeStrMthd = pointTypeBld->DefineMethod( "WritePoint", MethodAttributes::Public, void::typeid, nullptr );
   ILGenerator^ writeStrIL = writeStrMthd->GetILGenerator();

   // The below ILGenerator created demonstrates a few ways to create
   // String* output through STDIN.
   // ILGenerator::EmitWriteLine(String*) will generate a ldstr and a
   // call to WriteLine for you.
   writeStrIL->EmitWriteLine( "The value of this current instance is:" );

   // Here, you will do the hard work yourself. First, you need to create
   // the String* we will be passing and obtain the correct WriteLine overload
   // for said String*. In the below case, you are substituting in two values,
   // so the chosen overload is Console::WriteLine(String*, Object*, Object*).
   String^ inStr = "( {0}, {1})";
   array<Type^>^wlParams = {String::typeid,Object::typeid,Object::typeid};

   // We need the MethodInfo to pass into EmitCall later.
   MethodInfo^ writeLineMI = Console::typeid->GetMethod( "WriteLine", wlParams );

   // Push the String* with the substitutions onto the stack.
   // This is the first argument for WriteLine - the String* one.
   writeStrIL->Emit( OpCodes::Ldstr, inStr );

   // Since the second argument is an Object*, and it corresponds to
   // to the substitution for the value of our integer field, you
   // need to box that field to an Object*. First, push a reference
   // to the current instance, and then push the value stored in
   // field 'x'. We need the reference to the current instance (stored
   // in local argument index 0) so Ldfld can load from the correct
   // instance (this one).
   writeStrIL->Emit( OpCodes::Ldarg_0 );
   writeStrIL->Emit( OpCodes::Ldfld, xField );

   // Now, we execute the box opcode, which pops the value of field 'x',
   // returning a reference to the integer value boxed as an Object*.
   writeStrIL->Emit( OpCodes::Box, int::typeid );

   // Atop the stack, you'll find our String* inStr, followed by a reference
   // to the boxed value of 'x'. Now, you need to likewise box field 'y'.
   writeStrIL->Emit( OpCodes::Ldarg_0 );
   writeStrIL->Emit( OpCodes::Ldfld, yField );
   writeStrIL->Emit( OpCodes::Box, int::typeid );

   // Now, you have all of the arguments for your call to
   // Console::WriteLine(String*, Object*, Object*) atop the stack:
   // the String* InStr, a reference to the boxed value of 'x', and
   // a reference to the boxed value of 'y'.
   // Call Console::WriteLine(String*, Object*, Object*) with EmitCall.
   writeStrIL->EmitCall( OpCodes::Call, writeLineMI, nullptr );

   // Lastly, EmitWriteLine can also output the value of a field
   // using the overload EmitWriteLine(FieldInfo).
   writeStrIL->EmitWriteLine( "The value of 'x' is:" );
   writeStrIL->EmitWriteLine( xField );
   writeStrIL->EmitWriteLine( "The value of 'y' is:" );
   writeStrIL->EmitWriteLine( yField );

   // Since we return no value (void), the the ret opcode will not
   // return the top stack value.
   writeStrIL->Emit( OpCodes::Ret );
   return pointTypeBld->CreateType();
}

int main()
{
   array<Object^>^ctorParams = gcnew array<Object^>(2);
   Console::Write( "Enter a integer value for X: " );
   String^ myX = Console::ReadLine();
   Console::Write( "Enter a integer value for Y: " );
   String^ myY = Console::ReadLine();
   Console::WriteLine( "---" );
   ctorParams[ 0 ] = Convert::ToInt32( myX );
   ctorParams[ 1 ] = Convert::ToInt32( myY );
   Type^ ptType = CreateDynamicType();
   Object^ ptInstance = Activator::CreateInstance( ptType, ctorParams );
   ptType->InvokeMember( "WritePoint", BindingFlags::InvokeMethod, nullptr, ptInstance, gcnew array<Object^>(0) );
}



Version Information

.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
Platforms

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.
Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.
See Also

Reference