ModuleBuilder Sınıf

Tanım

Ad Alanı:

System.Reflection.Emit

Bütünleştirilmiş Kod:

mscorlib.dll

Dinamik derlemedeki bir modülü tanımlar ve temsil eder.

public ref class ModuleBuilder : System::Reflection::Module, System::Runtime::InteropServices::_ModuleBuilder

[System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.None)]
[System.Runtime.InteropServices.ComVisible(true)]
public class ModuleBuilder : System.Reflection.Module, System.Runtime.InteropServices._ModuleBuilder

[<System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.None)>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type ModuleBuilder = class
    inherit Module
    interface _ModuleBuilder

Public Class ModuleBuilder
Inherits Module
Implements _ModuleBuilder

Devralma

Object

Module

ModuleBuilder

Öznitelikler

ClassInterfaceAttribute ComVisibleAttribute

Uygulamalar

_ModuleBuilder

Örnekler

Aşağıdaki kod örneği, dinamik modül oluşturmak için öğesinin ModuleBuilder kullanımını gösterir. ModuleBuilder'ın bir oluşturucu yerine içinde AssemblyBuilderçağrılarak DefineDynamicModule oluşturulduğunu unutmayın.

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

Açıklamalar

örneğini ModuleBuilderalmak için yöntemini kullanın AssemblyBuilder.DefineDynamicModule .

Özellikler

Name	Description
Assembly	Bu örneğini tanımlayan dinamik derlemeyi ModuleBuilderalır.
CustomAttributes	Bu modülün özel özniteliklerini içeren bir koleksiyon alır. (Devralındığı yer: Module)
FullyQualifiedName	Bu modülün tam adını ve yolunu temsil eden bir String alır.
MDStreamVersion	Meta veri akışı sürümünü alır.
MetadataToken	Meta verilerdeki geçerli dinamik modülü tanımlayan bir belirteç alır.
ModuleHandle	Modül için bir tanıtıcı alır. (Devralındığı yer: Module)
ModuleVersionId	Modülün iki sürümünü ayırt etmek için kullanılabilecek evrensel olarak benzersiz bir tanımlayıcı (UUID) alır.
Name	Bunun bellek içi bir modül olduğunu belirten bir dize.
ScopeName	Dinamik modülün adını temsil eden bir dize alır.

Yöntemler

Name	Description
CreateGlobalFunctions()	Bu dinamik modül için genel işlev tanımlarını ve genel veri tanımlarını tamamlar.
DefineDocument(String, Guid, Guid, Guid)	Kaynak için bir belge tanımlar.
DefineEnum(String, TypeAttributes, Type)	Belirtilen türde adlı value__ tek bir statik olmayan alana sahip bir değer türü olan bir numaralandırma türünü tanımlar.
DefineGlobalMethod(String, MethodAttributes, CallingConventions, Type, Type[], Type[], Type[], Type[][], Type[][])	Belirtilen ada, özniteliklere, çağırma kuralına, dönüş türüne, dönüş türüne yönelik özel değiştiricilere, parametre türlerine ve parametre türleri için özel değiştiricilere sahip genel bir yöntem tanımlar.
DefineGlobalMethod(String, MethodAttributes, CallingConventions, Type, Type[])	Belirtilen ad, öznitelikler, çağırma kuralı, dönüş türü ve parametre türleri ile genel bir yöntem tanımlar.
DefineGlobalMethod(String, MethodAttributes, Type, Type[])	Belirtilen ad, öznitelikler, dönüş türü ve parametre türleriyle genel bir yöntem tanımlar.
DefineInitializedData(String, Byte[], FieldAttributes)	Taşınabilir yürütülebilir dosya (PE) dosyasının .sdata bölümünde başlatılan bir veri alanı tanımlar.
DefineManifestResource(String, Stream, ResourceAttributes)	Dinamik derlemeye katıştırılacak bildirim kaynağını temsil eden bir ikili büyük nesne (BLOB) tanımlar.
DefinePInvokeMethod(String, String, MethodAttributes, CallingConventions, Type, Type[], CallingConvention, CharSet)	Belirtilen ada, yöntemin tanımlandığı DLL'nin adına, yöntemin özniteliklerine, yöntemin çağırma kuralına, yöntemin dönüş türüne, yöntemin parametrelerinin türlerine ve PInvoke bayraklara sahip bir PInvoke yöntem tanımlar.
DefinePInvokeMethod(String, String, String, MethodAttributes, CallingConventions, Type, Type[], CallingConvention, CharSet)	Belirtilen ada, yöntemin tanımlandığı DLL'nin adına, yöntemin özniteliklerine, yöntemin çağırma kuralına, yöntemin dönüş türüne, yöntemin parametrelerinin türlerine ve PInvoke bayraklara sahip bir PInvoke yöntem tanımlar.
DefineResource(String, String, ResourceAttributes)	Bu modülde depolanacak belirli özniteliklerle adlandırılmış yönetilen ekli kaynağı tanımlar.
DefineResource(String, String)	Bu modülde depolanacak adlandırılmış yönetilen ekli kaynağı tanımlar.
DefineType(String, TypeAttributes, Type, Int32)	Belirli bir TypeBuilder tür adını, özniteliklerini, tanımlanan türün genişletilen türünü ve türün toplam boyutunu oluşturur.
DefineType(String, TypeAttributes, Type, PackingSize, Int32)	TypeBuilder Verilen tür adını, özniteliklerini, tanımlanan türün genişletilen türünü, tanımlı türün paketleme boyutunu ve tanımlı türün toplam boyutunu oluşturur.
DefineType(String, TypeAttributes, Type, PackingSize)	TypeBuilder Verilen tür adını, özniteliklerini, tanımlanan türün genişletilen türünü ve türün paketleme boyutunu oluşturur.
DefineType(String, TypeAttributes, Type, Type[])	Belirli bir TypeBuilder tür adını, özniteliklerini, tanımlı türün genişletilen türünü ve tanımlı türün uyguladığı arabirimleri oluşturur.
DefineType(String, TypeAttributes, Type)	Belirli bir TypeBuilder tür adını, özniteliklerini ve tanımlanan türün genişletilen türünü oluşturur.
DefineType(String, TypeAttributes)	TypeBuilder Verilen tür adını ve tür özniteliklerini oluşturur.
DefineType(String)	Bu modülde belirtilen ada sahip özel bir tür için bir TypeBuilder oluşturur.
DefineUninitializedData(String, Int32, FieldAttributes)	Taşınabilir yürütülebilir dosya (PE) dosyasının .sdata bölümünde başlatılmamış bir veri alanı tanımlar.
DefineUnmanagedResource(Byte[])	Baytlık bir opak ikili büyük nesne (BLOB) verilip yönetilmeyen bir ekli kaynak tanımlar.
DefineUnmanagedResource(String)	Win32 kaynak dosyasının adı verilen yönetilmeyen bir kaynağı tanımlar.
Equals(Object)	Bu örneğin belirtilen nesneye eşit olup olmadığını gösteren bir değer döndürür.
FindTypes(TypeFilter, Object)	Verilen filtre ve filtre ölçütleri tarafından kabul edilen bir sınıf dizisi döndürür. (Devralındığı yer: Module)
GetArrayMethod(Type, String, CallingConventions, Type, Type[])	Bir dizi sınıfında adlandırılmış yöntemi döndürür.
GetArrayMethodToken(Type, String, CallingConventions, Type, Type[])	Bir dizi sınıfındaki adlandırılmış yöntemin belirtecini döndürür.
GetConstructorToken(ConstructorInfo, IEnumerable<Type>)	Bu modülde belirtilen özniteliklere ve parametre türlerine sahip oluşturucuyu tanımlamak için kullanılan belirteci döndürür.
GetConstructorToken(ConstructorInfo)	Bu modülde belirtilen oluşturucuyu tanımlamak için kullanılan belirteci döndürür.
GetCustomAttributes(Boolean)	Geçerli ModuleBuilderöğesine uygulanmış olan tüm özel öznitelikleri döndürür.
GetCustomAttributes(Type, Boolean)	Geçerli ModuleBuilderöğesine uygulanmış olan ve belirtilen öznitelik türünden türetilen tüm özel öznitelikleri döndürür.
GetCustomAttributesData()	Nesne olarak ModuleBuilder ifade edilen geçerli CustomAttributeDataöğesine uygulanmış öznitelikler hakkında bilgi döndürür.
GetField(String, BindingFlags)	Belirtilen ad ve bağlama özniteliklerine sahip taşınabilir yürütülebilir (PE) dosyasının .sdata bölgesinde tanımlanan modül düzeyinde bir alan döndürür.
GetField(String)	Belirtilen ada sahip bir alan döndürür. (Devralındığı yer: Module)
GetFields()	Modülde tanımlanan genel alanları döndürür. (Devralındığı yer: Module)
GetFields(BindingFlags)	Taşınabilir yürütülebilir (PE) dosyasının .sdata bölgesinde tanımlanan ve belirtilen bağlama bayraklarıyla eşleşen tüm alanları döndürür.
GetFieldToken(FieldInfo)	Bu modülde belirtilen alanı tanımlamak için kullanılan belirteci döndürür.
GetHashCode()	Bu örneğin karma kodunu döndürür.
GetMethod(String, BindingFlags, Binder, CallingConventions, Type[], ParameterModifier[])	Belirtilen ada, bağlama bilgilerine, çağırma kuralına ve parametre türlerine ve değiştiricilere sahip bir yöntem döndürür. (Devralındığı yer: Module)
GetMethod(String, Type[])	Belirtilen ada ve parametre türlerine sahip bir yöntem döndürür. (Devralındığı yer: Module)
GetMethod(String)	Belirtilen ada sahip bir yöntem döndürür. (Devralındığı yer: Module)
GetMethodImpl(String, BindingFlags, Binder, CallingConventions, Type[], ParameterModifier[])	Belirtilen ölçütle eşleşen modül düzeyi yöntemini döndürür.
GetMethods()	Modülde tanımlanan genel yöntemleri döndürür. (Devralındığı yer: Module)
GetMethods(BindingFlags)	Geçerli ModuleBuilderiçin modül düzeyinde tanımlanmış ve belirtilen bağlama bayraklarıyla eşleşen tüm yöntemleri döndürür.
GetMethodToken(MethodInfo, IEnumerable<Type>)	Bu modülde belirtilen özniteliklere ve parametre türlerine sahip yöntemi tanımlamak için kullanılan belirteci döndürür.
GetMethodToken(MethodInfo)	Bu modülde belirtilen yöntemi tanımlamak için kullanılan belirteci döndürür.
GetObjectData(SerializationInfo, StreamingContext)	Serileştirilmiş nesneler için bir ISerializable uygulama sağlar. (Devralındığı yer: Module)
GetPEKind(PortableExecutableKinds, ImageFileMachine)	Bir modüldeki kodun doğasını ve modülün hedeflediği platformu gösteren bir değer çifti alır.
GetSignatureToken(Byte[], Int32)	Belirtilen karakter dizisine ve imza uzunluğuna sahip imza için bir belirteç tanımlar.
GetSignatureToken(SignatureHelper)	Belirtilen SignatureHelpertarafından tanımlanan imza için bir belirteç tanımlar.
GetSignerCertificate()	Bu modülün ait olduğu derlemenin Authenticode imzasında yer alan sertifikaya karşılık gelen bir X509Certificate nesne döndürür. Derleme Authenticode imzalanmamışsa döndürülür null .
GetStringConstant(String)	Modülün sabit havuzunda verilen dizenin belirtecini döndürür.
GetSymWriter()	Bu dinamik modülle ilişkili simge yazıcısını döndürür.
GetType()	Geçerli örneğin Type alır. (Devralındığı yer: Object)
GetType(String, Boolean, Boolean)	İsteğe bağlı olarak tür adının büyük/küçük harf durumunu yoksayarak modülde tanımlanan adlandırılmış türü alır. İsteğe bağlı olarak, tür bulunamazsa bir özel durum oluşturur.
GetType(String, Boolean)	İsteğe bağlı olarak tür adının büyük/küçük harf durumunu yoksayarak modülde tanımlanan adlandırılmış türü alır.
GetType(String)	Modülde tanımlanan adlandırılmış türü alır.
GetTypes()	Bu modülde tanımlanan tüm sınıfları döndürür.
GetTypeToken(String)	Belirtilen ada sahip türü tanımlamak için kullanılan belirteci döndürür.
GetTypeToken(Type)	Bu modülde belirtilen türü tanımlamak için kullanılan belirteci döndürür.
IsDefined(Type, Boolean)	Belirtilen öznitelik türünün bu modüle uygulanıp uygulanmadığını gösteren bir değer döndürür.
IsResource()	Nesnenin kaynak olup olmadığını belirten bir değer alır.
IsTransient()	Bu dinamik modülün geçici olup olmadığını gösteren bir değer döndürür.
MemberwiseClone()	Geçerli Objectbasit bir kopyasını oluşturur. (Devralındığı yer: Object)
ResolveField(Int32, Type[], Type[])	Belirtilen genel tür parametreleri tarafından tanımlanan bağlamda, belirtilen meta veri belirteci tarafından tanımlanan alanı döndürür.
ResolveField(Int32)	Belirtilen meta veri belirteci tarafından tanımlanan alanı döndürür. (Devralındığı yer: Module)
ResolveMember(Int32, Type[], Type[])	Belirtilen genel tür parametreleri tarafından tanımlanan bağlamda, belirtilen meta veri belirteci tarafından tanımlanan türü veya üyeyi döndürür.
ResolveMember(Int32)	Belirtilen meta veri belirteci tarafından tanımlanan türü veya üyeyi döndürür. (Devralındığı yer: Module)
ResolveMethod(Int32, Type[], Type[])	Belirtilen meta veri belirteci tarafından tanımlanan yöntemi veya oluşturucuyu, belirtilen genel tür parametreleri tarafından tanımlanan bağlamda döndürür.
ResolveMethod(Int32)	Belirtilen meta veri belirteci tarafından tanımlanan yöntemi veya oluşturucuyu döndürür. (Devralındığı yer: Module)
ResolveSignature(Int32)	Meta veri belirteci tarafından tanımlanan imza blobunu döndürür.
ResolveString(Int32)	Belirtilen meta veri belirteci tarafından tanımlanan dizeyi döndürür.
ResolveType(Int32, Type[], Type[])	Belirtilen genel tür parametreleri tarafından tanımlanan bağlamda, belirtilen meta veri belirteci tarafından tanımlanan türü döndürür.
ResolveType(Int32)	Belirtilen meta veri belirteci tarafından tanımlanan türü döndürür. (Devralındığı yer: Module)
SetCustomAttribute(ConstructorInfo, Byte[])	Özniteliği temsil eden belirtilen bir ikili büyük nesne (BLOB) kullanarak bu modüle özel bir öznitelik uygular.
SetCustomAttribute(CustomAttributeBuilder)	Özel öznitelik oluşturucu kullanarak bu modüle özel bir öznitelik uygular.
SetSymCustomAttribute(String, Byte[])	Bu yöntem hiçbir şey yapmaz.
SetUserEntryPoint(MethodInfo)	Kullanıcı giriş noktasını ayarlar.
ToString()	Modülün adını döndürür. (Devralındığı yer: Module)

Belirtik Arabirim Kullanımları

Name	Description
_Module.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Bir ad kümesini karşılık gelen bir dağıtma tanımlayıcısı kümesine eşler. (Devralındığı yer: Module)
_Module.GetTypeInfo(UInt32, UInt32, IntPtr)	Bir nesne için tür bilgilerini alır ve bu da bir arabirimin tür bilgisini almak için kullanılabilir. (Devralındığı yer: Module)
_Module.GetTypeInfoCount(UInt32)	Bir nesnenin sağladığı tür bilgisi arabirimlerinin sayısını alır (0 ya da 1). (Devralındığı yer: Module)
_Module.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Bir nesne tarafından kullanıma sunulan özelliklere ve yöntemlere erişim sağlar. (Devralındığı yer: Module)
_ModuleBuilder.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)	Bu üyenin açıklaması için bkz GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr). .
_ModuleBuilder.GetTypeInfo(UInt32, UInt32, IntPtr)	Bu üyenin açıklaması için bkz GetTypeInfo(UInt32, UInt32, IntPtr). .
_ModuleBuilder.GetTypeInfoCount(UInt32)	Bu üyenin açıklaması için bkz GetTypeInfoCount(UInt32). .
_ModuleBuilder.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)	Bu üyenin açıklaması için bkz Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr). .

Uzantı Metotları

Name	Description
GetCustomAttribute(Module, Type)	Belirtilen modüle uygulanan belirtilen türde özel bir özniteliği alır.
GetCustomAttribute<T>(Module)	Belirtilen modüle uygulanan belirtilen türde özel bir özniteliği alır.
GetCustomAttributes(Module, Type)	Belirtilen modüle uygulanan belirtilen türde özel özniteliklerden oluşan bir koleksiyonu alır.
GetCustomAttributes(Module)	Belirtilen modüle uygulanan özel öznitelik koleksiyonunu alır.
GetCustomAttributes<T>(Module)	Belirtilen modüle uygulanan belirtilen türde özel özniteliklerden oluşan bir koleksiyonu alır.
IsDefined(Module, Type)	Belirtilen türlerdeki özel özniteliklerin belirtilen modüle uygulanıp uygulanmadığını gösterir.