MethodBuilder Класс

Определение

Пространство имен:

System.Reflection.Emit

Сборки:

netstandard.dll, System.Reflection.Emit.dll

Исходный код:

MethodBuilder.cs

Определяет и представляет метод (или конструктор) в динамическом классе.

public ref class MethodBuilder abstract : System::Reflection::MethodInfo

public abstract class MethodBuilder : System.Reflection.MethodInfo

type MethodBuilder = class
    inherit MethodInfo

Public MustInherit Class MethodBuilder
Inherits MethodInfo

Наследование

Object

MemberInfo

MethodBase

MethodInfo

MethodBuilder

Примеры

В следующем примере класс используется MethodBuilder для создания метода в динамическом типе.

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

class DemoMethodBuilder
{
    public static void AddMethodDynamically (TypeBuilder myTypeBld,
                                             string mthdName,
                                             Type[] mthdParams,
                                             Type returnType,
                                             string mthdAction)
    {

        MethodBuilder myMthdBld = myTypeBld.DefineMethod(
                                             mthdName,
                                             MethodAttributes.Public |
                                             MethodAttributes.Static,
                                             returnType,
                                             mthdParams);

        ILGenerator ILout = myMthdBld.GetILGenerator();

        int numParams = mthdParams.Length;

        for (byte x=0; x < numParams; x++)
        {
            ILout.Emit(OpCodes.Ldarg_S, x);
        }

        if (numParams > 1)
        {
            for (int y=0; y<(numParams-1); y++)
            {
                switch (mthdAction)
                {
                    case "A": ILout.Emit(OpCodes.Add);
                              break;
                    case "M": ILout.Emit(OpCodes.Mul);
                              break;
                    default: ILout.Emit(OpCodes.Add);
                              break;
                }
            }
        }
        ILout.Emit(OpCodes.Ret);
    }

    public static void Main()
    {
        AppDomain myDomain = AppDomain.CurrentDomain;
        AssemblyName asmName = new AssemblyName();
        asmName.Name = "MyDynamicAsm";

        AssemblyBuilder myAsmBuilder = myDomain.DefineDynamicAssembly(
                                       asmName,
                                       AssemblyBuilderAccess.RunAndSave);

        ModuleBuilder myModule = myAsmBuilder.DefineDynamicModule("MyDynamicAsm",
                                                                  "MyDynamicAsm.dll");

        TypeBuilder myTypeBld = myModule.DefineType("MyDynamicType",
                                                    TypeAttributes.Public);

        // Get info from the user to build the method dynamically.
        Console.WriteLine("Let's build a simple method dynamically!");
        Console.WriteLine("Please enter a few numbers, separated by spaces.");
        string inputNums = Console.ReadLine();
        Console.Write("Do you want to [A]dd (default) or [M]ultiply these numbers? ");
        string myMthdAction = Console.ReadLine().ToUpper();
        Console.Write("Lastly, what do you want to name your new dynamic method? ");
        string myMthdName = Console.ReadLine();

        // Process inputNums into an array and create a corresponding Type array
        int index = 0;
        string[] inputNumsList = inputNums.Split();

        Type[] myMthdParams = new Type[inputNumsList.Length];
        object[] inputValsList = new object[inputNumsList.Length];

        foreach (string inputNum in inputNumsList)
        {
            inputValsList[index] = (object)Convert.ToInt32(inputNum);
                myMthdParams[index] = typeof(int);
                index++;
        }

        // Now, call the method building method with the parameters, passing the
        // TypeBuilder by reference.
        AddMethodDynamically(myTypeBld,
                             myMthdName,
                             myMthdParams,
                             typeof(int),
                             myMthdAction);

        Type myType = myTypeBld.CreateType();

        Console.WriteLine("---");
        Console.WriteLine("The result of {0} the inputted values is: {1}",
                          ((myMthdAction == "M") ? "multiplying" : "adding"),
                          myType.InvokeMember(myMthdName,
                          BindingFlags.InvokeMethod | BindingFlags.Public |
                          BindingFlags.Static,
                          null,
                          null,
                          inputValsList));
        Console.WriteLine("---");

        // Let's take a look at the method we created.
        // If you are interested in seeing the MSIL generated dynamically for the method
        // your program generated, change to the directory where you ran the compiled
        // code sample and type "ildasm MyDynamicAsm.dll" at the prompt. When the list
        // of manifest contents appears, click on "MyDynamicType" and then on the name of
        // of the method you provided during execution.

        myAsmBuilder.Save("MyDynamicAsm.dll");

        MethodInfo myMthdInfo = myType.GetMethod(myMthdName);
        Console.WriteLine("Your Dynamic Method: {0};", myMthdInfo.ToString());
    }
}

Imports System.Reflection
Imports System.Reflection.Emit

Class DemoMethodBuilder
   
   Public Shared Sub AddMethodDynamically(ByVal myTypeBld As TypeBuilder, _
                                          ByVal mthdName As String, _
                                          ByVal mthdParams() As Type, _
                                          ByVal returnType As Type, _
                                          ByVal mthdAction As String)
      
      Dim myMthdBld As MethodBuilder = myTypeBld.DefineMethod(mthdName, _
                                       MethodAttributes.Public Or MethodAttributes.Static, _
                                       returnType, _
                                       mthdParams)
      
      Dim ILout As ILGenerator = myMthdBld.GetILGenerator()
      
      Dim numParams As Integer = mthdParams.Length
      
      Dim x As Byte
      For x = 0 To numParams - 1
         ILout.Emit(OpCodes.Ldarg_S, x)
      Next x
      
      If numParams > 1 Then
         Dim y As Integer
         For y = 0 To (numParams - 1) - 1
            Select Case mthdAction
               Case "A"
                  ILout.Emit(OpCodes.Add)
               Case "M"
                  ILout.Emit(OpCodes.Mul)
               Case Else
                  ILout.Emit(OpCodes.Add)
            End Select
         Next y
      End If
      ILout.Emit(OpCodes.Ret)
   End Sub 
    
   
   Public Shared Sub Main()
      
      Dim myDomain As AppDomain = AppDomain.CurrentDomain
      Dim asmName As New AssemblyName()
      asmName.Name = "MyDynamicAsm"
      
      Dim myAsmBuilder As AssemblyBuilder = myDomain.DefineDynamicAssembly(asmName, _
                                            AssemblyBuilderAccess.RunAndSave)
      
      Dim myModule As ModuleBuilder = myAsmBuilder.DefineDynamicModule("MyDynamicAsm", _
                                                                       "MyDynamicAsm.dll")
      
      Dim myTypeBld As TypeBuilder = myModule.DefineType("MyDynamicType", TypeAttributes.Public)
      
      ' Get info from the user to build the method dynamically.
      Console.WriteLine("Let's build a simple method dynamically!")
      Console.WriteLine("Please enter a few numbers, separated by spaces.")
      Dim inputNums As String = Console.ReadLine()
      Console.Write("Do you want to [A]dd (default) or [M]ultiply these numbers? ")
      Dim myMthdAction As String = Console.ReadLine().ToUpper()
      Console.Write("Lastly, what do you want to name your new dynamic method? ")
      Dim myMthdName As String = Console.ReadLine()
      
      ' Process inputNums into an array and create a corresponding Type array 
      Dim index As Integer = 0
      Dim inputNumsList As String() = inputNums.Split()
      
      Dim myMthdParams(inputNumsList.Length - 1) As Type
      Dim inputValsList(inputNumsList.Length - 1) As Object
      
      
      Dim inputNum As String
      For Each inputNum In  inputNumsList
         inputValsList(index) = CType(Convert.ToInt32(inputNum), Object)
         myMthdParams(index) = GetType(Integer)
         index += 1
      Next inputNum
      
      ' Now, call the method building method with the parameters, passing the 
      ' TypeBuilder by reference.
      AddMethodDynamically(myTypeBld, myMthdName, myMthdParams, GetType(Integer), myMthdAction)
      
      Dim myType As Type = myTypeBld.CreateType()
     
      Dim description as String 
      If myMthdAction = "M" Then
         description = "multiplying"
      Else
         description = "adding"
      End If

      Console.WriteLine("---")
      Console.WriteLine("The result of {0} the values is: {1}", _
                         description, _
                         myType.InvokeMember(myMthdName, _
                                             BindingFlags.InvokeMethod _
                                               Or BindingFlags.Public _
                                               Or BindingFlags.Static, _
                                             Nothing, _
                                             Nothing, _
                                             inputValsList)) 
      Console.WriteLine("---")

      ' If you are interested in seeing the MSIL generated dynamically for the method
      ' your program generated, change to the directory where you ran the compiled
      ' code sample and type "ildasm MyDynamicAsm.dll" at the prompt. When the list
      ' of manifest contents appears, click on "MyDynamicType" and then on the name of
      ' of the method you provided during execution.
 
      myAsmBuilder.Save("MyDynamicAsm.dll") 

      Dim myMthdInfo As MethodInfo = myType.GetMethod(myMthdName)
      Console.WriteLine("Your Dynamic Method: {0};", myMthdInfo.ToString())
   End Sub 
End Class

Комментарии

Класс MethodBuilder используется для полного описания метода в общем промежуточном языке (CIL), включая имя, атрибуты, сигнатуру и текст метода. Он используется в сочетании с классом TypeBuilder для создания классов во время выполнения.

Вы можете использовать отражение для определения глобальных методов и определения методов в качестве элементов типа. API, которые определяют методы, возвращающие объекты MethodBuilder .

Глобальные методы

Глобальный метод определяется с помощью ModuleBuilder.DefineGlobalMethod метода, который возвращает MethodBuilder объект.

Глобальные методы должны быть статическими. Если динамический модуль содержит глобальные методы, ModuleBuilder.CreateGlobalFunctions метод необходимо вызвать перед сохранением динамического модуля или содержащей динамической сборки, так как среда CLR откладывает исправление динамического модуля до тех пор, пока не будут определены все глобальные функции.

Глобальный собственный метод определяется с помощью ModuleBuilder.DefinePInvokeMethod метода. Методы вызова платформы (PInvoke) не должны объявляться абстрактными или виртуальными. Среда выполнения задает атрибут MethodAttributes.PinvokeImpl для метода Platform Invocation.

Методы как элементы типов

Метод определяется как член типа с помощью TypeBuilder.DefineMethod метода, который возвращает MethodBuilder объект.

Метод DefineParameter используется для задания атрибутов имени и параметров параметра или возвращаемого значения. Объект, ParameterBuilder возвращаемый этим методом, представляет параметр или возвращаемое значение. Объект ParameterBuilder можно использовать для задания маршалинга, задания константного значения и применения пользовательских атрибутов.

Attributes

MethodAttributes Члены перечисления определяют точный характер динамического метода.

• Статические методы задаются с помощью атрибута MethodAttributes.Static .
• Конечные методы (методы, которые не могут быть переопределены) задаются с помощью атрибута MethodAttributes.Final .
• Виртуальные методы задаются с помощью атрибута MethodAttributes.Virtual .
• Абстрактные методы задаются с помощью атрибута MethodAttributes.Abstract .
• Несколько атрибутов определяют видимость метода. См. описание перечисления MethodAttributes .
• Методы, реализующие перегруженные операторы, должны задать MethodAttributes.SpecialName атрибут.
• Финализаторы должны задать атрибут MethodAttributes.SpecialName.

Известные проблемы

• Хотя MethodBuilder происходит от MethodInfo, некоторые абстрактные методы, определенные в классе MethodInfo, не полностью реализованы в MethodBuilder. Эти методы MethodBuilder генерируют NotSupportedException исключение. Например, MethodBuilder.Invoke метод не полностью реализован. Вы можете размышлять о этих методах, извлекая вложенный тип с помощью методов Type.GetType или Assembly.GetType.
• Поддерживаются пользовательские модификаторы.

Конструкторы

Имя	Описание
MethodBuilder()	Инициализирует новый экземпляр класса MethodBuilder.

Свойства

Имя	Описание
Attributes	Извлекает атрибуты для этого метода.
CallingConvention	Возвращает соглашение о вызове метода.
ContainsGenericParameters	Не поддерживается для этого типа.
CustomAttributes	Возвращает коллекцию, содержащую настраиваемые атрибуты этого члена. (Унаследовано от MemberInfo)
DeclaringType	Возвращает тип, объявляющий этот метод.
InitLocals	Возвращает или задает логическое значение, указывающее, инициализированы ли локальные переменные в этом методе. Значение по умолчанию этого свойства равно true.
InitLocalsCore	При переопределении в производном классе получает или задает значение, указывающее, являются ли локальные переменные в этом методе нулевой инициализацией.
IsAbstract	Возвращает значение, указывающее, является ли метод абстрактным. (Унаследовано от MethodBase)
IsAssembly	Получает значение, указывающее, описывается ли потенциальная видимость этого метода или конструктора Assembly; то есть метод или конструктор не отображается в большинстве других типов в той же сборке и не отображается производным типам за пределами сборки. (Унаследовано от MethodBase)
IsCollectible	Возвращает значение, указывающее, ссылается ли этот MemberInfo объект на одну или несколько сборок, содержащихся в коллекционируемых AssemblyLoadContextобъектах. (Унаследовано от MemberInfo)
IsConstructedGenericMethod	Определяет и представляет метод (или конструктор) в динамическом классе. (Унаследовано от MethodBase)
IsConstructor	Возвращает значение, указывающее, является ли метод конструктором. (Унаследовано от MethodBase)
IsFamily	Возвращает значение, указывающее, описывается Familyли видимость этого метода или конструктора; то есть метод или конструктор видим только в его классе и производных классах. (Унаследовано от MethodBase)
IsFamilyAndAssembly	Возвращает значение, указывающее, описывается FamANDAssemли видимость этого метода или конструктора; то есть метод или конструктор можно вызывать производными классами, но только в том случае, если они находятся в одной сборке. (Унаследовано от MethodBase)
IsFamilyOrAssembly	Получает значение, указывающее, описывается FamORAssemли потенциальная видимость этого метода или конструктора; то есть метод или конструктор можно вызывать производными классами, где бы они ни находились, и классами в одной сборке. (Унаследовано от MethodBase)
IsFinal	Возвращает значение, указывающее, является finalли этот метод. (Унаследовано от MethodBase)
IsGenericMethod	Возвращает значение, указывающее, является ли метод универсальным методом.
IsGenericMethodDefinition	Возвращает значение, указывающее, представляет ли текущий MethodBuilder объект определение универсального метода.
IsHideBySig	Возвращает значение, указывающее, скрыт ли в производном классе только член того же типа с той же сигнатурой. (Унаследовано от MethodBase)
IsPrivate	Возвращает значение, указывающее, является ли этот элемент частным. (Унаследовано от MethodBase)
IsPublic	Возвращает значение, указывающее, является ли это общедоступным методом. (Унаследовано от MethodBase)
IsSecurityCritical	Вызывается NotSupportedException во всех случаях.
IsSecuritySafeCritical	Вызывается NotSupportedException во всех случаях.
IsSecurityTransparent	Вызывается NotSupportedException во всех случаях.
IsSpecialName	Возвращает значение, указывающее, имеет ли этот метод специальное имя. (Унаследовано от MethodBase)
IsStatic	Возвращает значение, указывающее, является staticли метод. (Унаследовано от MethodBase)
IsVirtual	Возвращает значение, указывающее, является virtualли метод. (Унаследовано от MethodBase)
MemberType	MemberTypes Возвращает значение, указывающее, что этот член является методом. (Унаследовано от MethodInfo)
MetadataToken	Возвращает маркер, определяющий текущий динамический модуль в метаданных.
MethodHandle	Извлекает внутренний дескриптор для метода. Используйте этот дескриптор для доступа к базовому дескриптору метаданных.
MethodImplementationFlags	Возвращает флаги, указывающие MethodImplAttributes атрибуты реализации метода. (Унаследовано от MethodBase)
Module	Возвращает модуль, в котором определен текущий метод.
Name	Извлекает имя этого метода.
ReflectedType	Извлекает класс, используемый в отражении для получения этого объекта.
ReturnParameter	ParameterInfo Возвращает объект, содержащий сведения о возвращаемом типе метода, например, имеет ли тип возвращаемого типа настраиваемые модификаторы.
ReturnType	Возвращает возвращаемый тип метода, представленного этим MethodBuilderметодом.
ReturnTypeCustomAttributes	Возвращает настраиваемые атрибуты возвращаемого типа метода.

Методы

Имя	Описание
CreateDelegate(Type, Object)	Создает делегат указанного типа с указанным целевым объектом из этого метода. (Унаследовано от MethodInfo)
CreateDelegate(Type)	Создает делегат указанного типа из этого метода. (Унаследовано от MethodInfo)
CreateDelegate<T>()	Создает делегат типа T из этого метода. (Унаследовано от MethodInfo)
CreateDelegate<T>(Object)	Создает делегат типа T с указанным целевым объектом из этого метода. (Унаследовано от MethodInfo)
DefineGenericParameters(String[])	Задает число параметров универсального типа для текущего метода, задает их имена и возвращает массив объектов, которые можно использовать для определения ограничений GenericTypeParameterBuilder .
DefineGenericParametersCore(String[])	При переопределении в производном классе задает количество параметров универсального типа для текущего метода, задает их имена и возвращает массив объектов, которые можно использовать для определения ограничений GenericTypeParameterBuilder .
DefineParameter(Int32, ParameterAttributes, String)	Задает атрибуты параметров и имя параметра этого метода или возвращаемое значение этого метода. Возвращает параметрBuilder, который можно использовать для применения пользовательских атрибутов.
DefineParameterCore(Int32, ParameterAttributes, String)	При переопределении в производном классе определяет параметр или возвращаемый параметр для этого метода.
Equals(Object)	Определяет, равен ли данный объект этому экземпляру.
GetBaseDefinition()	Возвращает базовую реализацию для метода.
GetCustomAttributes(Boolean)	Возвращает все пользовательские атрибуты, определенные для этого метода.
GetCustomAttributes(Type, Boolean)	Возвращает настраиваемые атрибуты, определяемые заданным типом.
GetCustomAttributesData()	Возвращает список CustomAttributeData объектов, представляющих данные о атрибутах, примененных к целевому элементу. (Унаследовано от MemberInfo)
GetGenericArguments()	Возвращает массив GenericTypeParameterBuilder объектов, представляющих параметры типа метода, если он является универсальным.
GetGenericMethodDefinition()	Возвращает этот метод.
GetHashCode()	Возвращает хэш-код для этого метода.
GetILGenerator()	Возвращает ILGenerator для этого метода с размером потока по умолчанию Microsoft промежуточного языка (MSIL) размером 64 байта.
GetILGenerator(Int32)	Возвращает ILGenerator для этого метода с указанным размером потока Microsoft промежуточного языка (MSIL).
GetILGeneratorCore(Int32)	При переопределении в производном классе получает значение ILGenerator , которое можно использовать для выдачи текста метода для этого метода.
GetMethodBody()	При переопределении в производном классе получает MethodBody объект, предоставляющий доступ к потоку MSIL, локальным переменным и исключениям для текущего метода. (Унаследовано от MethodBase)
GetMethodImplementationFlags()	Возвращает флаги реализации для метода.
GetParameters()	Возвращает параметры этого метода.
HasSameMetadataDefinitionAs(MemberInfo)	Определяет и представляет метод (или конструктор) в динамическом классе. (Унаследовано от MemberInfo)
Invoke(Object, BindingFlags, Binder, Object[], CultureInfo)	Динамически вызывает метод, отраженный этим экземпляром в заданном объекте, передавая указанные параметры, и при ограничениях данного привязчика.
IsDefined(Type, Boolean)	Проверяет, определен ли указанный пользовательский тип атрибута.
MakeGenericMethod(Type[])	Возвращает универсальный метод, созданный из текущего определения универсального метода с помощью указанных аргументов универсального типа.
MemberwiseClone()	Создает неглубокую копию текущей Object. (Унаследовано от Object)
SetCustomAttribute(ConstructorInfo, Byte[])	Задает настраиваемый атрибут с помощью указанного пользовательского BLOB-объекта атрибута.
SetCustomAttribute(CustomAttributeBuilder)	Задает пользовательский атрибут с помощью построителя настраиваемых атрибутов.
SetCustomAttributeCore(ConstructorInfo, ReadOnlySpan<Byte>)	При переопределении в производном классе задает настраиваемый атрибут для этой сборки.
SetImplementationFlags(MethodImplAttributes)	Задает флаги реализации для этого метода.
SetImplementationFlagsCore(MethodImplAttributes)	При переопределении в производном классе задает флаги реализации для этого метода.
SetParameters(Type[])	Задает число и типы параметров для метода.
SetReturnType(Type)	Задает тип возвращаемого метода.
SetSignature(Type, Type[], Type[], Type[], Type[][], Type[][])	Задает сигнатуру метода, включая возвращаемый тип, типы параметров и обязательные и необязательные настраиваемые модификаторы возвращаемого типа и типов параметров.
SetSignatureCore(Type, Type[], Type[], Type[], Type[][], Type[][])	При переопределении в производном классе задает сигнатуру метода, включая тип возвращаемого значения, типы параметров и обязательные и необязательные настраиваемые модификаторы возвращаемого типа и типы параметров.
ToString()	Возвращает этот MethodBuilder экземпляр в виде строки.

Методы расширения

Имя	Описание
GetBaseDefinition(MethodInfo)	Определяет и представляет метод (или конструктор) в динамическом классе.
GetCustomAttribute(MemberInfo, Type, Boolean)	Извлекает настраиваемый атрибут указанного типа, применяемого к указанному элементу, и при необходимости проверяет предки этого элемента.
GetCustomAttribute(MemberInfo, Type)	Извлекает настраиваемый атрибут указанного типа, применяемого к указанному элементу.
GetCustomAttribute<T>(MemberInfo, Boolean)	Извлекает настраиваемый атрибут указанного типа, применяемого к указанному элементу, и при необходимости проверяет предки этого элемента.
GetCustomAttribute<T>(MemberInfo)	Извлекает настраиваемый атрибут указанного типа, применяемого к указанному элементу.
GetCustomAttributes(MemberInfo, Boolean)	Извлекает коллекцию настраиваемых атрибутов, применяемых к указанному элементу, и при необходимости проверяет предки этого элемента.
GetCustomAttributes(MemberInfo, Type, Boolean)	Извлекает коллекцию настраиваемых атрибутов указанного типа, применяемого к указанному элементу, и при необходимости проверяет предки этого элемента.
GetCustomAttributes(MemberInfo, Type)	Извлекает коллекцию настраиваемых атрибутов указанного типа, применяемого к указанному элементу.
GetCustomAttributes(MemberInfo)	Извлекает коллекцию настраиваемых атрибутов, применяемых к указанному элементу.
GetCustomAttributes<T>(MemberInfo, Boolean)	Извлекает коллекцию настраиваемых атрибутов указанного типа, применяемого к указанному элементу, и при необходимости проверяет предки этого элемента.
GetCustomAttributes<T>(MemberInfo)	Извлекает коллекцию настраиваемых атрибутов указанного типа, применяемого к указанному элементу.
GetMetadataToken(MemberInfo)	Возвращает маркер метаданных для данного члена, если он доступен.
GetRuntimeBaseDefinition(MethodInfo)	Извлекает объект, представляющий указанный метод в прямом или косвенном базовом классе, где метод был впервые объявлен.
HasMetadataToken(MemberInfo)	Возвращает значение, указывающее, доступен ли маркер метаданных для указанного элемента.
IsDefined(MemberInfo, Type, Boolean)	Указывает, применяются ли пользовательские атрибуты указанного типа к указанному элементу и, при необходимости, применяются к его предкам.
IsDefined(MemberInfo, Type)	Указывает, применяются ли пользовательские атрибуты указанного типа к указанному элементу.