Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

MethodBuilder.CreateMethodBody Method

Creates the body of the method using a supplied byte array of Microsoft intermediate language (MSIL) instructions.

Namespace:  System.Reflection.Emit
Assembly:  mscorlib (in mscorlib.dll)
'Declaration
Public Sub CreateMethodBody ( _
	il As Byte(), _
	count As Integer _
)
'Usage
Dim instance As MethodBuilder 
Dim il As Byte()
Dim count As Integer

instance.CreateMethodBody(il, count)

Parameters

il
Type: System.Byte()

An array containing valid MSIL instructions. If this parameter is Nothing, the method's body is cleared.

count
Type: System.Int32

The number of valid bytes in the MSIL array. This value is ignored if MSIL is Nothing.

ExceptionCondition
ArgumentOutOfRangeException

The count is not within the range of indexes of the supplied MSIL instruction array and il is not Nothing.

InvalidOperationException

The containing type was previously created using CreateType.

-or-

This method was called previously on this MethodBuilder with an il argument that was not Nothing.

-or-

For the current method, the IsGenericMethod property is true, but the IsGenericMethodDefinition property is false.

This method creates the method's body from il, an array containing MSIL instructions as opcodes. The number of bytes of valid MSIL is given by count.

NoteNote:

This is currently not fully supported. The user cannot supply the location of token fix ups and exception handlers.

In the example provided below, a simple method that adds two integers is generated via opcode using CreateMethodBody.

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

 _

Class MethodBodyDemo

   ' This class will demonstrate how to create a method body using  
   ' the MethodBuilder.CreateMethodBody(byte[], int) method. 

   Public Shared Function BuildDynType() As Type

      Dim addType As Type = Nothing 

      Dim currentDom As AppDomain = Thread.GetDomain()

      Dim myAsmName As New AssemblyName()
      myAsmName.Name = "MyDynamicAssembly" 

      Dim myAsmBldr As AssemblyBuilder = currentDom.DefineDynamicAssembly(myAsmName, _
				         AssemblyBuilderAccess.RunAndSave)

      ' The dynamic assembly space has been created.  Next, create a module 
      ' within it.  The type Point will be reflected into this module. 
      Dim myModuleBldr As ModuleBuilder = myAsmBldr.DefineDynamicModule("MyModule")

      Dim myTypeBldr As TypeBuilder = myModuleBldr.DefineType("Adder")

      Dim myMthdBldr As MethodBuilder = myTypeBldr.DefineMethod("DoAdd", _
					MethodAttributes.Public Or MethodAttributes.Static, _
				        GetType(Integer), _
					New Type() {GetType(Integer), GetType(Integer)})

      ' Build the array of Bytes holding the MSIL instructions. 

      Dim ILcodes() As Byte = {&H2, &H3, &H58, &H2A}

      ' 02h is the opcode for ldarg.0  
      ' 03h is the opcode for ldarg.1  
      ' 58h is the opcode for add      
      ' 2Ah is the opcode for ret     

      myMthdBldr.CreateMethodBody(ILcodes, ILcodes.Length)

      addType = myTypeBldr.CreateType()

      Return addType

   End Function 'BuildDynType


   Public Shared Sub Main()

      Dim myType As Type = BuildDynType()
      Console.WriteLine("---")
      Console.Write("Enter the first integer to add: ")
      Dim aVal As Integer = Convert.ToInt32(Console.ReadLine())

      Console.Write("Enter the second integer to add: ")
      Dim bVal As Integer = Convert.ToInt32(Console.ReadLine())

      Dim adderInst As Object = Activator.CreateInstance(myType, New Object() {})

      Console.WriteLine("The value of adding {0} to {1} is: {2}.", _
			 aVal, bVal, _
			 myType.InvokeMember("DoAdd", _
					      BindingFlags.InvokeMethod, _
					      Nothing, _
					      adderInst, _
					      New Object() {aVal, bVal}))

   End Sub 'Main

End Class 'MethodBodyDemo

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98

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

.NET Framework

Supported in: 3.5, 3.0, 2.0, 1.1, 1.0
Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.