OpCodes Class
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Provides field representations of the Microsoft Intermediate Language (MSIL) instructions for emission by the ILGenerator class members (such as Emit(OpCode)).
public ref class OpCodespublic class OpCodes[System.Runtime.InteropServices.ComVisible(true)]
public class OpCodestype OpCodes = class[<System.Runtime.InteropServices.ComVisible(true)>]
type OpCodes = classPublic Class OpCodes- Inheritance
-
OpCodes
- Attributes
Examples
The following example demonstrates the construction of a dynamic method using ILGenerator to emit OpCodes into a MethodBuilder.
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 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) );
}
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 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]);
}
}
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 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
End Class
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". For more information, see ECMA 335 Common Language Infrastructure (CLI).
Fields
| Add |
Adds two values and pushes the result onto the evaluation stack. |
| Add_Ovf |
Adds two integers, performs an overflow check, and pushes the result onto the evaluation stack. |
| Add_Ovf_Un |
Adds two unsigned integer values, performs an overflow check, and pushes the result onto the evaluation stack. |
| And |
Computes the bitwise AND of two values and pushes the result onto the evaluation stack. |
| Arglist |
Returns an unmanaged pointer to the argument list of the current method. |
| Beq |
Transfers control to a target instruction if two values are equal. |
| Beq_S |
Transfers control to a target instruction (short form) if two values are equal. |
| Bge |
Transfers control to a target instruction if the first value is greater than or equal to the second value. |
| Bge_S |
Transfers control to a target instruction (short form) if the first value is greater than or equal to the second value. |
| 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. |
| 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. |
| Bgt |
Transfers control to a target instruction if the first value is greater than the second value. |
| Bgt_S |
Transfers control to a target instruction (short form) if the first value is greater than the second value. |
| 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. |
| 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. |
| Ble |
Transfers control to a target instruction if the first value is less than or equal to the second value. |
| Ble_S |
Transfers control to a target instruction (short form) if the first value is less than or equal to the second value. |
| 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. |
| 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. |
| Blt |
Transfers control to a target instruction if the first value is less than the second value. |
| Blt_S |
Transfers control to a target instruction (short form) if the first value is less than the second value. |
| 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. |
| 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. |
| Bne_Un |
Transfers control to a target instruction when two unsigned integer values or unordered float values are not equal. |
| Bne_Un_S |
Transfers control to a target instruction (short form) when two unsigned integer values or unordered float values are not equal. |
| Box |
Converts a value type to an object reference (type |
| Br |
Unconditionally transfers control to a target instruction. |
| Br_S |
Unconditionally transfers control to a target instruction (short form). |
| Break |
Signals the Common Language Infrastructure (CLI) to inform the debugger that a break point has been tripped. |
| Brfalse |
Transfers control to a target instruction if |
| Brfalse_S |
Transfers control to a target instruction if |
| Brtrue |
Transfers control to a target instruction if |
| Brtrue_S |
Transfers control to a target instruction (short form) if |
| Call |
Calls the method indicated by the passed method descriptor. |
| Calli |
Calls the method indicated on the evaluation stack (as a pointer to an entry point) with arguments described by a calling convention. |
| Callvirt |
Calls a late-bound method on an object, pushing the return value onto the evaluation stack. |
| Castclass |
Attempts to cast an object passed by reference to the specified class. |
| Ceq |
Compares two values. If they are equal, the integer value 1 |
| Cgt |
Compares two values. If the first value is greater than the second, the integer value 1 |
| Cgt_Un |
Compares two unsigned or unordered values. If the first value is greater than the second, the integer value 1 |
| Ckfinite |
Throws ArithmeticException if value is not a finite number. |
| Clt |
Compares two values. If the first value is less than the second, the integer value 1 |
| Clt_Un |
Compares the unsigned or unordered values |
| Constrained |
Constrains the type on which a virtual method call is made. |
| Conv_I |
Converts the value on top of the evaluation stack to |
| Conv_I1 |
Converts the value on top of the evaluation stack to |
| Conv_I2 |
Converts the value on top of the evaluation stack to |
| Conv_I4 |
Converts the value on top of the evaluation stack to |
| Conv_I8 |
Converts the value on top of the evaluation stack to |
| Conv_Ovf_I |
Converts the signed value on top of the evaluation stack to signed |
| Conv_Ovf_I_Un |
Converts the unsigned value on top of the evaluation stack to signed |
| Conv_Ovf_I1 |
Converts the signed value on top of the evaluation stack to signed |
| Conv_Ovf_I1_Un |
Converts the unsigned value on top of the evaluation stack to signed |
| Conv_Ovf_I2 |
Converts the signed value on top of the evaluation stack to signed |
| Conv_Ovf_I2_Un |
Converts the unsigned value on top of the evaluation stack to signed |
| Conv_Ovf_I4 |
Converts the signed value on top of the evaluation stack to signed |
| Conv_Ovf_I4_Un |
Converts the unsigned value on top of the evaluation stack to signed |
| Conv_Ovf_I8 |
Converts the signed value on top of the evaluation stack to signed |
| Conv_Ovf_I8_Un |
Converts the unsigned value on top of the evaluation stack to signed |
| Conv_Ovf_U |
Converts the signed value on top of the evaluation stack to |
| Conv_Ovf_U_Un |
Converts the unsigned value on top of the evaluation stack to |
| Conv_Ovf_U1 |
Converts the signed value on top of the evaluation stack to |
| Conv_Ovf_U1_Un |
Converts the unsigned value on top of the evaluation stack to |
| Conv_Ovf_U2 |
Converts the signed value on top of the evaluation stack to |
| Conv_Ovf_U2_Un |
Converts the unsigned value on top of the evaluation stack to |
| Conv_Ovf_U4 |
Converts the signed value on top of the evaluation stack to |
| Conv_Ovf_U4_Un |
Converts the unsigned value on top of the evaluation stack to |
| Conv_Ovf_U8 |
Converts the signed value on top of the evaluation stack to |
| Conv_Ovf_U8_Un |
Converts the unsigned value on top of the evaluation stack to |
| Conv_R_Un |
Converts the unsigned integer value on top of the evaluation stack to |
| Conv_R4 |
Converts the value on top of the evaluation stack to |
| Conv_R8 |
Converts the value on top of the evaluation stack to |
| Conv_U |
Converts the value on top of the evaluation stack to |
| Conv_U1 |
Converts the value on top of the evaluation stack to |
| Conv_U2 |
Converts the value on top of the evaluation stack to |
| Conv_U4 |
Converts the value on top of the evaluation stack to |
| Conv_U8 |
Converts the value on top of the evaluation stack to |
| Cpblk |
Copies a specified number bytes from a source address to a destination address. |
| Cpobj |
Copies the value type located at the address of an object (type |
| Div |
Divides two values and pushes the result as a floating-point (type |
| Div_Un |
Divides two unsigned integer values and pushes the result ( |
| Dup |
Copies the current topmost value on the evaluation stack, and then pushes the copy onto the evaluation stack. |
| Endfilter |
Transfers control from the |
| Endfinally |
Transfers control from the |
| Initblk |
Initializes a specified block of memory at a specific address to a given size and initial value. |
| Initobj |
Initializes each field of the value type at a specified address to a null reference or a 0 of the appropriate primitive type. |
| Isinst |
Tests whether an object reference (type |
| Jmp |
Exits current method and jumps to specified method. |
| Ldarg |
Loads an argument (referenced by a specified index value) onto the stack. |
| Ldarg_0 |
Loads the argument at index 0 onto the evaluation stack. |
| Ldarg_1 |
Loads the argument at index 1 onto the evaluation stack. |
| Ldarg_2 |
Loads the argument at index 2 onto the evaluation stack. |
| Ldarg_3 |
Loads the argument at index 3 onto the evaluation stack. |
| Ldarg_S |
Loads the argument (referenced by a specified short form index) onto the evaluation stack. |
| Ldarga |
Load an argument address onto the evaluation stack. |
| Ldarga_S |
Load an argument address, in short form, onto the evaluation stack. |
| Ldc_I4 |
Pushes a supplied value of type |
| Ldc_I4_0 |
Pushes the integer value of 0 onto the evaluation stack as an |
| Ldc_I4_1 |
Pushes the integer value of 1 onto the evaluation stack as an |
| Ldc_I4_2 |
Pushes the integer value of 2 onto the evaluation stack as an |
| Ldc_I4_3 |
Pushes the integer value of 3 onto the evaluation stack as an |
| Ldc_I4_4 |
Pushes the integer value of 4 onto the evaluation stack as an |
| Ldc_I4_5 |
Pushes the integer value of 5 onto the evaluation stack as an |
| Ldc_I4_6 |
Pushes the integer value of 6 onto the evaluation stack as an |
| Ldc_I4_7 |
Pushes the integer value of 7 onto the evaluation stack as an |
| Ldc_I4_8 |
Pushes the integer value of 8 onto the evaluation stack as an |
| Ldc_I4_M1 |
Pushes the integer value of -1 onto the evaluation stack as an |
| Ldc_I4_S |
Pushes the supplied |
| Ldc_I8 |
Pushes a supplied value of type |
| Ldc_R4 |
Pushes a supplied value of type |
| Ldc_R8 |
Pushes a supplied value of type |
| Ldelem |
Loads the element at a specified array index onto the top of the evaluation stack as the type specified in the instruction. |
| Ldelem_I |
Loads the element with type |
| Ldelem_I1 |
Loads the element with type |
| Ldelem_I2 |
Loads the element with type |
| Ldelem_I4 |
Loads the element with type |
| Ldelem_I8 |
Loads the element with type |
| Ldelem_R4 |
Loads the element with type |
| Ldelem_R8 |
Loads the element with type |
| Ldelem_Ref |
Loads the element containing an object reference at a specified array index onto the top of the evaluation stack as type |
| Ldelem_U1 |
Loads the element with type |
| Ldelem_U2 |
Loads the element with type |
| Ldelem_U4 |
Loads the element with type |
| Ldelema |
Loads the address of the array element at a specified array index onto the top of the evaluation stack as type |
| Ldfld |
Finds the value of a field in the object whose reference is currently on the evaluation stack. |
| Ldflda |
Finds the address of a field in the object whose reference is currently on the evaluation stack. |
| Ldftn |
Pushes an unmanaged pointer (type |
| Ldind_I |
Loads a value of type |
| Ldind_I1 |
Loads a value of type |
| Ldind_I2 |
Loads a value of type |
| Ldind_I4 |
Loads a value of type |
| Ldind_I8 |
Loads a value of type |
| Ldind_R4 |
Loads a value of type |
| Ldind_R8 |
Loads a value of type |
| Ldind_Ref |
Loads an object reference as a type |
| Ldind_U1 |
Loads a value of type |
| Ldind_U2 |
Loads a value of type |
| Ldind_U4 |
Loads a value of type |
| Ldlen |
Pushes the number of elements of a zero-based, one-dimensional array onto the evaluation stack. |
| Ldloc |
Loads the local variable at a specific index onto the evaluation stack. |
| Ldloc_0 |
Loads the local variable at index 0 onto the evaluation stack. |
| Ldloc_1 |
Loads the local variable at index 1 onto the evaluation stack. |
| Ldloc_2 |
Loads the local variable at index 2 onto the evaluation stack. |
| Ldloc_3 |
Loads the local variable at index 3 onto the evaluation stack. |
| Ldloc_S |
Loads the local variable at a specific index onto the evaluation stack, short form. |
| Ldloca |
Loads the address of the local variable at a specific index onto the evaluation stack. |
| Ldloca_S |
Loads the address of the local variable at a specific index onto the evaluation stack, short form. |
| Ldnull |
Pushes a null reference (type |
| Ldobj |
Copies the value type object pointed to by an address to the top of the evaluation stack. |
| Ldsfld |
Pushes the value of a static field onto the evaluation stack. |
| Ldsflda |
Pushes the address of a static field onto the evaluation stack. |
| Ldstr |
Pushes a new object reference to a string literal stored in the metadata. |
| Ldtoken |
Converts a metadata token to its runtime representation, pushing it onto the evaluation stack. |
| Ldvirtftn |
Pushes an unmanaged pointer (type |
| Leave |
Exits a protected region of code, unconditionally transferring control to a specific target instruction. |
| Leave_S |
Exits a protected region of code, unconditionally transferring control to a target instruction (short form). |
| Localloc |
Allocates a certain number of bytes from the local dynamic memory pool and pushes the address (a transient pointer, type |
| Mkrefany |
Pushes a typed reference to an instance of a specific type onto the evaluation stack. |
| Mul |
Multiplies two values and pushes the result on the evaluation stack. |
| Mul_Ovf |
Multiplies two integer values, performs an overflow check, and pushes the result onto the evaluation stack. |
| Mul_Ovf_Un |
Multiplies two unsigned integer values, performs an overflow check, and pushes the result onto the evaluation stack. |
| Neg |
Negates a value and pushes the result onto the evaluation stack. |
| Newarr |
Pushes an object reference to a new zero-based, one-dimensional array whose elements are of a specific type onto the evaluation stack. |
| Newobj |
Creates a new object or a new instance of a value type, pushing an object reference (type |
| Nop |
Fills space if opcodes are patched. No meaningful operation is performed although a processing cycle can be consumed. |
| 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. |
| Or |
Compute the bitwise complement of the two integer values on top of the stack and pushes the result onto the evaluation stack. |
| Pop |
Removes the value currently on top of the evaluation stack. |
| Prefix1 |
This is a reserved instruction. |
| Prefix2 |
This is a reserved instruction. |
| Prefix3 |
This is a reserved instruction. |
| Prefix4 |
This is a reserved instruction. |
| Prefix5 |
This is a reserved instruction. |
| Prefix6 |
This is a reserved instruction. |
| Prefix7 |
This is a reserved instruction. |
| Prefixref |
This is a reserved instruction. |
| 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. |
| Refanytype |
Retrieves the type token embedded in a typed reference. |
| Refanyval |
Retrieves the address (type |
| Rem |
Divides two values and pushes the remainder onto the evaluation stack. |
| Rem_Un |
Divides two unsigned values and pushes the remainder onto the evaluation stack. |
| Ret |
Returns from the current method, pushing a return value (if present) from the callee's evaluation stack onto the caller's evaluation stack. |
| Rethrow |
Rethrows the current exception. |
| Shl |
Shifts an integer value to the left (in zeroes) by a specified number of bits, pushing the result onto the evaluation stack. |
| Shr |
Shifts an integer value (in sign) to the right by a specified number of bits, pushing the result onto the evaluation stack. |
| 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. |
| Sizeof |
Pushes the size, in bytes, of a supplied value type onto the evaluation stack. |
| Starg |
Stores the value on top of the evaluation stack in the argument slot at a specified index. |
| Starg_S |
Stores the value on top of the evaluation stack in the argument slot at a specified index, short form. |
| Stelem |
Replaces the array element at a given index with the value on the evaluation stack, whose type is specified in the instruction. |
| Stelem_I |
Replaces the array element at a given index with the |
| Stelem_I1 |
Replaces the array element at a given index with the |
| Stelem_I2 |
Replaces the array element at a given index with the |
| Stelem_I4 |
Replaces the array element at a given index with the |
| Stelem_I8 |
Replaces the array element at a given index with the |
| Stelem_R4 |
Replaces the array element at a given index with the |
| Stelem_R8 |
Replaces the array element at a given index with the |
| Stelem_Ref |
Replaces the array element at a given index with the object ref value (type |
| Stfld |
Replaces the value stored in the field of an object reference or pointer with a new value. |
| Stind_I |
Stores a value of type |
| Stind_I1 |
Stores a value of type |
| Stind_I2 |
Stores a value of type |
| Stind_I4 |
Stores a value of type |
| Stind_I8 |
Stores a value of type |
| Stind_R4 |
Stores a value of type |
| Stind_R8 |
Stores a value of type |
| Stind_Ref |
Stores a object reference value at a supplied address. |
| Stloc |
Pops the current value from the top of the evaluation stack and stores it in the local variable list at a specified index. |
| Stloc_0 |
Pops the current value from the top of the evaluation stack and stores it in the local variable list at index 0. |
| Stloc_1 |
Pops the current value from the top of the evaluation stack and stores it in the local variable list at index 1. |
| Stloc_2 |
Pops the current value from the top of the evaluation stack and stores it in the local variable list at index 2. |
| Stloc_3 |
Pops the current value from the top of the evaluation stack and stores it in the local variable list at index 3. |
| Stloc_S |
Pops the current value from the top of the evaluation stack and stores it in the local variable list at |
| Stobj |
Copies a value of a specified type from the evaluation stack into a supplied memory address. |
| Stsfld |
Replaces the value of a static field with a value from the evaluation stack. |
| Sub |
Subtracts one value from another and pushes the result onto the evaluation stack. |
| Sub_Ovf |
Subtracts one integer value from another, performs an overflow check, and pushes the result onto the evaluation stack. |
| Sub_Ovf_Un |
Subtracts one unsigned integer value from another, performs an overflow check, and pushes the result onto the evaluation stack. |
| Switch |
Implements a jump table. |
| Tailcall |
Performs a postfixed method call instruction such that the current method's stack frame is removed before the actual call instruction is executed. |
| Throw |
Throws the exception object currently on the evaluation stack. |
| Unaligned |
Indicates that an address currently atop the evaluation stack might not be aligned to the natural size of the immediately following |
| Unbox |
Converts the boxed representation of a value type to its unboxed form. |
| Unbox_Any |
Converts the boxed representation of a type specified in the instruction to its unboxed form. |
| 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. |
| Xor |
Computes the bitwise XOR of the top two values on the evaluation stack, pushing the result onto the evaluation stack. |
Methods
| Equals(Object) |
Determines whether the specified object is equal to the current object. (Inherited from Object) |
| GetHashCode() |
Serves as the default hash function. (Inherited from Object) |
| GetType() |
Gets the Type of the current instance. (Inherited from Object) |
| MemberwiseClone() |
Creates a shallow copy of the current Object. (Inherited from Object) |
| TakesSingleByteArgument(OpCode) |
Returns true or false if the supplied opcode takes a single byte argument. |
| ToString() |
Returns a string that represents the current object. (Inherited from Object) |
