AssemblyBuilder AssemblyBuilder AssemblyBuilder AssemblyBuilder Class

Definição

Define e representa um assembly dinâmico.Defines and represents a dynamic assembly.

public ref class AssemblyBuilder sealed : System::Reflection::Assembly, System::Runtime::InteropServices::_AssemblyBuilder
[System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.None)]
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class AssemblyBuilder : System.Reflection.Assembly, System.Runtime.InteropServices._AssemblyBuilder
type AssemblyBuilder = class
    inherit Assembly
    interface _AssemblyBuilder
Public NotInheritable Class AssemblyBuilder
Inherits Assembly
Implements _AssemblyBuilder
Herança
AssemblyBuilderAssemblyBuilderAssemblyBuilderAssemblyBuilder
Atributos
Implementações

Exemplos

O exemplo de código a seguir mostra como definir um assembly dinâmico com um módulo.The following code example shows how to define a dynamic assembly with one module. O módulo no assembly de exemplo contém um tipo, MyDynamicType, que tem um campo particular, uma propriedade que obtém e define o campo particular, construtores que inicializam o campo particular e um método que multiplica um número fornecido pelo usuário pelo campo particular valor e retorna o resultado.The module in the example assembly contains one type, MyDynamicType, which has a private field, a property that gets and sets the private field, constructors that initialize the private field, and a method that multiplies a user-supplied number by the private field value and returns the result.

AssemblyBuilderAccess.RunAndSaveé especificado quando o assembly é criado.AssemblyBuilderAccess.RunAndSave is specified when the assembly is created. O código do assembly é usado imediatamente e o assembly também é salvo em disco para que possa ser examinado com ILDASM. exe (desmontador de Il) ou usado em outro programa.The assembly code is used immediately, and the assembly is also saved to disk so that it can be examined with Ildasm.exe (IL Disassembler) or used in another program.

using namespace System;
using namespace System::Reflection;
using namespace System::Reflection::Emit;

void main()
{
    // An assembly consists of one or more modules, each of which
    // contains zero or more types. This code creates a single-module
    // assembly, the most common case. The module contains one type,
    // named "MyDynamicType", that has a private field, a property 
    // that gets and sets the private field, constructors that 
    // initialize the private field, and a method that multiplies 
    // a user-supplied number by the private field value and returns
    // the result. In Visual C++ the type might look like this:
    /*
      public ref class MyDynamicType
      {
      private:
          int m_number;

      public:
          MyDynamicType() : m_number(42) {};
          MyDynamicType(int initNumber) : m_number(initNumber) {};
      
          property int Number
          {
              int get() { return m_number; }
              void set(int value) { m_number = value; }
          }

          int MyMethod(int multiplier)
          {
              return m_number * multiplier;
          }
      };
    */
      
    AssemblyName^ aName = gcnew AssemblyName("DynamicAssemblyExample");
    AssemblyBuilder^ ab = 
        AppDomain::CurrentDomain->DefineDynamicAssembly(
            aName, 
            AssemblyBuilderAccess::RunAndSave);

    // For a single-module assembly, the module name is usually
    // the assembly name plus an extension.
    ModuleBuilder^ mb = 
        ab->DefineDynamicModule(aName->Name, aName->Name + ".dll");
      
    TypeBuilder^ tb = mb->DefineType(
        "MyDynamicType", 
         TypeAttributes::Public);

    // Add a private field of type int (Int32).
    FieldBuilder^ fbNumber = tb->DefineField(
        "m_number", 
        int::typeid, 
        FieldAttributes::Private);

    // Define a constructor that takes an integer argument and 
    // stores it in the private field. 
    array<Type^>^ parameterTypes = { int::typeid };
    ConstructorBuilder^ ctor1 = tb->DefineConstructor(
        MethodAttributes::Public, 
        CallingConventions::Standard, 
        parameterTypes);

    ILGenerator^ ctor1IL = ctor1->GetILGenerator();
    // For a constructor, argument zero is a reference to the new
    // instance. Push it on the stack before calling the base
    // class constructor. Specify the default constructor of the 
    // base class (System::Object) by passing an empty array of 
    // types (Type::EmptyTypes) to GetConstructor.
    ctor1IL->Emit(OpCodes::Ldarg_0);
    ctor1IL->Emit(OpCodes::Call, 
        Object::typeid->GetConstructor(Type::EmptyTypes));
    // Push the instance on the stack before pushing the argument
    // that is to be assigned to the private field m_number.
    ctor1IL->Emit(OpCodes::Ldarg_0);
    ctor1IL->Emit(OpCodes::Ldarg_1);
    ctor1IL->Emit(OpCodes::Stfld, fbNumber);
    ctor1IL->Emit(OpCodes::Ret);

    // Define a default constructor that supplies a default value
    // for the private field. For parameter types, pass the empty
    // array of types or pass nullptr.
    ConstructorBuilder^ ctor0 = tb->DefineConstructor(
        MethodAttributes::Public, 
        CallingConventions::Standard, 
        Type::EmptyTypes);

    ILGenerator^ ctor0IL = ctor0->GetILGenerator();
    ctor0IL->Emit(OpCodes::Ldarg_0);
    ctor0IL->Emit(OpCodes::Call, 
        Object::typeid->GetConstructor(Type::EmptyTypes));
    // For a constructor, argument zero is a reference to the new
    // instance. Push it on the stack before pushing the default
    // value on the stack.
    ctor0IL->Emit(OpCodes::Ldarg_0);
    ctor0IL->Emit(OpCodes::Ldc_I4_S, 42);
    ctor0IL->Emit(OpCodes::Stfld, fbNumber);
    ctor0IL->Emit(OpCodes::Ret);

    // Define a property named Number that gets and sets the private 
    // field.
    //
    // The last argument of DefineProperty is nullptr, because the
    // property has no parameters. (If you don't specify nullptr, you must
    // specify an array of Type objects. For a parameterless property,
    // use the built-in array with no elements: Type::EmptyTypes)
    PropertyBuilder^ pbNumber = tb->DefineProperty(
        "Number", 
        PropertyAttributes::HasDefault, 
        int::typeid, 
        nullptr);
      
    // The property "set" and property "get" methods require a special
    // set of attributes.
    MethodAttributes getSetAttr = MethodAttributes::Public | 
        MethodAttributes::SpecialName | MethodAttributes::HideBySig;

    // Define the "get" accessor method for Number. The method returns
    // an integer and has no arguments. (Note that nullptr could be 
    // used instead of Types::EmptyTypes)
    MethodBuilder^ mbNumberGetAccessor = tb->DefineMethod(
        "get_Number", 
        getSetAttr, 
        int::typeid, 
        Type::EmptyTypes);
      
    ILGenerator^ numberGetIL = mbNumberGetAccessor->GetILGenerator();
    // For an instance property, argument zero is the instance. Load the 
    // instance, then load the private field and return, leaving the
    // field value on the stack.
    numberGetIL->Emit(OpCodes::Ldarg_0);
    numberGetIL->Emit(OpCodes::Ldfld, fbNumber);
    numberGetIL->Emit(OpCodes::Ret);
    
    // Define the "set" accessor method for Number, which has no return
    // type and takes one argument of type int (Int32).
    MethodBuilder^ mbNumberSetAccessor = tb->DefineMethod(
        "set_Number", 
        getSetAttr, 
        nullptr, 
        gcnew array<Type^> { int::typeid });
      
    ILGenerator^ numberSetIL = mbNumberSetAccessor->GetILGenerator();
    // Load the instance and then the numeric argument, then store the
    // argument in the field.
    numberSetIL->Emit(OpCodes::Ldarg_0);
    numberSetIL->Emit(OpCodes::Ldarg_1);
    numberSetIL->Emit(OpCodes::Stfld, fbNumber);
    numberSetIL->Emit(OpCodes::Ret);
      
    // Last, map the "get" and "set" accessor methods to the 
    // PropertyBuilder. The property is now complete. 
    pbNumber->SetGetMethod(mbNumberGetAccessor);
    pbNumber->SetSetMethod(mbNumberSetAccessor);

    // Define a method that accepts an integer argument and returns
    // the product of that integer and the private field m_number. This
    // time, the array of parameter types is created on the fly.
    MethodBuilder^ meth = tb->DefineMethod(
        "MyMethod", 
        MethodAttributes::Public, 
        int::typeid, 
        gcnew array<Type^> { int::typeid });

    ILGenerator^ methIL = meth->GetILGenerator();
    // To retrieve the private instance field, load the instance it
    // belongs to (argument zero). After loading the field, load the 
    // argument one and then multiply. Return from the method with 
    // the return value (the product of the two numbers) on the 
    // execution stack.
    methIL->Emit(OpCodes::Ldarg_0);
    methIL->Emit(OpCodes::Ldfld, fbNumber);
    methIL->Emit(OpCodes::Ldarg_1);
    methIL->Emit(OpCodes::Mul);
    methIL->Emit(OpCodes::Ret);

    // Finish the type->
    Type^ t = tb->CreateType();
     
    // The following line saves the single-module assembly. This
    // requires AssemblyBuilderAccess to include Save. You can now
    // type "ildasm MyDynamicAsm.dll" at the command prompt, and 
    // examine the assembly. You can also write a program that has
    // a reference to the assembly, and use the MyDynamicType type.
    // 
    ab->Save(aName->Name + ".dll");

    // Because AssemblyBuilderAccess includes Run, the code can be
    // executed immediately. Start by getting reflection objects for
    // the method and the property.
    MethodInfo^ mi = t->GetMethod("MyMethod");
    PropertyInfo^ pi = t->GetProperty("Number");
  
    // Create an instance of MyDynamicType using the default 
    // constructor. 
    Object^ o1 = Activator::CreateInstance(t);

    // Display the value of the property, then change it to 127 and 
    // display it again. Use nullptr to indicate that the property
    // has no index.
    Console::WriteLine("o1->Number: {0}", pi->GetValue(o1, nullptr));
    pi->SetValue(o1, 127, nullptr);
    Console::WriteLine("o1->Number: {0}", pi->GetValue(o1, nullptr));

    // Call MyMethod, passing 22, and display the return value, 22
    // times 127. Arguments must be passed as an array, even when
    // there is only one.
    array<Object^>^ arguments = { 22 };
    Console::WriteLine("o1->MyMethod(22): {0}", 
        mi->Invoke(o1, arguments));

    // Create an instance of MyDynamicType using the constructor
    // that specifies m_Number. The constructor is identified by
    // matching the types in the argument array. In this case, 
    // the argument array is created on the fly. Display the 
    // property value.
    Object^ o2 = Activator::CreateInstance(t, 
        gcnew array<Object^> { 5280 });
    Console::WriteLine("o2->Number: {0}", pi->GetValue(o2, nullptr));
};

/* This code produces the following output:

o1->Number: 42
o1->Number: 127
o1->MyMethod(22): 2794
o2->Number: 5280
 */
using System;
using System.Reflection;
using System.Reflection.Emit;

class DemoAssemblyBuilder
{
    public static void Main()
    {
        // An assembly consists of one or more modules, each of which
        // contains zero or more types. This code creates a single-module
        // assembly, the most common case. The module contains one type,
        // named "MyDynamicType", that has a private field, a property 
        // that gets and sets the private field, constructors that 
        // initialize the private field, and a method that multiplies 
        // a user-supplied number by the private field value and returns
        // the result. In C# the type might look like this:
        /*
        public class MyDynamicType
        {
            private int m_number;
        
            public MyDynamicType() : this(42) {}
            public MyDynamicType(int initNumber)
            {
                m_number = initNumber;
            }

            public int Number
            {
                get { return m_number; }
                set { m_number = value; }
            }

            public int MyMethod(int multiplier)
            {
                return m_number * multiplier;
            }
        }
        */
      
        AssemblyName aName = new AssemblyName("DynamicAssemblyExample");
        AssemblyBuilder ab = 
            AppDomain.CurrentDomain.DefineDynamicAssembly(
                aName, 
                AssemblyBuilderAccess.RunAndSave);

        // For a single-module assembly, the module name is usually
        // the assembly name plus an extension.
        ModuleBuilder mb = 
            ab.DefineDynamicModule(aName.Name, aName.Name + ".dll");
      
        TypeBuilder tb = mb.DefineType(
            "MyDynamicType", 
             TypeAttributes.Public);

        // Add a private field of type int (Int32).
        FieldBuilder fbNumber = tb.DefineField(
            "m_number", 
            typeof(int), 
            FieldAttributes.Private);

        // Define a constructor that takes an integer argument and 
        // stores it in the private field. 
        Type[] parameterTypes = { typeof(int) };
        ConstructorBuilder ctor1 = tb.DefineConstructor(
            MethodAttributes.Public, 
            CallingConventions.Standard, 
            parameterTypes);

        ILGenerator ctor1IL = ctor1.GetILGenerator();
        // For a constructor, argument zero is a reference to the new
        // instance. Push it on the stack before calling the base
        // class constructor. Specify the default constructor of the 
        // base class (System.Object) by passing an empty array of 
        // types (Type.EmptyTypes) to GetConstructor.
        ctor1IL.Emit(OpCodes.Ldarg_0);
        ctor1IL.Emit(OpCodes.Call, 
            typeof(object).GetConstructor(Type.EmptyTypes));
        // Push the instance on the stack before pushing the argument
        // that is to be assigned to the private field m_number.
        ctor1IL.Emit(OpCodes.Ldarg_0);
        ctor1IL.Emit(OpCodes.Ldarg_1);
        ctor1IL.Emit(OpCodes.Stfld, fbNumber);
        ctor1IL.Emit(OpCodes.Ret);

        // Define a default constructor that supplies a default value
        // for the private field. For parameter types, pass the empty
        // array of types or pass null.
        ConstructorBuilder ctor0 = tb.DefineConstructor(
            MethodAttributes.Public, 
            CallingConventions.Standard, 
            Type.EmptyTypes);

        ILGenerator ctor0IL = ctor0.GetILGenerator();
        // For a constructor, argument zero is a reference to the new
        // instance. Push it on the stack before pushing the default
        // value on the stack, then call constructor ctor1.
        ctor0IL.Emit(OpCodes.Ldarg_0);
        ctor0IL.Emit(OpCodes.Ldc_I4_S, 42);
        ctor0IL.Emit(OpCodes.Call, ctor1);
        ctor0IL.Emit(OpCodes.Ret);

        // Define a property named Number that gets and sets the private 
        // field.
        //
        // The last argument of DefineProperty is null, because the
        // property has no parameters. (If you don't specify null, you must
        // specify an array of Type objects. For a parameterless property,
        // use the built-in array with no elements: Type.EmptyTypes)
        PropertyBuilder pbNumber = tb.DefineProperty(
            "Number", 
            PropertyAttributes.HasDefault, 
            typeof(int), 
            null);
      
        // The property "set" and property "get" methods require a special
        // set of attributes.
        MethodAttributes getSetAttr = MethodAttributes.Public | 
            MethodAttributes.SpecialName | MethodAttributes.HideBySig;

        // Define the "get" accessor method for Number. The method returns
        // an integer and has no arguments. (Note that null could be 
        // used instead of Types.EmptyTypes)
        MethodBuilder mbNumberGetAccessor = tb.DefineMethod(
            "get_Number", 
            getSetAttr, 
            typeof(int), 
            Type.EmptyTypes);
      
        ILGenerator numberGetIL = mbNumberGetAccessor.GetILGenerator();
        // For an instance property, argument zero is the instance. Load the 
        // instance, then load the private field and return, leaving the
        // field value on the stack.
        numberGetIL.Emit(OpCodes.Ldarg_0);
        numberGetIL.Emit(OpCodes.Ldfld, fbNumber);
        numberGetIL.Emit(OpCodes.Ret);
        
        // Define the "set" accessor method for Number, which has no return
        // type and takes one argument of type int (Int32).
        MethodBuilder mbNumberSetAccessor = tb.DefineMethod(
            "set_Number", 
            getSetAttr, 
            null, 
            new Type[] { typeof(int) });
      
        ILGenerator numberSetIL = mbNumberSetAccessor.GetILGenerator();
        // Load the instance and then the numeric argument, then store the
        // argument in the field.
        numberSetIL.Emit(OpCodes.Ldarg_0);
        numberSetIL.Emit(OpCodes.Ldarg_1);
        numberSetIL.Emit(OpCodes.Stfld, fbNumber);
        numberSetIL.Emit(OpCodes.Ret);
      
        // Last, map the "get" and "set" accessor methods to the 
        // PropertyBuilder. The property is now complete. 
        pbNumber.SetGetMethod(mbNumberGetAccessor);
        pbNumber.SetSetMethod(mbNumberSetAccessor);

        // Define a method that accepts an integer argument and returns
        // the product of that integer and the private field m_number. This
        // time, the array of parameter types is created on the fly.
        MethodBuilder meth = tb.DefineMethod(
            "MyMethod", 
            MethodAttributes.Public, 
            typeof(int), 
            new Type[] { typeof(int) });

        ILGenerator methIL = meth.GetILGenerator();
        // To retrieve the private instance field, load the instance it
        // belongs to (argument zero). After loading the field, load the 
        // argument one and then multiply. Return from the method with 
        // the return value (the product of the two numbers) on the 
        // execution stack.
        methIL.Emit(OpCodes.Ldarg_0);
        methIL.Emit(OpCodes.Ldfld, fbNumber);
        methIL.Emit(OpCodes.Ldarg_1);
        methIL.Emit(OpCodes.Mul);
        methIL.Emit(OpCodes.Ret);

        // Finish the type.
        Type t = tb.CreateType();
     
        // The following line saves the single-module assembly. This
        // requires AssemblyBuilderAccess to include Save. You can now
        // type "ildasm MyDynamicAsm.dll" at the command prompt, and 
        // examine the assembly. You can also write a program that has
        // a reference to the assembly, and use the MyDynamicType type.
        // 
        ab.Save(aName.Name + ".dll");

        // Because AssemblyBuilderAccess includes Run, the code can be
        // executed immediately. Start by getting reflection objects for
        // the method and the property.
        MethodInfo mi = t.GetMethod("MyMethod");
        PropertyInfo pi = t.GetProperty("Number");
  
        // Create an instance of MyDynamicType using the default 
        // constructor. 
        object o1 = Activator.CreateInstance(t);

        // Display the value of the property, then change it to 127 and 
        // display it again. Use null to indicate that the property
        // has no index.
        Console.WriteLine("o1.Number: {0}", pi.GetValue(o1, null));
        pi.SetValue(o1, 127, null);
        Console.WriteLine("o1.Number: {0}", pi.GetValue(o1, null));

        // Call MyMethod, passing 22, and display the return value, 22
        // times 127. Arguments must be passed as an array, even when
        // there is only one.
        object[] arguments = { 22 };
        Console.WriteLine("o1.MyMethod(22): {0}", 
            mi.Invoke(o1, arguments));

        // Create an instance of MyDynamicType using the constructor
        // that specifies m_Number. The constructor is identified by
        // matching the types in the argument array. In this case, 
        // the argument array is created on the fly. Display the 
        // property value.
        object o2 = Activator.CreateInstance(t, 
            new object[] { 5280 });
        Console.WriteLine("o2.Number: {0}", pi.GetValue(o2, null));
    }
}

/* This code produces the following output:

o1.Number: 42
o1.Number: 127
o1.MyMethod(22): 2794
o2.Number: 5280
 */
Imports System
Imports System.Reflection
Imports System.Reflection.Emit

Class DemoAssemblyBuilder

    Public Shared Sub Main()

        ' An assembly consists of one or more modules, each of which
        ' contains zero or more types. This code creates a single-module
        ' assembly, the most common case. The module contains one type,
        ' named "MyDynamicType", that has a private field, a property 
        ' that gets and sets the private field, constructors that 
        ' initialize the private field, and a method that multiplies
        ' a user-supplied number by the private field value and returns 
        ' the result. The code might look like this in Visual Basic:
        '
        'Public Class MyDynamicType
        '    Private m_number As Integer
        '
        '    Public Sub New()
        '        Me.New(42)
        '    End Sub
        '
        '    Public Sub New(ByVal initNumber As Integer)
        '        m_number = initNumber
        '    End Sub
        '
        '    Public Property Number As Integer
        '        Get
        '            Return m_number
        '        End Get
        '        Set
        '            m_Number = Value
        '        End Set
        '    End Property
        '
        '    Public Function MyMethod(ByVal multiplier As Integer) As Integer
        '        Return m_Number * multiplier
        '    End Function
        'End Class
      
        Dim aName As New AssemblyName("DynamicAssemblyExample")
        Dim ab As AssemblyBuilder = _
            AppDomain.CurrentDomain.DefineDynamicAssembly( _
                aName, _
                AssemblyBuilderAccess.RunAndSave)

        ' For a single-module assembly, the module name is usually
        ' the assembly name plus an extension.
        Dim mb As ModuleBuilder = ab.DefineDynamicModule( _
            aName.Name, _
            aName.Name & ".dll")
      
        Dim tb As TypeBuilder = _
            mb.DefineType("MyDynamicType", TypeAttributes.Public)

        ' Add a private field of type Integer (Int32).
        Dim fbNumber As FieldBuilder = tb.DefineField( _
            "m_number", _
            GetType(Integer), _
            FieldAttributes.Private)

        ' Define a constructor that takes an integer argument and 
        ' stores it in the private field. 
        Dim parameterTypes() As Type = { GetType(Integer) }
        Dim ctor1 As ConstructorBuilder = _
            tb.DefineConstructor( _
                MethodAttributes.Public, _
                CallingConventions.Standard, _
                parameterTypes)

        Dim ctor1IL As ILGenerator = ctor1.GetILGenerator()
        ' For a constructor, argument zero is a reference to the new
        ' instance. Push it on the stack before calling the base
        ' class constructor. Specify the default constructor of the 
        ' base class (System.Object) by passing an empty array of 
        ' types (Type.EmptyTypes) to GetConstructor.
        ctor1IL.Emit(OpCodes.Ldarg_0)
        ctor1IL.Emit(OpCodes.Call, _
            GetType(Object).GetConstructor(Type.EmptyTypes))
        ' Push the instance on the stack before pushing the argument
        ' that is to be assigned to the private field m_number.
        ctor1IL.Emit(OpCodes.Ldarg_0)
        ctor1IL.Emit(OpCodes.Ldarg_1)
        ctor1IL.Emit(OpCodes.Stfld, fbNumber)
        ctor1IL.Emit(OpCodes.Ret)

        ' Define a default constructor that supplies a default value
        ' for the private field. For parameter types, pass the empty
        ' array of types or pass Nothing.
        Dim ctor0 As ConstructorBuilder = tb.DefineConstructor( _
            MethodAttributes.Public, _
            CallingConventions.Standard, _
            Type.EmptyTypes)

        Dim ctor0IL As ILGenerator = ctor0.GetILGenerator()
        ' For a constructor, argument zero is a reference to the new
        ' instance. Push it on the stack before pushing the default
        ' value on the stack, then call constructor ctor1.
        ctor0IL.Emit(OpCodes.Ldarg_0)
        ctor0IL.Emit(OpCodes.Ldc_I4_S, 42)
        ctor0IL.Emit(OpCodes.Call, ctor1)
        ctor0IL.Emit(OpCodes.Ret)

        ' Define a property named Number that gets and sets the private 
        ' field.
        '
        ' The last argument of DefineProperty is Nothing, because the
        ' property has no parameters. (If you don't specify Nothing, you must
        ' specify an array of Type objects. For a parameterless property,
        ' use the built-in array with no elements: Type.EmptyTypes)
        Dim pbNumber As PropertyBuilder = tb.DefineProperty( _
            "Number", _
            PropertyAttributes.HasDefault, _
            GetType(Integer), _
            Nothing)
      
        ' The property Set and property Get methods require a special
        ' set of attributes.
        Dim getSetAttr As MethodAttributes = _
            MethodAttributes.Public Or MethodAttributes.SpecialName _
                Or MethodAttributes.HideBySig

        ' Define the "get" accessor method for Number. The method returns
        ' an integer and has no arguments. (Note that Nothing could be 
        ' used instead of Types.EmptyTypes)
        Dim mbNumberGetAccessor As MethodBuilder = tb.DefineMethod( _
            "get_Number", _
            getSetAttr, _
            GetType(Integer), _
            Type.EmptyTypes)
      
        Dim numberGetIL As ILGenerator = mbNumberGetAccessor.GetILGenerator()
        ' For an instance property, argument zero is the instance. Load the 
        ' instance, then load the private field and return, leaving the
        ' field value on the stack.
        numberGetIL.Emit(OpCodes.Ldarg_0)
        numberGetIL.Emit(OpCodes.Ldfld, fbNumber)
        numberGetIL.Emit(OpCodes.Ret)
        
        ' Define the "set" accessor method for Number, which has no return
        ' type and takes one argument of type Integer (Int32).
        Dim mbNumberSetAccessor As MethodBuilder = _
            tb.DefineMethod( _
                "set_Number", _
                getSetAttr, _
                Nothing, _
                New Type() { GetType(Integer) })
      
        Dim numberSetIL As ILGenerator = mbNumberSetAccessor.GetILGenerator()
        ' Load the instance and then the numeric argument, then store the
        ' argument in the field.
        numberSetIL.Emit(OpCodes.Ldarg_0)
        numberSetIL.Emit(OpCodes.Ldarg_1)
        numberSetIL.Emit(OpCodes.Stfld, fbNumber)
        numberSetIL.Emit(OpCodes.Ret)
      
        ' Last, map the "get" and "set" accessor methods to the 
        ' PropertyBuilder. The property is now complete. 
        pbNumber.SetGetMethod(mbNumberGetAccessor)
        pbNumber.SetSetMethod(mbNumberSetAccessor)

        ' Define a method that accepts an integer argument and returns
        ' the product of that integer and the private field m_number. This
        ' time, the array of parameter types is created on the fly.
        Dim meth As MethodBuilder = tb.DefineMethod( _
            "MyMethod", _
            MethodAttributes.Public, _
            GetType(Integer), _
            New Type() { GetType(Integer) })

        Dim methIL As ILGenerator = meth.GetILGenerator()
        ' To retrieve the private instance field, load the instance it
        ' belongs to (argument zero). After loading the field, load the 
        ' argument one and then multiply. Return from the method with 
        ' the return value (the product of the two numbers) on the 
        ' execution stack.
        methIL.Emit(OpCodes.Ldarg_0)
        methIL.Emit(OpCodes.Ldfld, fbNumber)
        methIL.Emit(OpCodes.Ldarg_1)
        methIL.Emit(OpCodes.Mul)
        methIL.Emit(OpCodes.Ret)

        ' Finish the type.
        Dim t As Type = tb.CreateType()
     
        ' The following line saves the single-module assembly. This
        ' requires AssemblyBuilderAccess to include Save. You can now
        ' type "ildasm MyDynamicAsm.dll" at the command prompt, and 
        ' examine the assembly. You can also write a program that has
        ' a reference to the assembly, and use the MyDynamicType type.
        ' 
        ab.Save(aName.Name & ".dll") 

        ' Because AssemblyBuilderAccess includes Run, the code can be
        ' executed immediately. Start by getting reflection objects for
        ' the method and the property.
        Dim mi As MethodInfo = t.GetMethod("MyMethod")
        Dim pi As PropertyInfo = t.GetProperty("Number")
  
        ' Create an instance of MyDynamicType using the default 
        ' constructor. 
        Dim o1 As Object = Activator.CreateInstance(t)

        ' Display the value of the property, then change it to 127 and 
        ' display it again. Use Nothing to indicate that the property
        ' has no index.
        Console.WriteLine("o1.Number: {0}", pi.GetValue(o1, Nothing))
        pi.SetValue(o1, 127, Nothing)
        Console.WriteLine("o1.Number: {0}", pi.GetValue(o1, Nothing))

        ' Call MyMethod, passing 22, and display the return value, 22
        ' times 127. Arguments must be passed as an array, even when
        ' there is only one.
        Dim arguments() As Object = { 22 }
        Console.WriteLine("o1.MyMethod(22): {0}", _
            mi.Invoke(o1, arguments))

        ' Create an instance of MyDynamicType using the constructor
        ' that specifies m_Number. The constructor is identified by
        ' matching the types in the argument array. In this case, 
        ' the argument array is created on the fly. Display the 
        ' property value.
        Dim o2 As Object = Activator.CreateInstance(t, _
            New Object() { 5280 })
        Console.WriteLine("o2.Number: {0}", pi.GetValue(o2, Nothing))
      
    End Sub  
End Class

' This code produces the following output:
'
'o1.Number: 42
'o1.Number: 127
'o1.MyMethod(22): 2794
'o2.Number: 5280

Comentários

Um assembly dinâmico é um assembly que é criado usando as APIs de emissão de reflexão.A dynamic assembly is an assembly that is created using the Reflection Emit APIs. Os módulos dinâmicos no assembly são salvos quando o assembly dinâmico é salvo usando o Save método.The dynamic modules in the assembly are saved when the dynamic assembly is saved using the Save method. Para gerar um executável, o SetEntryPoint método deve ser chamado para identificar o método que é o ponto de entrada para o assembly.To generate an executable, the SetEntryPoint method must be called to identify the method that is the entry point to the assembly. Os assemblies são salvos como DLLs por padrão, a SetEntryPoint menos que o método solicite a geração de um aplicativo de console ou um aplicativo baseado no Windows.Assemblies are saved as DLLs by default, unless the SetEntryPoint method requests the generation of a console application or a Windows-based application.

Se um assembly dinâmico contiver mais de um módulo dinâmico, o nome do arquivo de manifesto do assembly deverá corresponder ao nome do módulo que é especificado como o primeiro DefineDynamicModule argumento para o método.If a dynamic assembly contains more than one dynamic module, the assembly's manifest file name should match the module's name that is specified as the first argument to the DefineDynamicModule method.

Alguns métodos na classe base Assembly , GetModules como e GetLoadedModules, não funcionarão corretamente quando chamados de AssemblyBuilder objetos.Some methods on the base Assembly class, such as GetModules and GetLoadedModules, will not work correctly when called from AssemblyBuilder objects. Você pode carregar o assembly dinâmico definido e chamar os métodos no assembly carregado.You can load the defined dynamic assembly and call the methods on the loaded assembly. Por exemplo, para garantir que os módulos de recursos sejam incluídos na lista de módulos retornados GetModules , chame no Assembly objeto Loaded.For example, to ensure that resource modules are included in the returned module list, call GetModules on the loaded Assembly object.

A assinatura de um assembly dinâmico usando KeyPair o não é eficaz até que o assembly seja salvo em disco.The signing of a dynamic assembly using KeyPair is not effective until the assembly is saved to disk. Portanto, nomes fortes não funcionarão com assemblies dinâmicos transitórios.So, strong names will not work with transient dynamic assemblies.

Para obter um AssemblyBuilder objeto, use o AppDomain.DefineDynamicAssembly método.To get an AssemblyBuilder object, use the AppDomain.DefineDynamicAssembly method.

Reflexão Emite cenários de assembly dinâmicoReflection emit dynamic assembly scenarios

Veja a seguir alguns aspectos a serem considerados ao usar AssemblyBuilder a classe para criar assemblies dinâmicos.The following are some things to consider when using the AssemblyBuilder class to create dynamic assemblies.

Módulos dinâmicosDynamic modules

A emissão de reflexão dá suporte à criação de módulos dinâmicos definidos em assemblies dinâmicos.Reflection emit supports the creation of dynamic modules defined in dynamic assemblies. Um módulo dinâmico criado em um assembly dinâmico pode ser transitório ou persistente.A dynamic module created in a dynamic assembly can be transient or persistable.

Restrições em referências de tipoRestrictions on type references

Os assemblies podem referenciar tipos definidos em outro assembly.Assemblies can reference types defined in another assembly. Um assembly dinâmico transitório pode referenciar com segurança tipos definidos em outro assembly dinâmico transitório, um assembly dinâmico persistente ou um assembly estático.A transient dynamic assembly can safely reference types defined in another transient dynamic assembly, a persistable dynamic assembly, or a static assembly. No entanto, o Common Language Runtime não permite que um módulo dinâmico persistente referencie um tipo definido em um módulo dinâmico transitório.However, the common language runtime does not allow a persistable dynamic module to reference a type defined in a transient dynamic module. Isso ocorre porque quando o módulo dinâmico persistente é carregado após ser salvo no disco, o tempo de execução não pode resolver as referências a tipos definidos no módulo dinâmico transitório.This is because when the persisted dynamic module is loaded after being saved to disk, the runtime cannot resolve the references to types defined in the transient dynamic module.

Restrições na emissão de domínios de aplicativo remotosRestrictions on emitting to remote application domains

Alguns cenários exigem que um assembly dinâmico seja criado e executado em um domínio de aplicativo remoto.Some scenarios require a dynamic assembly to be created and executed in a remote application domain. A emissão de reflexão não permite que um assembly dinâmico seja emitido diretamente para um domínio de aplicativo remoto.Reflection emit does not allow a dynamic assembly to be emitted directly to a remote application domain. A solução é emitir o assembly dinâmico no domínio do aplicativo atual, salvar o assembly dinâmico emitido em disco e, em seguida, carregar o assembly dinâmico no domínio do aplicativo remoto.The solution is to emit the dynamic assembly in the current application domain, save the emitted dynamic assembly to disk, and then load the dynamic assembly into the remote application domain.

Modos de acesso de assembly dinâmicoDynamic assembly access modes

Os assemblies dinâmicos podem ser criados usando um dos seguintes modos de acesso:Dynamic assemblies can be created using one of the following access modes:

  • AssemblyBuilderAccess.Run

    O assembly dinâmico representado por um AssemblyBuilder objeto é transitório.The dynamic assembly represented by an AssemblyBuilder object is transient. O assembly dinâmico só pode ser usado para executar o código emitido.The dynamic assembly can only be used to execute the emitted code.

  • AssemblyBuilderAccess.Save

    O assembly dinâmico representado por um AssemblyBuilder objeto é persistente, mas não pode ser executado até que o arquivo PE (executável portátil) salvo tenha sido carregado do disco.The dynamic assembly represented by an AssemblyBuilder object is persistable but cannot be executed until the saved portable executable (PE) file has been loaded from disk.

  • AssemblyBuilderAccess.RunAndSave

    O assembly dinâmico representado por um AssemblyBuilder objeto é persistente, mas também pode ser executado antes e/ou depois que o assembly é salvo em disco.The dynamic assembly represented by an AssemblyBuilder object is persistable, but can also be executed before and/or after the assembly is saved to disk.

O modo de acesso deve ser especificado fornecendo o valor AssemblyBuilderAccess apropriado na chamada para o AssemblyBuilder.DefineDynamicAssembly método quando o assembly dinâmico é definido e não pode ser alterado posteriormente.The access mode must be specified by providing the appropriate AssemblyBuilderAccess value in the call to the AssemblyBuilder.DefineDynamicAssembly method when the dynamic assembly is defined and cannot be changed later. O tempo de execução usa o modo de acesso de um assembly dinâmico para otimizar a representação interna do assembly.The runtime uses the access mode of a dynamic assembly to optimize the assembly's internal representation.

Construtores

AssemblyBuilder() AssemblyBuilder() AssemblyBuilder() AssemblyBuilder()

Propriedades

CodeBase CodeBase CodeBase CodeBase

Obtém o local do assembly como especificado originalmente (como em um objeto AssemblyName).Gets the location of the assembly, as specified originally (such as in an AssemblyName object).

CustomAttributes CustomAttributes CustomAttributes CustomAttributes

Obtém uma coleção que contém os atributos personalizados deste assembly.Gets a collection that contains this assembly's custom attributes.

(Inherited from Assembly)
DefinedTypes DefinedTypes DefinedTypes DefinedTypes
EntryPoint EntryPoint EntryPoint EntryPoint

Retorna o ponto de entrada desse assembly.Returns the entry point of this assembly.

EscapedCodeBase EscapedCodeBase EscapedCodeBase EscapedCodeBase

Obtém o URI, incluindo caracteres de escape, que representa a base de código.Gets the URI, including escape characters, that represents the codebase.

(Inherited from Assembly)
Evidence Evidence Evidence Evidence

Obtém a evidência para esse assembly.Gets the evidence for this assembly.

ExportedTypes ExportedTypes ExportedTypes ExportedTypes

Obtém uma coleção dos tipos públicos definidos nesse assembly visíveis fora do assembly.Gets a collection of the public types defined in this assembly that are visible outside the assembly.

(Inherited from Assembly)
FullName FullName FullName FullName

Obtém o nome de exibição do assembly dinâmico atual.Gets the display name of the current dynamic assembly.

GlobalAssemblyCache GlobalAssemblyCache GlobalAssemblyCache GlobalAssemblyCache

Obtém um valor que indica se o assembly foi carregado do cache de assembly global.Gets a value that indicates whether the assembly was loaded from the global assembly cache.

HostContext HostContext HostContext HostContext

Obtém o contexto do host em que o assembly dinâmico está sendo criado.Gets the host context where the dynamic assembly is being created.

ImageRuntimeVersion ImageRuntimeVersion ImageRuntimeVersion ImageRuntimeVersion

Obtém a versão do Common Language Runtime que será salvo no arquivo que contém o manifesto.Gets the version of the common language runtime that will be saved in the file containing the manifest.

IsCollectible IsCollectible IsCollectible IsCollectible

Obtém um valor que indica se este assembly é mantido em uma coleção AssemblyLoadContext.Gets a value that indicates whether this assembly is held in a collectible AssemblyLoadContext.

(Inherited from Assembly)
IsDynamic IsDynamic IsDynamic IsDynamic

Obtém um valor que indica que o assembly atual é um assembly dinâmico.Gets a value that indicates that the current assembly is a dynamic assembly.

IsFullyTrusted IsFullyTrusted IsFullyTrusted IsFullyTrusted

Obtém um valor que indica se o assembly atual é carregado com confiança total.Gets a value that indicates whether the current assembly is loaded with full trust.

(Inherited from Assembly)
Location Location Location Location

Obtém o local, no formato de base de código, do arquivo carregado que contém o manifesto, caso não tenha sido feita cópia de sombra dele.Gets the location, in codebase format, of the loaded file that contains the manifest if it is not shadow-copied.

ManifestModule ManifestModule ManifestModule ManifestModule

Obtém o módulo no AssemblyBuilder atual que contém o manifesto do assembly.Gets the module in the current AssemblyBuilder that contains the assembly manifest.

Modules Modules Modules Modules
PermissionSet PermissionSet PermissionSet PermissionSet

Obtém o conjunto de concessões do assembly dinâmico atual.Gets the grant set of the current dynamic assembly.

ReflectionOnly ReflectionOnly ReflectionOnly ReflectionOnly

Obtém um valor que indica se o assembly dinâmico está no contexto de somente reflexão.Gets a value indicating whether the dynamic assembly is in the reflection-only context.

SecurityRuleSet SecurityRuleSet SecurityRuleSet SecurityRuleSet

Obtém um valor que indica qual conjunto de regras de segurança o CLR (Common Language Runtime) impõe a este assembly.Gets a value that indicates which set of security rules the common language runtime (CLR) enforces for this assembly.

Métodos

AddResourceFile(String, String) AddResourceFile(String, String) AddResourceFile(String, String) AddResourceFile(String, String)

Adiciona um arquivo de recurso existente a esse assembly.Adds an existing resource file to this assembly.

AddResourceFile(String, String, ResourceAttributes) AddResourceFile(String, String, ResourceAttributes) AddResourceFile(String, String, ResourceAttributes) AddResourceFile(String, String, ResourceAttributes)

Adiciona um arquivo de recurso existente a esse assembly.Adds an existing resource file to this assembly.

CreateInstance(String) CreateInstance(String) CreateInstance(String) CreateInstance(String)

Localiza o tipo especificado desse assembly e cria uma instância dele usando o ativador de sistema, usando a pesquisa que diferencia maiúsculas de minúsculas.Locates the specified type from this assembly and creates an instance of it using the system activator, using case-sensitive search.

(Inherited from Assembly)
CreateInstance(String, Boolean) CreateInstance(String, Boolean) CreateInstance(String, Boolean) CreateInstance(String, Boolean)

Localiza o tipo especificado desse assembly e cria uma instância dele usando o ativador de sistema, com pesquisa que diferencia maiúsculas de minúsculas opcional.Locates the specified type from this assembly and creates an instance of it using the system activator, with optional case-sensitive search.

(Inherited from Assembly)
CreateInstance(String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[]) CreateInstance(String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[]) CreateInstance(String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[]) CreateInstance(String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[])

Localiza o tipo especificado desse assembly e cria uma instância dele usando o ativador do sistema, com a pesquisa opcional que diferencia maiúsculas de minúsculas e com a cultura especificada, os argumentos e os atributos de associação e ativação.Locates the specified type from this assembly and creates an instance of it using the system activator, with optional case-sensitive search and having the specified culture, arguments, and binding and activation attributes.

(Inherited from Assembly)
DefineDynamicAssembly(AssemblyName, AssemblyBuilderAccess) DefineDynamicAssembly(AssemblyName, AssemblyBuilderAccess) DefineDynamicAssembly(AssemblyName, AssemblyBuilderAccess) DefineDynamicAssembly(AssemblyName, AssemblyBuilderAccess)

Define um assembly dinâmico que tem o nome e os direitos de acesso especificados.Defines a dynamic assembly that has the specified name and access rights.

DefineDynamicAssembly(AssemblyName, AssemblyBuilderAccess, IEnumerable<CustomAttributeBuilder>) DefineDynamicAssembly(AssemblyName, AssemblyBuilderAccess, IEnumerable<CustomAttributeBuilder>) DefineDynamicAssembly(AssemblyName, AssemblyBuilderAccess, IEnumerable<CustomAttributeBuilder>) DefineDynamicAssembly(AssemblyName, AssemblyBuilderAccess, IEnumerable<CustomAttributeBuilder>)

Define um novo assembly que tem o nome, os direitos de acesso e os atributos especificados.Defines a new assembly that has the specified name, access rights, and attributes.

DefineDynamicModule(String) DefineDynamicModule(String) DefineDynamicModule(String) DefineDynamicModule(String)

Define um módulo dinâmico transitório nomeado nesse assembly.Defines a named transient dynamic module in this assembly.

DefineDynamicModule(String, Boolean) DefineDynamicModule(String, Boolean) DefineDynamicModule(String, Boolean) DefineDynamicModule(String, Boolean)

Define o módulo dinâmico transitório nomeado neste assembly e especifica se as informações de símbolo devem ser emitidas.Defines a named transient dynamic module in this assembly and specifies whether symbol information should be emitted.

DefineDynamicModule(String, String) DefineDynamicModule(String, String) DefineDynamicModule(String, String) DefineDynamicModule(String, String)

Define um módulo dinâmico persistente com o nome fornecido que será salvo no arquivo especificado.Defines a persistable dynamic module with the given name that will be saved to the specified file. Nenhuma informação de símbolo é emitida.No symbol information is emitted.

DefineDynamicModule(String, String, Boolean) DefineDynamicModule(String, String, Boolean) DefineDynamicModule(String, String, Boolean) DefineDynamicModule(String, String, Boolean)

Define um módulo dinâmico persistente, especificando o nome do módulo, o nome do arquivo no qual o módulo será salvo e se as informações de símbolo deverão ser emitidas usando o gravador de símbolo padrão.Defines a persistable dynamic module, specifying the module name, the name of the file to which the module will be saved, and whether symbol information should be emitted using the default symbol writer.

DefineResource(String, String, String) DefineResource(String, String, String) DefineResource(String, String, String) DefineResource(String, String, String)

Define um recurso gerenciado autônomo para esse assembly com o atributo de recurso público padrão.Defines a standalone managed resource for this assembly with the default public resource attribute.

DefineResource(String, String, String, ResourceAttributes) DefineResource(String, String, String, ResourceAttributes) DefineResource(String, String, String, ResourceAttributes) DefineResource(String, String, String, ResourceAttributes)

Define um recurso autônomo gerenciado para esse assembly.Defines a standalone managed resource for this assembly. Atributos podem ser especificados para o recurso gerenciado.Attributes can be specified for the managed resource.

DefineUnmanagedResource(Byte[]) DefineUnmanagedResource(Byte[]) DefineUnmanagedResource(Byte[]) DefineUnmanagedResource(Byte[])

Define um recurso não gerenciado para este assembly como um blob de bytes opaco.Defines an unmanaged resource for this assembly as an opaque blob of bytes.

DefineUnmanagedResource(String) DefineUnmanagedResource(String) DefineUnmanagedResource(String) DefineUnmanagedResource(String)

Define um arquivo de recurso não gerenciado para este assembly, considerando o nome do arquivo de recurso.Defines an unmanaged resource file for this assembly given the name of the resource file.

DefineVersionInfoResource() DefineVersionInfoResource() DefineVersionInfoResource() DefineVersionInfoResource()

Define um recurso de informações de versão não gerenciada usando as informações especificadas no objeto AssemblyName do assembly e nos atributos personalizados do assembly.Defines an unmanaged version information resource using the information specified in the assembly's AssemblyName object and the assembly's custom attributes.

DefineVersionInfoResource(String, String, String, String, String) DefineVersionInfoResource(String, String, String, String, String) DefineVersionInfoResource(String, String, String, String, String) DefineVersionInfoResource(String, String, String, String, String)

Define um recurso de informações de versão não gerenciada para este assembly com as especificações determinadas.Defines an unmanaged version information resource for this assembly with the given specifications.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Retorna um valor que indica se essa instância é igual ao objeto especificado.Returns a value that indicates whether this instance is equal to the specified object.

GetCustomAttributes(Boolean) GetCustomAttributes(Boolean) GetCustomAttributes(Boolean) GetCustomAttributes(Boolean)

Retorna todos os atributos personalizados que foram aplicados ao AssemblyBuilder atual.Returns all the custom attributes that have been applied to the current AssemblyBuilder.

GetCustomAttributes(Type, Boolean) GetCustomAttributes(Type, Boolean) GetCustomAttributes(Type, Boolean) GetCustomAttributes(Type, Boolean)

Retorna todos os atributos personalizados que foram aplicados ao AssemblyBuilder atual e que derivam de um tipo de atributo especificado.Returns all the custom attributes that have been applied to the current AssemblyBuilder, and that derive from a specified attribute type.

GetCustomAttributesData() GetCustomAttributesData() GetCustomAttributesData() GetCustomAttributesData()

Retorna objetos CustomAttributeData que contêm informações sobre os atributos que foram aplicados ao AssemblyBuilder atual.Returns CustomAttributeData objects that contain information about the attributes that have been applied to the current AssemblyBuilder.

GetDynamicModule(String) GetDynamicModule(String) GetDynamicModule(String) GetDynamicModule(String)

Retorna o módulo dinâmico com o nome especificado.Returns the dynamic module with the specified name.

GetExportedTypes() GetExportedTypes() GetExportedTypes() GetExportedTypes()

Obtém os tipos exportados definidos neste assembly.Gets the exported types defined in this assembly.

GetFile(String) GetFile(String) GetFile(String) GetFile(String)

Obtém um FileStream para o arquivo especificado na tabela de arquivo do manifesto desse assembly.Gets a FileStream for the specified file in the file table of the manifest of this assembly.

GetFiles() GetFiles() GetFiles() GetFiles()

Obtém os arquivos na tabela de arquivo de um manifesto do assembly.Gets the files in the file table of an assembly manifest.

(Inherited from Assembly)
GetFiles(Boolean) GetFiles(Boolean) GetFiles(Boolean) GetFiles(Boolean)

Obtém os arquivos na tabela de arquivos de um manifesto do assembly, especificando se deseja-se incluir os módulos de recursos.Gets the files in the file table of an assembly manifest, specifying whether to include resource modules.

GetForwardedTypes() GetForwardedTypes() GetForwardedTypes() GetForwardedTypes() Inherited from Assembly
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Retorna o código hash para essa instância.Returns the hash code for this instance.

GetLoadedModules() GetLoadedModules() GetLoadedModules() GetLoadedModules()

Obtém todos os módulos carregados que fazem parte desse assembly.Gets all the loaded modules that are part of this assembly.

(Inherited from Assembly)
GetLoadedModules(Boolean) GetLoadedModules(Boolean) GetLoadedModules(Boolean) GetLoadedModules(Boolean)

Retorna todos os módulos carregados que fazem parte desse assembly e, opcionalmente, inclui módulos de recursos.Returns all the loaded modules that are part of this assembly, and optionally includes resource modules.

GetManifestResourceInfo(String) GetManifestResourceInfo(String) GetManifestResourceInfo(String) GetManifestResourceInfo(String)

Retorna informações sobre como o recurso em questão foi persistido.Returns information about how the given resource has been persisted.

GetManifestResourceNames() GetManifestResourceNames() GetManifestResourceNames() GetManifestResourceNames()

Carrega o recurso de manifesto especificado desse assembly.Loads the specified manifest resource from this assembly.

GetManifestResourceStream(String) GetManifestResourceStream(String) GetManifestResourceStream(String) GetManifestResourceStream(String)

Carrega o recurso de manifesto especificado desse assembly.Loads the specified manifest resource from this assembly.

GetManifestResourceStream(Type, String) GetManifestResourceStream(Type, String) GetManifestResourceStream(Type, String) GetManifestResourceStream(Type, String)

Carrega o recurso de manifesto especificado, o escopo pelo namespace do tipo especificado, desse assembly.Loads the specified manifest resource, scoped by the namespace of the specified type, from this assembly.

GetModule(String) GetModule(String) GetModule(String) GetModule(String)

Obtém o módulo especificado nesse assembly.Gets the specified module in this assembly.

GetModules() GetModules() GetModules() GetModules()

Obtém todos os módulos que fazem parte desse assembly.Gets all the modules that are part of this assembly.

(Inherited from Assembly)
GetModules(Boolean) GetModules(Boolean) GetModules(Boolean) GetModules(Boolean)

Obtém todos os módulos que fazem parte desse assembly e, opcionalmente, inclui módulos de recursos.Gets all the modules that are part of this assembly, and optionally includes resource modules.

GetName() GetName() GetName() GetName()

Obtém um AssemblyName para esse assembly.Gets an AssemblyName for this assembly.

(Inherited from Assembly)
GetName(Boolean) GetName(Boolean) GetName(Boolean) GetName(Boolean)

Obtém o AssemblyName, que foi especificado quando o assembly dinâmico atual foi criado e define a base de código como especificado.Gets the AssemblyName that was specified when the current dynamic assembly was created, and sets the code base as specified.

GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext) GetObjectData(SerializationInfo, StreamingContext)

Obtém informações de serialização com todos os dados necessários para recriar uma instância desse assembly.Gets serialization information with all of the data needed to reinstantiate this assembly.

(Inherited from Assembly)
GetReferencedAssemblies() GetReferencedAssemblies() GetReferencedAssemblies() GetReferencedAssemblies()

Obtém uma lista incompleta de objetos AssemblyName para os assemblies que são referenciados por este AssemblyBuilder.Gets an incomplete list of AssemblyName objects for the assemblies that are referenced by this AssemblyBuilder.

GetSatelliteAssembly(CultureInfo) GetSatelliteAssembly(CultureInfo) GetSatelliteAssembly(CultureInfo) GetSatelliteAssembly(CultureInfo)

Obtém o assembly satélite para a cultura especificada.Gets the satellite assembly for the specified culture.

GetSatelliteAssembly(CultureInfo, Version) GetSatelliteAssembly(CultureInfo, Version) GetSatelliteAssembly(CultureInfo, Version) GetSatelliteAssembly(CultureInfo, Version)

Obtém a versão especificada do assembly satélite para a cultura especificada.Gets the specified version of the satellite assembly for the specified culture.

GetType() GetType() GetType() GetType() Inherited from Assembly
GetType(String) GetType(String) GetType(String) GetType(String)

Obtém o objeto Type com o nome especificado na instância do assembly.Gets the Type object with the specified name in the assembly instance.

(Inherited from Assembly)
GetType(String, Boolean) GetType(String, Boolean) GetType(String, Boolean) GetType(String, Boolean)

Obtém o objeto Type com o nome especificado na instância do assembly e, opcionalmente, lança uma exceção se o tipo não for encontrado.Gets the Type object with the specified name in the assembly instance and optionally throws an exception if the type is not found.

(Inherited from Assembly)
GetType(String, Boolean, Boolean) GetType(String, Boolean, Boolean) GetType(String, Boolean, Boolean) GetType(String, Boolean, Boolean)

Obtém o tipo especificado dos tipos que foram definidos e criados no AssemblyBuilder atual.Gets the specified type from the types that have been defined and created in the current AssemblyBuilder.

GetTypes() GetTypes() GetTypes() GetTypes()

Obtém os tipos definidos neste assembly.Gets the types defined in this assembly.

(Inherited from Assembly)
IsDefined(Type, Boolean) IsDefined(Type, Boolean) IsDefined(Type, Boolean) IsDefined(Type, Boolean)

Retorna um valor que indica se uma ou mais instâncias do tipo de atributo especificado será aplicada a esse membro.Returns a value that indicates whether one or more instances of the specified attribute type is applied to this member.

LoadModule(String, Byte[]) LoadModule(String, Byte[]) LoadModule(String, Byte[]) LoadModule(String, Byte[])

Carrega o módulo, interno a esse assembly, com uma imagem baseada no formato COFF que contém um módulo emitido ou um arquivo de recurso.Loads the module, internal to this assembly, with a common object file format (COFF)-based image containing an emitted module, or a resource file.

(Inherited from Assembly)
LoadModule(String, Byte[], Byte[]) LoadModule(String, Byte[], Byte[]) LoadModule(String, Byte[], Byte[]) LoadModule(String, Byte[], Byte[])

Carrega o módulo, interno a esse assembly, com uma imagem baseada no formato COFF que contém um módulo emitido ou um arquivo de recurso.Loads the module, internal to this assembly, with a common object file format (COFF)-based image containing an emitted module, or a resource file. Os bytes brutos que representam os símbolos para o módulo também são carregados.The raw bytes representing the symbols for the module are also loaded.

(Inherited from Assembly)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Inherited from Object)
Save(String) Save(String) Save(String) Save(String)

Salva esse assembly dinâmico em disco.Saves this dynamic assembly to disk.

Save(String, PortableExecutableKinds, ImageFileMachine) Save(String, PortableExecutableKinds, ImageFileMachine) Save(String, PortableExecutableKinds, ImageFileMachine) Save(String, PortableExecutableKinds, ImageFileMachine)

Salva esse assembly dinâmico no disco, especificando a natureza do código nos executáveis do assembly e na plataforma de destino.Saves this dynamic assembly to disk, specifying the nature of code in the assembly's executables and the target platform.

SetCustomAttribute(ConstructorInfo, Byte[]) SetCustomAttribute(ConstructorInfo, Byte[]) SetCustomAttribute(ConstructorInfo, Byte[]) SetCustomAttribute(ConstructorInfo, Byte[])

Defina um atributo personalizado neste assembly usando um blob de atributos personalizados especificado.Set a custom attribute on this assembly using a specified custom attribute blob.

SetCustomAttribute(CustomAttributeBuilder) SetCustomAttribute(CustomAttributeBuilder) SetCustomAttribute(CustomAttributeBuilder) SetCustomAttribute(CustomAttributeBuilder)

Defina um atributo personalizado neste assembly usando um construtor de atributos personalizados.Set a custom attribute on this assembly using a custom attribute builder.

SetEntryPoint(MethodInfo) SetEntryPoint(MethodInfo) SetEntryPoint(MethodInfo) SetEntryPoint(MethodInfo)

Define o ponto de entrada para este assembly dinâmico, supondo que um aplicativo de console está sendo compilado.Sets the entry point for this dynamic assembly, assuming that a console application is being built.

SetEntryPoint(MethodInfo, PEFileKinds) SetEntryPoint(MethodInfo, PEFileKinds) SetEntryPoint(MethodInfo, PEFileKinds) SetEntryPoint(MethodInfo, PEFileKinds)

Define o ponto de entrada para este assembly e define o tipo de arquivo PE (executável portátil) que está sendo compilado.Sets the entry point for this assembly and defines the type of the portable executable (PE file) being built.

ToString() ToString() ToString() ToString()

Retorna o nome completo do assembly, também conhecido como o nome de exibição.Returns the full name of the assembly, also known as the display name.

(Inherited from Assembly)

Implantações explícitas de interface

ICustomAttributeProvider.GetCustomAttributes(Boolean) ICustomAttributeProvider.GetCustomAttributes(Boolean) ICustomAttributeProvider.GetCustomAttributes(Boolean) ICustomAttributeProvider.GetCustomAttributes(Boolean) Inherited from Assembly
ICustomAttributeProvider.GetCustomAttributes(Type, Boolean) ICustomAttributeProvider.GetCustomAttributes(Type, Boolean) ICustomAttributeProvider.GetCustomAttributes(Type, Boolean) ICustomAttributeProvider.GetCustomAttributes(Type, Boolean) Inherited from Assembly
ICustomAttributeProvider.IsDefined(Type, Boolean) ICustomAttributeProvider.IsDefined(Type, Boolean) ICustomAttributeProvider.IsDefined(Type, Boolean) ICustomAttributeProvider.IsDefined(Type, Boolean) Inherited from Assembly
_Assembly.GetType() _Assembly.GetType() _Assembly.GetType() _Assembly.GetType()

Retorna o tipo da instância atual.Returns the type of the current instance.

(Inherited from Assembly)
_AssemblyBuilder.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) _AssemblyBuilder.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) _AssemblyBuilder.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr) _AssemblyBuilder.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

Mapeia um conjunto de nomes para um conjunto correspondente de identificadores de expedição.Maps a set of names to a corresponding set of dispatch identifiers.

_AssemblyBuilder.GetTypeInfo(UInt32, UInt32, IntPtr) _AssemblyBuilder.GetTypeInfo(UInt32, UInt32, IntPtr) _AssemblyBuilder.GetTypeInfo(UInt32, UInt32, IntPtr) _AssemblyBuilder.GetTypeInfo(UInt32, UInt32, IntPtr)

Recupera as informações do tipo de um objeto, que podem ser usadas para obter informações de tipo para uma interface.Retrieves the type information for an object, which can then be used to get the type information for an interface.

_AssemblyBuilder.GetTypeInfoCount(UInt32) _AssemblyBuilder.GetTypeInfoCount(UInt32) _AssemblyBuilder.GetTypeInfoCount(UInt32) _AssemblyBuilder.GetTypeInfoCount(UInt32)

Retorna o número de interfaces de informações do tipo que um objeto fornece (0 ou 1).Retrieves the number of type information interfaces that an object provides (either 0 or 1).

_AssemblyBuilder.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) _AssemblyBuilder.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) _AssemblyBuilder.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr) _AssemblyBuilder.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

Fornece acesso a propriedades e métodos expostos por um objeto.Provides access to properties and methods exposed by an object.

Eventos

ModuleResolve ModuleResolve ModuleResolve ModuleResolve

Ocorre quando o carregador de classe do Common Language Runtime não é capaz de resolver uma referência a um módulo interno de um assembly por meios normais.Occurs when the common language runtime class loader cannot resolve a reference to an internal module of an assembly through normal means.

(Inherited from Assembly)

Métodos de Extensão

GetExportedTypes(Assembly) GetExportedTypes(Assembly) GetExportedTypes(Assembly) GetExportedTypes(Assembly)
GetModules(Assembly) GetModules(Assembly) GetModules(Assembly) GetModules(Assembly)
GetTypes(Assembly) GetTypes(Assembly) GetTypes(Assembly) GetTypes(Assembly)
GetCustomAttribute(Assembly, Type) GetCustomAttribute(Assembly, Type) GetCustomAttribute(Assembly, Type) GetCustomAttribute(Assembly, Type)

Recupera um atributo personalizado de um tipo especificado aplicado a um assembly especificado.Retrieves a custom attribute of a specified type that is applied to a specified assembly.

GetCustomAttribute<T>(Assembly) GetCustomAttribute<T>(Assembly) GetCustomAttribute<T>(Assembly) GetCustomAttribute<T>(Assembly)

Recupera um atributo personalizado de um tipo especificado aplicado a um assembly especificado.Retrieves a custom attribute of a specified type that is applied to a specified assembly.

GetCustomAttributes(Assembly) GetCustomAttributes(Assembly) GetCustomAttributes(Assembly) GetCustomAttributes(Assembly)

Recupera uma coleção de atributos personalizados que são aplicados a um assembly especificado.Retrieves a collection of custom attributes that are applied to a specified assembly.

GetCustomAttributes(Assembly, Type) GetCustomAttributes(Assembly, Type) GetCustomAttributes(Assembly, Type) GetCustomAttributes(Assembly, Type)

Recupera uma coleção de atributos personalizados de um tipo especificado que são aplicados a um assembly especificado.Retrieves a collection of custom attributes of a specified type that are applied to a specified assembly.

GetCustomAttributes<T>(Assembly) GetCustomAttributes<T>(Assembly) GetCustomAttributes<T>(Assembly) GetCustomAttributes<T>(Assembly)

Recupera uma coleção de atributos personalizados de um tipo especificado que são aplicados a um assembly especificado.Retrieves a collection of custom attributes of a specified type that are applied to a specified assembly.

IsDefined(Assembly, Type) IsDefined(Assembly, Type) IsDefined(Assembly, Type) IsDefined(Assembly, Type)

Indica se os atributos personalizados de um tipo especificados são aplicados a um assembly especificado.Indicates whether custom attributes of a specified type are applied to a specified assembly.

TryGetRawMetadata(Assembly, Byte*, Int32) TryGetRawMetadata(Assembly, Byte*, Int32) TryGetRawMetadata(Assembly, Byte*, Int32) TryGetRawMetadata(Assembly, Byte*, Int32)

Segurança

ReflectionPermission
quando invocado com associação tardia por meio de mecanismos como InvokeMember(String, BindingFlags, Binder, Object, Object[], ParameterModifier[], CultureInfo, String[]).when invoked late-bound through mechanisms such as InvokeMember(String, BindingFlags, Binder, Object, Object[], ParameterModifier[], CultureInfo, String[]). Enumeração associada: MemberAccess.Associated enumeration: MemberAccess.

Aplica-se a

Veja também