ModuleBuilder Osztály

Definíció

Névtér:

System.Reflection.Emit

Szerelvények:

netstandard.dll, System.Reflection.Emit.dll

Forrás:

ModuleBuilder.cs

Egy dinamikus szerelvényben lévő modult definiál és jelöl.

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

Öröklődés

Object

Module

ModuleBuilder

Példák

Az alábbi kódminta egy dinamikus modul létrehozását mutatja be ModuleBuilder . Vegye figyelembe, hogy a ModuleBuilder nem konstruktoron keresztül, hanem behívással DefineDynamicModuleAssemblyBuilderjön létre.

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

Megjegyzések

A példány lekéréséhez ModuleBuilderhasználja a metódust AssemblyBuilder.DefineDynamicModule .

Konstruktorok

Name	Description
ModuleBuilder()	Inicializálja a ModuleBuilder osztály új példányát.

Tulajdonságok

Name	Description
Assembly	Lekéri a példányt definiáló dinamikus szerelvényt ModuleBuilder.
CustomAttributes	Lekéri a modul egyéni attribútumait tartalmazó gyűjteményt. (Öröklődés forrása Module)
FullyQualifiedName	String Lekéri a modul teljes nevét és elérési útját.
MDStreamVersion	Lekéri a metaadat-stream verzióját.
MetadataToken	Lekéri a metaadatokban az aktuális dinamikus modult azonosító jogkivonatot.
ModuleHandle	Lekéri a modul fogópontját. (Öröklődés forrása Module)
ModuleVersionId	Egy univerzálisan egyedi azonosítót (UUID) kap, amely a modul két verziója közötti különbségtételre használható.
Name	Egy sztring, amely azt jelzi, hogy ez egy memóriabeli modul.
ScopeName	Lekéri a dinamikus modul nevét ábrázoló sztringet.

Metódusok

Name	Description
CreateGlobalFunctions()	Elvégzi a dinamikus modul globális függvénydefinícióit és globális adatdefinícióit.
CreateGlobalFunctionsCore()	Ha egy származtatott osztályban felül van bírálva, befejezi a dinamikus modul globális függvénydefinícióit és globális adatdefinícióit.
DefineDocument(String, Guid, Guid, Guid)	A forrás dokumentumát határozza meg.
DefineDocument(String, Guid)	A forrás dokumentumát határozza meg.
DefineDocumentCore(String, Guid)	Származtatott osztályban történő felülbíráláskor a forrásdokumentumot határozza meg.
DefineEnum(String, TypeAttributes, Type)	Olyan enumerálási típust határoz meg, amely egy értéktípus, amelynek egyetlen, nem statikus mezőjét a megadott típusnak hívják value__ .
DefineEnumCore(String, TypeAttributes, Type)	Ha egy származtatott osztályban felül van bírálva, egy olyan számbavételi típust határoz meg, amely egy olyan értéktípus, amelynek egyetlen nem statikus mezője van, value__ a megadott típushoz.
DefineGlobalMethod(String, MethodAttributes, CallingConventions, Type, Type[], Type[], Type[], Type[][], Type[][])	Definiál egy globális metódust a megadott névvel, attribútumokkal, hívási konvencióval, visszatérési típussal, a visszatérési típus egyéni módosítóival, a paramétertípusok paramétertípusaival és egyéni módosítóival.
DefineGlobalMethod(String, MethodAttributes, CallingConventions, Type, Type[])	Definiál egy globális metódust a megadott névvel, attribútumokkal, hívási konvencióval, visszatérési típussal és paramétertípusokkal.
DefineGlobalMethod(String, MethodAttributes, Type, Type[])	Definiál egy globális metódust a megadott névvel, attribútumokkal, visszatérési típussal és paramétertípusokkal.
DefineGlobalMethodCore(String, MethodAttributes, CallingConventions, Type, Type[], Type[], Type[], Type[][], Type[][])	Ha egy származtatott osztályban felül van bírálva, meghatároz egy globális metódust a megadott névvel, attribútumokkal, hívási konvencióval, visszatérési típussal, a visszatérési típus egyéni módosítóival, a paramétertípusok paramétertípusaival és egyéni módosítóival.
DefineInitializedData(String, Byte[], FieldAttributes)	Inicializált adatmezőt határoz meg a hordozható végrehajtható (PE) fájl .sdata szakaszában.
DefineInitializedDataCore(String, Byte[], FieldAttributes)	Ha felülbírál egy származtatott osztályban, inicializált adatmezőt határoz meg a hordozható végrehajtható (PE) fájl .sdata szakaszában.
DefinePInvokeMethod(String, String, MethodAttributes, CallingConventions, Type, Type[], CallingConvention, CharSet)	Definiál egy metódust PInvoke a megadott névvel, annak a DLL-nek a nevével, amelyben a metódus definiálva van, a metódus attribútumai, a metódus hívási konvenciójának, a metódus visszatérési típusának, a metódus paramétereinek típusainak és a PInvoke jelölőknek.
DefinePInvokeMethod(String, String, String, MethodAttributes, CallingConventions, Type, Type[], CallingConvention, CharSet)	Definiál egy metódust PInvoke a megadott névvel, annak a DLL-nek a nevével, amelyben a metódus definiálva van, a metódus attribútumai, a metódus hívási konvenciójának, a metódus visszatérési típusának, a metódus paramétereinek típusainak és a PInvoke jelölőknek.
DefinePInvokeMethodCore(String, String, String, MethodAttributes, CallingConventions, Type, Type[], CallingConvention, CharSet)	Ha felül van bírálva egy származtatott osztályban, meghatároz egy metódust PInvoke .
DefineType(String, TypeAttributes, Type, Int32)	TypeBuilder Egy adott típusnevet, attribútumokat, a definiált típus kiterjesztését és a típus teljes méretét adja meg.
DefineType(String, TypeAttributes, Type, PackingSize, Int32)	TypeBuilder Egy adott típusnevet, attribútumokat, a meghatározott típus által kiterjesztett típust, a megadott típus csomagolási méretét és a definiált típus teljes méretét adja meg.
DefineType(String, TypeAttributes, Type, PackingSize)	TypeBuilder Egy adott típusnevet, attribútumokat, a definiált típus kiterjesztését és a típus csomagolási méretét adja meg.
DefineType(String, TypeAttributes, Type, Type[])	TypeBuilder Egy adott típusnevet, attribútumokat, a definiált típus által kiterjesztett típust és a definiált típus által implementálható interfészeket építi fel.
DefineType(String, TypeAttributes, Type)	Létrehoz egy TypeBuilder adott típusnevet, annak attribútumait és a megadott típus által kiterjesztett típust.
DefineType(String, TypeAttributes)	TypeBuilder Egy adott típusnevet és típusattribútumot hoz létre.
DefineType(String)	Létrehoz egy TypeBuilder privát típust a modulban megadott névvel.
DefineTypeCore(String, TypeAttributes, Type, Type[], PackingSize, Int32)	Ha felül van bírálva egy származtatott osztályban, létrehoz egy TypeBuilder.
DefineUninitializedData(String, Int32, FieldAttributes)	A hordozható végrehajtható (PE) fájl .sdata szakaszában definiál egy nem inicializált adatmezőt.
DefineUninitializedDataCore(String, Int32, FieldAttributes)	Ha egy származtatott osztályban felülbírál, a hordozható végrehajtható (PE) fájl .sdata szakaszában definiál egy nem inicializált adatmezőt.
Equals(Object)	Olyan értéket ad vissza, amely jelzi, hogy ez a példány egyenlő-e a megadott objektummal.
FindTypes(TypeFilter, Object)	Az adott szűrő- és szűrőfeltételek által elfogadott osztálytömböt adja vissza. (Öröklődés forrása Module)
GetArrayMethod(Type, String, CallingConventions, Type, Type[])	Egy tömbosztály nevesített metódusát adja vissza.
GetArrayMethodCore(Type, String, CallingConventions, Type, Type[])	Ha felül van bírálva egy származtatott osztályban, egy tömbosztály nevesített metódusát adja vissza.
GetCustomAttributes(Boolean)	Az aktuálisra ModuleBuilderalkalmazott összes egyéni attribútumot adja vissza.
GetCustomAttributes(Type, Boolean)	Az aktuálisra ModuleBuilderalkalmazott összes egyéni attribútumot adja vissza, amely egy adott attribútumtípusból származik.
GetCustomAttributesData()	Az aktuálisra ModuleBuilderalkalmazott attribútumokra vonatkozó információkat adja vissza objektumként CustomAttributeData kifejezve.
GetField(String, BindingFlags)	A hordozható végrehajtható (PE) fájl .sdata régiójában definiált modulszintű mezőt ad vissza, amely a megadott név- és kötésattribútumokkal rendelkezik.
GetField(String)	A megadott névvel rendelkező mezőt ad vissza. (Öröklődés forrása Module)
GetFieldMetadataToken(FieldInfo)	Ha egy származtatott osztályban felül van bírálva, a modulhoz FieldInfo viszonyított metaadat-jogkivonatot adja vissza.
GetFields()	A modulban definiált globális mezőket adja vissza. (Öröklődés forrása Module)
GetFields(BindingFlags)	A hordozható végrehajtható (PE) fájl .sdata régiójában definiált összes mezőt visszaadja, amely megfelel a megadott kötésjelölőknek.
GetHashCode()	A példány kivonatkódját adja vissza.
GetMethod(String, BindingFlags, Binder, CallingConventions, Type[], ParameterModifier[])	A megadott névvel, kötési információkkal, hívási konvencióval és paramétertípusokkal és módosítókkal rendelkező metódust ad vissza. (Öröklődés forrása Module)
GetMethod(String, Type[])	A megadott névvel és paramétertípusokkal rendelkező metódust ad vissza. (Öröklődés forrása Module)
GetMethod(String)	A megadott névvel rendelkező metódust ad vissza. (Öröklődés forrása Module)
GetMethodImpl(String, BindingFlags, Binder, CallingConventions, Type[], ParameterModifier[])	A megadott feltételeknek megfelelő modulszintű metódust adja vissza.
GetMethodMetadataToken(ConstructorInfo)	Ha egy származtatott osztályban felül van bírálva, a modulhoz ConstructorInfo viszonyított metaadat-jogkivonatot adja vissza.
GetMethodMetadataToken(MethodInfo)	Ha egy származtatott osztályban felül van bírálva, a modulhoz MethodInfo viszonyított metaadat-jogkivonatot adja vissza.
GetMethods()	A modulban definiált globális metódusokat adja vissza. (Öröklődés forrása Module)
GetMethods(BindingFlags)	Az aktuális ModuleBuildermodul szintjén definiált és a megadott kötésjelölőknek megfelelő metódusokat adja vissza.
GetObjectData(SerializationInfo, StreamingContext)	Elavult. Implementációt ISerializable biztosít szerializált objektumokhoz. (Öröklődés forrása Module)
GetPEKind(PortableExecutableKinds, ImageFileMachine)	Lekéri a modul kódjának természetét és a modul által megcélzott platformot jelző értékpárokat.
GetSignatureMetadataToken(SignatureHelper)	Ha egy származtatott osztályban felül van bírálva, a modulhoz SignatureHelper viszonyított metaadat-jogkivonatot adja vissza.
GetStringMetadataToken(String)	Ha egy származtatott osztályban felül van bírálva, az adott String állandó metaadat-jogkivonatát adja vissza a modulhoz viszonyítva.
GetType()	Lekéri az Type aktuális példányt. (Öröklődés forrása Object)
GetType(String, Boolean, Boolean)	Lekéri a modulban definiált elnevezett típust, figyelmen kívül hagyva a típusnév esetét. Ha a típus nem található, kivételt is jelez.
GetType(String, Boolean)	Lekéri a modulban definiált elnevezett típust, figyelmen kívül hagyva a típusnév esetét.
GetType(String)	Lekéri a modulban definiált elnevezett típust.
GetTypeMetadataToken(Type)	Ha egy származtatott osztályban felül van bírálva, a modulhoz Type viszonyított metaadat-jogkivonatot adja vissza.
GetTypes()	A modulban definiált összes osztályt adja vissza.
IsDefined(Type, Boolean)	Olyan értéket ad vissza, amely jelzi, hogy a megadott attribútumtípust alkalmazták-e erre a modulra.
IsResource()	Beolvas egy értéket, amely jelzi, hogy az objektum erőforrás-e.
MemberwiseClone()	Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object)
ResolveField(Int32, Type[], Type[])	A megadott metaadat-jogkivonat által meghatározott mezőt adja vissza a megadott általános típusparaméterek által meghatározott környezetben.
ResolveField(Int32)	A megadott metaadat-jogkivonat által azonosított mezőt adja vissza. (Öröklődés forrása Module)
ResolveMember(Int32, Type[], Type[])	A megadott metaadat-jogkivonat által meghatározott típust vagy tagot adja vissza a megadott általános típusparaméterek által meghatározott környezetben.
ResolveMember(Int32)	A megadott metaadat-jogkivonat által azonosított típust vagy tagot adja vissza. (Öröklődés forrása Module)
ResolveMethod(Int32, Type[], Type[])	A megadott metaadat-jogkivonat által azonosított metódust vagy konstruktort adja vissza a megadott általános típusparaméterek által meghatározott környezetben.
ResolveMethod(Int32)	A megadott metaadat-jogkivonat által azonosított metódust vagy konstruktort adja vissza. (Öröklődés forrása Module)
ResolveSignature(Int32)	A metaadat-jogkivonat által azonosított aláírási blobot adja vissza.
ResolveString(Int32)	A megadott metaadat-jogkivonat által azonosított sztringet adja vissza.
ResolveType(Int32, Type[], Type[])	A megadott metaadat-jogkivonat által azonosított típust adja vissza a megadott általános típusparaméterek által meghatározott környezetben.
ResolveType(Int32)	A megadott metaadat-jogkivonat által azonosított típust adja vissza. (Öröklődés forrása Module)
SetCustomAttribute(ConstructorInfo, Byte[])	Egyéni attribútumot alkalmaz erre a modulra egy megadott nagy bináris objektum (BLOB) használatával, amely az attribútumot jelöli.
SetCustomAttribute(CustomAttributeBuilder)	Egyéni attribútumot alkalmaz erre a modulra egy egyéni attribútumszerkesztő használatával.
SetCustomAttributeCore(ConstructorInfo, ReadOnlySpan<Byte>)	Ha felül van bírálva egy származtatott osztályban, beállít egy egyéni attribútumot ezen a szerelvényen.
ToString()	A modul nevét adja vissza. (Öröklődés forrása Module)

Bővítő metódusok

Name	Description
GetCustomAttribute(Module, Type)	Lekéri a megadott típusú egyéni attribútumot, amelyet egy adott modulra alkalmaz.
GetCustomAttribute<T>(Module)	Lekéri a megadott típusú egyéni attribútumot, amelyet egy adott modulra alkalmaz.
GetCustomAttributes(Module, Type)	Lekéri a megadott típusú egyéni attribútumok gyűjteményét, amelyek egy adott modulra lesznek alkalmazva.
GetCustomAttributes(Module)	Egy adott modulra alkalmazott egyéni attribútumok gyűjteményét kéri le.
GetCustomAttributes<T>(Module)	Lekéri a megadott típusú egyéni attribútumok gyűjteményét, amelyek egy adott modulra lesznek alkalmazva.
GetModuleVersionId(Module)	Egy dinamikus szerelvényben lévő modult definiál és jelöl.
HasModuleVersionId(Module)	Egy dinamikus szerelvényben lévő modult definiál és jelöl.
IsDefined(Module, Type)	Azt jelzi, hogy a megadott típusú egyéni attribútumok alkalmazhatók-e egy adott modulra.