ModuleBuilder Класс

Определение

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

System.Reflection.Emit

Сборка:

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 создается путем вызова DefineDynamicModule в AssemblyBuilder, а не через конструктор.

using namespace System;
using namespace System::Reflection;
using namespace System::Reflection::Emit;
public ref class CodeGenerator
{
private:
   AssemblyBuilder^ myAssemblyBuilder;

public:
   CodeGenerator()
   {
      // Get the current application domain for the current thread.
      AppDomain^ myCurrentDomain = AppDomain::CurrentDomain;
      AssemblyName^ myAssemblyName = gcnew 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", String::typeid, FieldAttributes::Public );
      array<Type^>^myMethodArgs = {String::typeid};

      // Add 'MyMethod' method to the class, with the specified attribute and signature.
      MethodBuilder^ myMethod = myTypeBuilder->DefineMethod( "MyMethod", MethodAttributes::Public, CallingConventions::Standard, nullptr, 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();
   }

   property AssemblyBuilder^ MyAssembly 
   {
      AssemblyBuilder^ get()
      {
         return this->myAssemblyBuilder;
      }
   }
};

int main()
{
   CodeGenerator^ myCodeGenerator = gcnew 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 :{0}", 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 );
   array<Object^>^args = {"Hello."};
   Object^ myObject = Activator::CreateInstance( myType, nullptr, nullptr );
   myMethodInfo->Invoke( myObject, args );
}

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()	При переопределении в производном классе завершает определения глобальных функций и глобальные определения данных для этого динамического модуля.
DefineEnum(String, TypeAttributes, Type)	Определяет тип перечисления, который является типом значения с одним нестатическом полем, которое называется value__ указанного типа.
DefineEnumCore(String, TypeAttributes, Type)	При переопределении в производном классе определяет тип перечисления, который является типом значения с одним нестатическом полем, которое называется value__ указанного типа.
DefineGlobalMethod(String, MethodAttributes, CallingConventions, Type, Type[])	Определяет глобальный метод с указанным именем, атрибутами, соглашением о вызове, типом возвращаемого значения и типами параметров.
DefineGlobalMethod(String, MethodAttributes, CallingConventions, Type, Type[], Type[], Type[], 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)	Создает TypeBuilder для частного типа с указанным именем в этом модуле.
DefineType(String, TypeAttributes)	Создает TypeBuilder с именем типа и атрибутами типа.
DefineType(String, TypeAttributes, Type)	Создает TypeBuilder заданное имя типа, его атрибуты и тип, который расширяет определенный тип.
DefineType(String, TypeAttributes, Type, Int32)	Создает TypeBuilder с именем типа, атрибутами, типом, расширением определенного типа и общим размером типа.
DefineType(String, TypeAttributes, Type, PackingSize)	Создает TypeBuilder с именем типа, атрибутами, типом, расширением определенного типа и размером упаковки типа.
DefineType(String, TypeAttributes, Type, PackingSize, Int32)	Создает TypeBuilder с учетом имени типа, атрибутов, типа, который расширяет определенный тип, размер упаковки определенного типа и общий размер определенного типа.
DefineType(String, TypeAttributes, Type, Type[])	Создает 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)	Возвращает поле с указанным именем. (Унаследовано от Module)
GetField(String, BindingFlags)	Возвращает поле уровня модуля, определенное в области SDATA переносимого исполняемого файла (PE), которое имеет указанные атрибуты имени и привязки.
GetFieldMetadataToken(FieldInfo)	При переопределении в производном классе возвращает маркер метаданных для заданного FieldInfo относительно модуля.
GetFields()	Возвращает глобальные поля, определенные в модуле. (Унаследовано от Module)
GetFields(BindingFlags)	Возвращает все поля, определенные в области Sdata переносимого исполняемого файла (PE), соответствующего указанным флагам привязки.
GetHashCode()	Возвращает хэш-код для этого экземпляра.
GetMethod(String)	Возвращает метод с указанным именем. (Унаследовано от Module)
GetMethod(String, BindingFlags, Binder, CallingConventions, Type[], ParameterModifier[])	Возвращает метод с указанным именем, сведениями о привязке, соглашениями о вызовах и типами параметров и модификаторами. (Унаследовано от Module)
GetMethod(String, Type[])	Возвращает метод с указанными типами имен и параметров. (Унаследовано от 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 относительно модуля.
GetSignerCertificate()	Возвращает объект X509Certificate, соответствующий сертификату, включенном в подпись Authenticode сборки, к которой принадлежит этот модуль. Если сборка не была подписана Authenticode, возвращается null. (Унаследовано от Module)
GetStringMetadataToken(String)	При переопределении в производном классе возвращает маркер метаданных для заданной String константы относительно модуля.
GetType()	Возвращает Type текущего экземпляра. (Унаследовано от Object)
GetType(String)	Возвращает именованный тип, определенный в модуле.
GetType(String, Boolean)	Возвращает именованный тип, определенный в модуле, при необходимости игнорируя регистр имени типа.
GetType(String, Boolean, Boolean)	Возвращает именованный тип, определенный в модуле, при необходимости игнорируя регистр имени типа. При необходимости вызывает исключение, если тип не найден.
GetTypeMetadataToken(Type)	При переопределении в производном классе возвращает маркер метаданных для заданного Type относительно модуля.
GetTypes()	Возвращает все классы, определенные в этом модуле.
IsDefined(Type, Boolean)	Возвращает значение, указывающее, применен ли указанный тип атрибута к этому модулю.
IsResource()	Возвращает значение, указывающее, является ли объект ресурсом.
MemberwiseClone()	Создает неглубокую копию текущей Object. (Унаследовано от Object)
ResolveField(Int32)	Возвращает поле, определяемое указанным маркером метаданных. (Унаследовано от Module)
ResolveField(Int32, Type[], Type[])	Возвращает поле, определяемое указанным маркером метаданных, в контексте, определяемом указанными параметрами универсального типа.
ResolveMember(Int32)	Возвращает тип или элемент, определяемый указанным маркером метаданных. (Унаследовано от Module)
ResolveMember(Int32, Type[], Type[])	Возвращает тип или элемент, определяемый указанным маркером метаданных, в контексте, определяемом указанными параметрами универсального типа.
ResolveMethod(Int32)	Возвращает метод или конструктор, определяемый указанным маркером метаданных. (Унаследовано от Module)
ResolveMethod(Int32, Type[], Type[])	Возвращает метод или конструктор, определяемый указанным маркером метаданных, в контексте, определяемом указанными параметрами универсального типа.
ResolveSignature(Int32)	Возвращает большой двоичный объект подписи, определяемый маркером метаданных.
ResolveString(Int32)	Возвращает строку, определяемую указанным маркером метаданных.
ResolveType(Int32)	Возвращает тип, определенный указанным маркером метаданных. (Унаследовано от Module)
ResolveType(Int32, Type[], Type[])	Возвращает тип, определяемый указанным маркером метаданных, в контексте, определяемом указанными параметрами универсального типа.
SetCustomAttribute(ConstructorInfo, Byte[])	Применяет настраиваемый атрибут к этому модулю с помощью указанного двоичного большого объекта (BLOB), представляющего атрибут.
SetCustomAttribute(CustomAttributeBuilder)	Применяет настраиваемый атрибут к этому модулю с помощью пользовательского построителя атрибутов.
SetCustomAttributeCore(ConstructorInfo, ReadOnlySpan<Byte>)	При переопределении в производном классе задает настраиваемый атрибут для этой сборки.
ToString()	Возвращает имя модуля. (Унаследовано от Module)

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

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