Export (0) Print
Expand All
0 out of 1 rated this helpful - Rate this topic

ILGenerator Class

Generates Microsoft intermediate language (MSIL) instructions.

System.Object
  System.Reflection.Emit.ILGenerator

Namespace:  System.Reflection.Emit
Assembly:  mscorlib (in mscorlib.dll)
[ClassInterfaceAttribute(ClassInterfaceType.None)]
[ComVisibleAttribute(true)]
public class ILGenerator : _ILGenerator

The ILGenerator type exposes the following members.

  NameDescription
Public propertyILOffsetGets the current offset, in bytes, in the Microsoft intermediate language (MSIL) stream that is being emitted by the ILGenerator.
Top
  NameDescription
Public methodBeginCatchBlockBegins a catch block.
Public methodBeginExceptFilterBlockBegins an exception block for a filtered exception.
Public methodBeginExceptionBlockBegins an exception block for a non-filtered exception.
Public methodBeginFaultBlockBegins an exception fault block in the Microsoft intermediate language (MSIL) stream.
Public methodBeginFinallyBlockBegins a finally block in the Microsoft intermediate language (MSIL) instruction stream.
Public methodBeginScopeBegins a lexical scope.
Public methodDeclareLocal(Type)Declares a local variable of the specified type.
Public methodDeclareLocal(Type, Boolean)Declares a local variable of the specified type, optionally pinning the object referred to by the variable.
Public methodDefineLabelDeclares a new label.
Public methodEmit(OpCode)Puts the specified instruction onto the stream of instructions.
Public methodEmit(OpCode, Byte)Puts the specified instruction and character argument onto the Microsoft intermediate language (MSIL) stream of instructions.
Public methodEmit(OpCode, Double)Puts the specified instruction and numerical argument onto the Microsoft intermediate language (MSIL) stream of instructions.
Public methodEmit(OpCode, Int16)Puts the specified instruction and numerical argument onto the Microsoft intermediate language (MSIL) stream of instructions.
Public methodEmit(OpCode, Int32)Puts the specified instruction and numerical argument onto the Microsoft intermediate language (MSIL) stream of instructions.
Public methodEmit(OpCode, Int64)Puts the specified instruction and numerical argument onto the Microsoft intermediate language (MSIL) stream of instructions.
Public methodEmit(OpCode, ConstructorInfo)Puts the specified instruction and metadata token for the specified constructor onto the Microsoft intermediate language (MSIL) stream of instructions.
Public methodEmit(OpCode, Label)Puts the specified instruction onto the Microsoft intermediate language (MSIL) stream and leaves space to include a label when fixes are done.
Public methodEmit(OpCode, Label[])Puts the specified instruction onto the Microsoft intermediate language (MSIL) stream and leaves space to include a label when fixes are done.
Public methodEmit(OpCode, LocalBuilder)Puts the specified instruction onto the Microsoft intermediate language (MSIL) stream followed by the index of the given local variable.
Public methodEmit(OpCode, SignatureHelper)Puts the specified instruction and a signature token onto the Microsoft intermediate language (MSIL) stream of instructions.
Public methodEmit(OpCode, FieldInfo)Puts the specified instruction and metadata token for the specified field onto the Microsoft intermediate language (MSIL) stream of instructions.
Public methodEmit(OpCode, MethodInfo)Puts the specified instruction onto the Microsoft intermediate language (MSIL) stream followed by the metadata token for the given method.
Public methodEmit(OpCode, SByte)Puts the specified instruction and character argument onto the Microsoft intermediate language (MSIL) stream of instructions.
Public methodEmit(OpCode, Single)Puts the specified instruction and numerical argument onto the Microsoft intermediate language (MSIL) stream of instructions.
Public methodEmit(OpCode, String)Puts the specified instruction onto the Microsoft intermediate language (MSIL) stream followed by the metadata token for the given string.
Public methodEmit(OpCode, Type)Puts the specified instruction onto the Microsoft intermediate language (MSIL) stream followed by the metadata token for the given type.
Public methodEmitCallPuts a call or callvirt instruction onto the Microsoft intermediate language (MSIL) stream to call a varargs method.
Public methodEmitCalli(OpCode, CallingConvention, Type, Type[])Puts a Calli instruction onto the Microsoft intermediate language (MSIL) stream, specifying an unmanaged calling convention for the indirect call.
Public methodEmitCalli(OpCode, CallingConventions, Type, Type[], Type[])Puts a Calli instruction onto the Microsoft intermediate language (MSIL) stream, specifying a managed calling convention for the indirect call.
Public methodEmitWriteLine(FieldInfo)Emits the Microsoft intermediate language (MSIL) necessary to call Console.WriteLine with the given field.
Public methodEmitWriteLine(LocalBuilder)Emits the Microsoft intermediate language (MSIL) necessary to call Console.WriteLine with the given local variable.
Public methodEmitWriteLine(String)Emits the Microsoft intermediate language (MSIL) to call Console.WriteLine with a string.
Public methodEndExceptionBlockEnds an exception block.
Public methodEndScopeEnds a lexical scope.
Public methodEquals(Object)Determines whether the specified object is equal to the current object. (Inherited from Object.)
Protected methodFinalizeAllows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
Public methodGetHashCodeServes as the default hash function. (Inherited from Object.)
Public methodGetTypeGets the Type of the current instance. (Inherited from Object.)
Public methodMarkLabelMarks the Microsoft intermediate language (MSIL) stream's current position with the given label.
Public methodMarkSequencePointMarks a sequence point in the Microsoft intermediate language (MSIL) stream.
Protected methodMemberwiseCloneCreates a shallow copy of the current Object. (Inherited from Object.)
Public methodThrowExceptionEmits an instruction to throw an exception.
Public methodToStringReturns a string that represents the current object. (Inherited from Object.)
Public methodUsingNamespaceSpecifies the namespace to be used in evaluating locals and watches for the current active lexical scope.
Top
  NameDescription
Explicit interface implemetationPrivate method_ILGenerator.GetIDsOfNamesMaps a set of names to a corresponding set of dispatch identifiers.
Explicit interface implemetationPrivate method_ILGenerator.GetTypeInfoRetrieves the type information for an object, which can then be used to get the type information for an interface.
Explicit interface implemetationPrivate method_ILGenerator.GetTypeInfoCountRetrieves the number of type information interfaces that an object provides (either 0 or 1).
Explicit interface implemetationPrivate method_ILGenerator.InvokeProvides access to properties and methods exposed by an object.
Top

ILGenerator is used to generate method bodies for methods and constructors in dynamic assemblies (represented by the MethodBuilder and ConstructorBuilder classes) and for standalone dynamic methods (represented by the DynamicMethod class). To obtain an ILGenerator, use the ConstructorBuilder.GetILGenerator, DynamicMethod.GetILGenerator, and MethodBuilder.GetILGenerator methods.

MSIL is used as input to a just-in-time (JIT) compiler.

.NET Framework

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

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

.NET for Windows Phone apps

Supported in: Windows Phone 8.1, Windows Phone 8, Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

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

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.
Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft. All rights reserved.