ModuleBuilder Класс

Определение

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

System.Reflection.Emit

Сборки:

netstandard.dll, System.Reflection.Emit.dll

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

ModuleBuilder.cs

Определяет и представляет модуль в динамической сборке.

public ref class ModuleBuilder abstract : System::Reflection::Module

public abstract class ModuleBuilder : System.Reflection.Module

type ModuleBuilder = class
    inherit Module

Public MustInherit Class ModuleBuilder
Inherits Module

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

Object

Module

ModuleBuilder

Примеры

В следующем примере кода показано, как ModuleBuilder создать динамический модуль. Обратите внимание, что МодульBuilder создается путем вызова DefineDynamicModuleAssemblyBuilder, а не через конструктор.

using System;
using System.Reflection;
using System.Reflection.Emit;
using System.Security.Permissions;

public class CodeGenerator
{
   AssemblyBuilder myAssemblyBuilder;
   public CodeGenerator()
   {
      // Get the current application domain for the current thread.
      AppDomain myCurrentDomain = AppDomain.CurrentDomain;
      AssemblyName myAssemblyName = new AssemblyName();
      myAssemblyName.Name = "TempAssembly";

      // Define a dynamic assembly in the current application domain.
      myAssemblyBuilder = myCurrentDomain.DefineDynamicAssembly
                     (myAssemblyName, AssemblyBuilderAccess.Run);

      // Define a dynamic module in this assembly.
      ModuleBuilder myModuleBuilder = myAssemblyBuilder.
                                      DefineDynamicModule("TempModule");

      // Define a runtime class with specified name and attributes.
      TypeBuilder myTypeBuilder = myModuleBuilder.DefineType
                                       ("TempClass",TypeAttributes.Public);

      // Add 'Greeting' field to the class, with the specified attribute and type.
      FieldBuilder greetingField = myTypeBuilder.DefineField("Greeting",
                                                            typeof(String), FieldAttributes.Public);
      Type[] myMethodArgs = { typeof(String) };

      // Add 'MyMethod' method to the class, with the specified attribute and signature.
      MethodBuilder myMethod = myTypeBuilder.DefineMethod("MyMethod",
         MethodAttributes.Public, CallingConventions.Standard, null,myMethodArgs);

      ILGenerator methodIL = myMethod.GetILGenerator();
      methodIL.EmitWriteLine("In the method...");
      methodIL.Emit(OpCodes.Ldarg_0);
      methodIL.Emit(OpCodes.Ldarg_1);
      methodIL.Emit(OpCodes.Stfld, greetingField);
      methodIL.Emit(OpCodes.Ret);
      myTypeBuilder.CreateType();
   }
   public AssemblyBuilder MyAssembly
   {
      get
      {
         return this.myAssemblyBuilder;
      }
   }
}
public class TestClass
{
   public static void Main()
   {
      CodeGenerator myCodeGenerator = new CodeGenerator();
      // Get the assembly builder for 'myCodeGenerator' object.
      AssemblyBuilder myAssemblyBuilder = myCodeGenerator.MyAssembly;
      // Get the module builder for the above assembly builder object .
      ModuleBuilder myModuleBuilder = myAssemblyBuilder.
                                                           GetDynamicModule("TempModule");
      Console.WriteLine("The fully qualified name and path to this "
                               + "module is :" +myModuleBuilder.FullyQualifiedName);
      Type myType = myModuleBuilder.GetType("TempClass");
      MethodInfo myMethodInfo =
                                                myType.GetMethod("MyMethod");
       // Get the token used to identify the method within this module.
      MethodToken myMethodToken =
                        myModuleBuilder.GetMethodToken(myMethodInfo);
      Console.WriteLine("Token used to identify the method of 'myType'"
                    + " within the module is {0:x}",myMethodToken.Token);
     object[] args={"Hello."};
     object myObject = Activator.CreateInstance(myType,null,null);
     myMethodInfo.Invoke(myObject,args);
   }
}

Imports System.Reflection
Imports System.Reflection.Emit
Imports System.Security.Permissions

Public Class CodeGenerator
   Private myAssemblyBuilder As AssemblyBuilder

   Public Sub New()
      ' Get the current application domain for the current thread.
      Dim myCurrentDomain As AppDomain = AppDomain.CurrentDomain
      Dim myAssemblyName As New AssemblyName()
      myAssemblyName.Name = "TempAssembly"

      ' Define a dynamic assembly in the current application domain.
      myAssemblyBuilder = _
               myCurrentDomain.DefineDynamicAssembly(myAssemblyName, AssemblyBuilderAccess.Run)

      ' Define a dynamic module in this assembly.
      Dim myModuleBuilder As ModuleBuilder = myAssemblyBuilder.DefineDynamicModule("TempModule")

      ' Define a runtime class with specified name and attributes.
      Dim myTypeBuilder As TypeBuilder = _
               myModuleBuilder.DefineType("TempClass", TypeAttributes.Public)

      ' Add 'Greeting' field to the class, with the specified attribute and type.
      Dim greetingField As FieldBuilder = _
               myTypeBuilder.DefineField("Greeting", GetType(String), FieldAttributes.Public)
      Dim myMethodArgs As Type() = {GetType(String)}

      ' Add 'MyMethod' method to the class, with the specified attribute and signature.
      Dim myMethod As MethodBuilder = _
               myTypeBuilder.DefineMethod("MyMethod", MethodAttributes.Public, _
               CallingConventions.Standard, Nothing, myMethodArgs)

      Dim methodIL As ILGenerator = myMethod.GetILGenerator()
      methodIL.EmitWriteLine("In the method...")
      methodIL.Emit(OpCodes.Ldarg_0)
      methodIL.Emit(OpCodes.Ldarg_1)
      methodIL.Emit(OpCodes.Stfld, greetingField)
      methodIL.Emit(OpCodes.Ret)
      myTypeBuilder.CreateType()
   End Sub

   Public ReadOnly Property MyAssembly() As AssemblyBuilder
      Get
         Return Me.myAssemblyBuilder
      End Get
   End Property
End Class

Public Class TestClass
   <PermissionSetAttribute(SecurityAction.Demand, Name:="FullTrust")> _
   Public Shared Sub Main()
      Dim myCodeGenerator As New CodeGenerator()
      ' Get the assembly builder for 'myCodeGenerator' object.
      Dim myAssemblyBuilder As AssemblyBuilder = myCodeGenerator.MyAssembly
      ' Get the module builder for the above assembly builder object .
      Dim myModuleBuilder As ModuleBuilder = myAssemblyBuilder.GetDynamicModule("TempModule")
      Console.WriteLine("The fully qualified name and path to this " + _
                        "module is :" + myModuleBuilder.FullyQualifiedName)
      Dim myType As Type = myModuleBuilder.GetType("TempClass")
      Dim myMethodInfo As MethodInfo = myType.GetMethod("MyMethod")
      ' Get the token used to identify the method within this module.
      Dim myMethodToken As MethodToken = myModuleBuilder.GetMethodToken(myMethodInfo)
      Console.WriteLine("Token used to identify the method of 'myType'" + _
                        " within the module is {0:x}", myMethodToken.Token)
      Dim args As Object() = {"Hello."}
      Dim myObject As Object = Activator.CreateInstance(myType, Nothing, Nothing)
      myMethodInfo.Invoke(myObject, args)
   End Sub
End Class

Комментарии

Чтобы получить экземпляр ModuleBuilder, используйте AssemblyBuilder.DefineDynamicModule метод.

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

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

Свойства

Имя	Описание
Assembly	Возвращает динамическую сборку, определяющую этот экземпляр ModuleBuilder.
CustomAttributes	Возвращает коллекцию, содержащую пользовательские атрибуты этого модуля. (Унаследовано от Module)
FullyQualifiedName	String Возвращает полное имя и путь к этому модулю.
MDStreamVersion	Возвращает версию потока метаданных.
MetadataToken	Возвращает маркер, определяющий текущий динамический модуль в метаданных.
ModuleHandle	Возвращает дескриптор модуля. (Унаследовано от Module)
ModuleVersionId	Получает универсальный уникальный идентификатор (UUID), который можно использовать для различения двух версий модуля.
Name	Строка, указывающая, что это модуль в памяти.
ScopeName	Возвращает строку, представляющую имя динамического модуля.

Методы

Имя	Описание
CreateGlobalFunctions()	Завершает определения глобальных функций и глобальные определения данных для этого динамического модуля.
CreateGlobalFunctionsCore()	При переопределении в производном классе завершает определения глобальных функций и глобальные определения данных для этого динамического модуля.
DefineDocument(String, Guid, Guid, Guid)	Определяет документ для источника.
DefineDocument(String, Guid)	Определяет документ для источника.
DefineDocumentCore(String, Guid)	При переопределении в производном классе определяет документ для источника.
DefineEnum(String, TypeAttributes, Type)	Определяет тип перечисления, который является типом значения с одним нестатическом полем, называемым value__ указанным типом.
DefineEnumCore(String, TypeAttributes, Type)	При переопределении в производном классе определяет тип перечисления, который является типом значения с одним нестатическом полем, которое называется value__ указанного типа.
DefineGlobalMethod(String, MethodAttributes, CallingConventions, Type, Type[], Type[], Type[], Type[][], Type[][])	Определяет глобальный метод с указанным именем, атрибутами, соглашением о вызовах, типом возврата, настраиваемыми модификаторами возвращаемого типа, типами параметров и настраиваемыми модификаторами для типов параметров.
DefineGlobalMethod(String, MethodAttributes, CallingConventions, Type, Type[])	Определяет глобальный метод с указанным именем, атрибутами, соглашением о вызове, типом возвращаемого значения и типами параметров.
DefineGlobalMethod(String, MethodAttributes, Type, Type[])	Определяет глобальный метод с указанным именем, атрибутами, возвращаемым типом и типами параметров.
DefineGlobalMethodCore(String, MethodAttributes, CallingConventions, Type, Type[], Type[], Type[], Type[][], Type[][])	При переопределении в производном классе определяет глобальный метод с указанным именем, атрибутами, соглашением о вызовах, типом возврата, настраиваемыми модификаторами возвращаемого типа, типами параметров и настраиваемыми модификаторами для типов параметров.
DefineInitializedData(String, Byte[], FieldAttributes)	Определяет инициализированное поле данных в разделе SDATA переносимого исполняемого файла (PE).
DefineInitializedDataCore(String, Byte[], FieldAttributes)	При переопределении в производном классе определяет поле инициализированных данных в разделе SDATA переносимого исполняемого файла (PE).
DefinePInvokeMethod(String, String, MethodAttributes, CallingConventions, Type, Type[], CallingConvention, CharSet)	Определяет PInvoke метод с указанным именем, именем библиотеки DLL, в которой определен метод, атрибутами метода, соглашением о вызове метода, возвращаемым типом метода, типами параметров метода и PInvoke флагами.
DefinePInvokeMethod(String, String, String, MethodAttributes, CallingConventions, Type, Type[], CallingConvention, CharSet)	Определяет PInvoke метод с указанным именем, именем библиотеки DLL, в которой определен метод, атрибутами метода, соглашением о вызове метода, возвращаемым типом метода, типами параметров метода и PInvoke флагами.
DefinePInvokeMethodCore(String, String, String, MethodAttributes, CallingConventions, Type, Type[], CallingConvention, CharSet)	При переопределении в производном классе определяет PInvoke метод.
DefineType(String, TypeAttributes, Type, Int32)	Создает заданное TypeBuilder имя типа, атрибуты, тип, который расширяет определенный тип, и общий размер типа.
DefineType(String, TypeAttributes, Type, PackingSize, Int32)	TypeBuilder Создает заданное имя типа, атрибуты, тип, который расширяет определенный тип, размер упаковки определенного типа и общий размер определенного типа.
DefineType(String, TypeAttributes, Type, PackingSize)	Создает заданное TypeBuilder имя типа, атрибуты, тип, который расширяет определенный тип, и размер упаковки типа.
DefineType(String, TypeAttributes, Type, Type[])	Создает заданное TypeBuilder имя типа, атрибуты, тип, который расширяет определенный тип, и интерфейсы, которые реализует определенный тип.
DefineType(String, TypeAttributes, Type)	Создает заданное TypeBuilder имя типа, его атрибуты и тип, который расширяет определенный тип.
DefineType(String, TypeAttributes)	Создает заданное TypeBuilder имя типа и атрибуты типа.
DefineType(String)	TypeBuilder Создает частный тип с указанным именем в этом модуле.
DefineTypeCore(String, TypeAttributes, Type, Type[], PackingSize, Int32)	При переопределении в производном классе создает объект TypeBuilder.
DefineUninitializedData(String, Int32, FieldAttributes)	Определяет неинициализированное поле данных в разделе SDATA переносимого исполняемого файла (PE).
DefineUninitializedDataCore(String, Int32, FieldAttributes)	При переопределении в производном классе определяет неинициализированное поле данных в разделе Sdata переносимого исполняемого файла (PE).
Equals(Object)	Возвращает значение, указывающее, равен ли этот экземпляр указанному объекту.
FindTypes(TypeFilter, Object)	Возвращает массив классов, принятых заданными критериями фильтра и фильтра. (Унаследовано от Module)
GetArrayMethod(Type, String, CallingConventions, Type, Type[])	Возвращает именованный метод в классе массива.
GetArrayMethodCore(Type, String, CallingConventions, Type, Type[])	При переопределении в производном классе возвращает именованный метод в классе массива.
GetCustomAttributes(Boolean)	Возвращает все настраиваемые атрибуты, примененные к текущему ModuleBuilder.
GetCustomAttributes(Type, Boolean)	Возвращает все настраиваемые атрибуты, примененные к текущему ModuleBuilder, и производные от указанного типа атрибута.
GetCustomAttributesData()	Возвращает сведения об атрибутах, примененных к текущему ModuleBuilderобъекту.CustomAttributeData
GetField(String, BindingFlags)	Возвращает поле уровня модуля, определенное в области SDATA переносимого исполняемого файла (PE), которое имеет указанные атрибуты имени и привязки.
GetField(String)	Возвращает поле с указанным именем. (Унаследовано от Module)
GetFieldMetadataToken(FieldInfo)	При переопределении в производном классе возвращает маркер метаданных для заданного FieldInfo относительно модуля.
GetFields()	Возвращает глобальные поля, определенные в модуле. (Унаследовано от Module)
GetFields(BindingFlags)	Возвращает все поля, определенные в области Sdata переносимого исполняемого файла (PE), соответствующего указанным флагам привязки.
GetHashCode()	Возвращает хэш-код для этого экземпляра.
GetMethod(String, BindingFlags, Binder, CallingConventions, Type[], ParameterModifier[])	Возвращает метод с указанным именем, сведениями о привязке, соглашениями о вызовах и типами параметров и модификаторами. (Унаследовано от Module)
GetMethod(String, Type[])	Возвращает метод с указанными типами имен и параметров. (Унаследовано от Module)
GetMethod(String)	Возвращает метод с указанным именем. (Унаследовано от Module)
GetMethodImpl(String, BindingFlags, Binder, CallingConventions, Type[], ParameterModifier[])	Возвращает метод уровня модуля, соответствующий указанному критерию.
GetMethodMetadataToken(ConstructorInfo)	При переопределении в производном классе возвращает маркер метаданных для заданного ConstructorInfo относительно модуля.
GetMethodMetadataToken(MethodInfo)	При переопределении в производном классе возвращает маркер метаданных для заданного MethodInfo относительно модуля.
GetMethods()	Возвращает глобальные методы, определенные в модуле. (Унаследовано от Module)
GetMethods(BindingFlags)	Возвращает все методы, определенные на уровне модуля для текущего ModuleBuilder, и соответствующие указанным флагам привязки.
GetObjectData(SerializationInfo, StreamingContext)	Устаревшие.. Предоставляет реализацию ISerializable для сериализованных объектов. (Унаследовано от Module)
GetPEKind(PortableExecutableKinds, ImageFileMachine)	Возвращает пару значений, указывающих характер кода в модуле и платформу, предназначенную для модуля.
GetSignatureMetadataToken(SignatureHelper)	При переопределении в производном классе возвращает маркер метаданных для заданного SignatureHelper относительно модуля.
GetStringMetadataToken(String)	При переопределении в производном классе возвращает маркер метаданных для заданной String константы относительно модуля.
GetType()	Возвращает Type текущего экземпляра. (Унаследовано от Object)
GetType(String, Boolean, Boolean)	Возвращает именованный тип, определенный в модуле, при необходимости игнорируя регистр имени типа. При необходимости вызывает исключение, если тип не найден.
GetType(String, Boolean)	Возвращает именованный тип, определенный в модуле, при необходимости игнорируя регистр имени типа.
GetType(String)	Возвращает именованный тип, определенный в модуле.
GetTypeMetadataToken(Type)	При переопределении в производном классе возвращает маркер метаданных для заданного Type относительно модуля.
GetTypes()	Возвращает все классы, определенные в этом модуле.
IsDefined(Type, Boolean)	Возвращает значение, указывающее, применен ли указанный тип атрибута к этому модулю.
IsResource()	Возвращает значение, указывающее, является ли объект ресурсом.
MemberwiseClone()	Создает неглубокую копию текущей Object. (Унаследовано от Object)
ResolveField(Int32, Type[], Type[])	Возвращает поле, определяемое указанным маркером метаданных, в контексте, определяемом указанными параметрами универсального типа.
ResolveField(Int32)	Возвращает поле, определяемое указанным маркером метаданных. (Унаследовано от Module)
ResolveMember(Int32, Type[], Type[])	Возвращает тип или элемент, определяемый указанным маркером метаданных, в контексте, определяемом указанными параметрами универсального типа.
ResolveMember(Int32)	Возвращает тип или элемент, определяемый указанным маркером метаданных. (Унаследовано от Module)
ResolveMethod(Int32, Type[], Type[])	Возвращает метод или конструктор, определяемый указанным маркером метаданных, в контексте, определяемом указанными параметрами универсального типа.
ResolveMethod(Int32)	Возвращает метод или конструктор, определяемый указанным маркером метаданных. (Унаследовано от Module)
ResolveSignature(Int32)	Возвращает большой двоичный объект подписи, определяемый маркером метаданных.
ResolveString(Int32)	Возвращает строку, определяемую указанным маркером метаданных.
ResolveType(Int32, Type[], Type[])	Возвращает тип, определяемый указанным маркером метаданных, в контексте, определяемом указанными параметрами универсального типа.
ResolveType(Int32)	Возвращает тип, определенный указанным маркером метаданных. (Унаследовано от Module)
SetCustomAttribute(ConstructorInfo, Byte[])	Применяет настраиваемый атрибут к этому модулю с помощью указанного двоичного большого объекта (BLOB), представляющего атрибут.
SetCustomAttribute(CustomAttributeBuilder)	Применяет настраиваемый атрибут к этому модулю с помощью пользовательского построителя атрибутов.
SetCustomAttributeCore(ConstructorInfo, ReadOnlySpan<Byte>)	При переопределении в производном классе задает настраиваемый атрибут для этой сборки.
ToString()	Возвращает имя модуля. (Унаследовано от Module)

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

Имя	Описание
GetCustomAttribute(Module, Type)	Извлекает настраиваемый атрибут указанного типа, применяемого к указанному модулю.
GetCustomAttribute<T>(Module)	Извлекает настраиваемый атрибут указанного типа, применяемого к указанному модулю.
GetCustomAttributes(Module, Type)	Извлекает коллекцию пользовательских атрибутов указанного типа, применяемого к указанному модулю.
GetCustomAttributes(Module)	Извлекает коллекцию пользовательских атрибутов, применяемых к указанному модулю.
GetCustomAttributes<T>(Module)	Извлекает коллекцию пользовательских атрибутов указанного типа, применяемого к указанному модулю.
GetModuleVersionId(Module)	Определяет и представляет модуль в динамической сборке.
HasModuleVersionId(Module)	Определяет и представляет модуль в динамической сборке.
IsDefined(Module, Type)	Указывает, применяются ли пользовательские атрибуты указанного типа к указанному модулю.