AssemblyBuilder AssemblyBuilder AssemblyBuilder AssemblyBuilder Class

定義

動的アセンブリを定義および表現します。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
継承
AssemblyBuilderAssemblyBuilderAssemblyBuilderAssemblyBuilder
属性
実装

次のコード例は、1つのモジュールで動的アセンブリを定義する方法を示しています。The following code example shows how to define a dynamic assembly with one module. 例のアセンブリのモジュールには、プライベートフィールドMyDynamicTypeを持つ、プライベートフィールドを取得して設定するプロパティ、プライベートフィールドを初期化するコンストラクター、プライベートフィールドによってユーザー指定の数値を乗算するメソッドなど、1つの型が含まれています。値を返し、結果を返します。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は、アセンブリの作成時に指定されます。AssemblyBuilderAccess.RunAndSave is specified when the assembly is created. アセンブリコードはすぐに使用されます。アセンブリは、 ildasm.exe (IL 逆アセンブラー)を使用して検査したり、別のプログラムで使用したりできるように、ディスクにも保存されます。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.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

注釈

動的アセンブリは、リフレクション出力 Api を使用して作成されるアセンブリです。A dynamic assembly is an assembly that is created using the Reflection Emit APIs. アセンブリ内の動的モジュールは、 Saveメソッドを使用して動的アセンブリを保存するときに保存されます。The dynamic modules in the assembly are saved when the dynamic assembly is saved using the Save method. 実行可能ファイルSetEntryPointを生成するには、メソッドを呼び出して、アセンブリへのエントリポイントであるメソッドを識別する必要があります。To generate an executable, the SetEntryPoint method must be called to identify the method that is the entry point to the assembly. アセンブリは、メソッドがSetEntryPointコンソールアプリケーションまたは Windows ベースのアプリケーションの生成を要求しない限り、既定で dll として保存されます。Assemblies are saved as DLLs by default, unless the SetEntryPoint method requests the generation of a console application or a Windows-based application.

動的アセンブリに複数の動的モジュールが含まれている場合、アセンブリのマニフェストファイル名は、メソッドのDefineDynamicModule最初の引数として指定されているモジュールの名前と一致している必要があります。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.

GetModulesAssembly AssemblyBuilderなどの基底クラスのメソッドの中には、オブジェクトから呼び出されたときに正しく機能しないものがあります。 GetLoadedModulesSome methods on the base Assembly class, such as GetModules and GetLoadedModules, will not work correctly when called from AssemblyBuilder objects. 定義済みの動的アセンブリを読み込み、読み込まれたアセンブリに対してメソッドを呼び出すことができます。You can load the defined dynamic assembly and call the methods on the loaded assembly. たとえば、返されたモジュールの一覧にリソースモジュールが含まれていることGetModulesを確認するAssemblyには、読み込まれたオブジェクトに対してを呼び出します。For example, to ensure that resource modules are included in the returned module list, call GetModules on the loaded Assembly object.

を使用しKeyPairた動的アセンブリの署名は、アセンブリがディスクに保存されるまで有効ではありません。The signing of a dynamic assembly using KeyPair is not effective until the assembly is saved to disk. したがって、厳密な名前は、一時的な動的アセンブリでは機能しません。So, strong names will not work with transient dynamic assemblies.

AssemblyBuilderオブジェクトを取得するには、 AppDomain.DefineDynamicAssemblyメソッドを使用します。To get an AssemblyBuilder object, use the AppDomain.DefineDynamicAssembly method.

リフレクション出力による動的アセンブリのシナリオReflection emit dynamic assembly scenarios

AssemblyBuilderクラスを使用して動的アセンブリを作成する場合は、次の点を考慮する必要があります。The following are some things to consider when using the AssemblyBuilder class to create dynamic assemblies.

動的モジュールDynamic modules

リフレクション出力は、動的アセンブリで定義された動的モジュールの作成をサポートします。Reflection emit supports the creation of dynamic modules defined in dynamic assemblies. 動的アセンブリで作成される動的モジュールは、一時的なものでも、永続化することもできます。A dynamic module created in a dynamic assembly can be transient or persistable.

型参照に関する制限事項Restrictions on type references

アセンブリは、別のアセンブリで定義されている型を参照できます。Assemblies can reference types defined in another assembly. 一時的な動的アセンブリは、別の一時動的アセンブリ、永続化動的アセンブリ、または静的アセンブリで定義されている型を安全に参照できます。A transient dynamic assembly can safely reference types defined in another transient dynamic assembly, a persistable dynamic assembly, or a static assembly. ただし、共通言語ランタイムでは、永続動的モジュールが、transient 動的モジュールで定義されている型を参照することはできません。However, the common language runtime does not allow a persistable dynamic module to reference a type defined in a transient dynamic module. これは、永続化された動的モジュールがディスクに保存された後に読み込まれると、ランタイムは、transient 動的モジュールで定義されている型への参照を解決できないためです。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.

リモートアプリケーションドメインへの出力に関する制限事項Restrictions on emitting to remote application domains

一部のシナリオでは、動的アセンブリを作成し、リモートアプリケーションドメインで実行する必要があります。Some scenarios require a dynamic assembly to be created and executed in a remote application domain. リフレクション出力では、動的アセンブリをリモートアプリケーションドメインに直接出力することはできません。Reflection emit does not allow a dynamic assembly to be emitted directly to a remote application domain. 解決策は、現在のアプリケーションドメインに動的アセンブリを出力し、出力された動的アセンブリをディスクに保存してから、動的アセンブリをリモートアプリケーションドメインに読み込むことです。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.

動的アセンブリアクセスモードDynamic assembly access modes

動的アセンブリは、次のアクセスモードのいずれかを使用して作成できます。Dynamic assemblies can be created using one of the following access modes:

  • AssemblyBuilderAccess.Run

    AssemblyBuilderオブジェクトによって表される動的アセンブリは一時的です。The dynamic assembly represented by an AssemblyBuilder object is transient. 動的アセンブリは、出力されたコードの実行にのみ使用できます。The dynamic assembly can only be used to execute the emitted code.

  • AssemblyBuilderAccess.Save

    AssemblyBuilderオブジェクトによって表される動的アセンブリは永続化できますが、保存された移植可能な実行可能 (PE) ファイルがディスクから読み込まれるまでは実行できません。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

    AssemblyBuilderオブジェクトによって表される動的アセンブリは永続化されますが、アセンブリがディスクに保存される前または後に実行することもできます。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.

アクセスモードは、動的アセンブリが定義されAssemblyBuilderAccess 、後で変更できないAssemblyBuilder.DefineDynamicAssembly場合に、メソッドの呼び出しに適切な値を指定することによって指定する必要があります。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. ランタイムは、動的アセンブリのアクセスモードを使用して、アセンブリの内部表現を最適化します。The runtime uses the access mode of a dynamic assembly to optimize the assembly's internal representation.

コンストラクター

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

プロパティ

CodeBase CodeBase CodeBase CodeBase

AssemblyName オブジェクトの中など、初めに指定されたアセンブリの場所を取得します。Gets the location of the assembly, as specified originally (such as in an AssemblyName object).

CustomAttributes CustomAttributes CustomAttributes CustomAttributes

このアセンブリのカスタム属性を含むコレクションを取得します。Gets a collection that contains this assembly's custom attributes.

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

このアセンブリのエントリ ポイントを返します。Returns the entry point of this assembly.

EscapedCodeBase EscapedCodeBase EscapedCodeBase EscapedCodeBase

コードベースを表す URI を、エスケープ文字も含めて取得します。Gets the URI, including escape characters, that represents the codebase.

(Inherited from Assembly)
Evidence Evidence Evidence Evidence

このアセンブリの証拠を取得します。Gets the evidence for this assembly.

ExportedTypes ExportedTypes ExportedTypes ExportedTypes

アセンブリの外側で参照できる、このアセンブリ内で定義されているパブリック型のコレクションを取得します。Gets a collection of the public types defined in this assembly that are visible outside the assembly.

(Inherited from Assembly)
FullName FullName FullName FullName

現在の動的アセンブリの表示名を取得します。Gets the display name of the current dynamic assembly.

GlobalAssemblyCache GlobalAssemblyCache GlobalAssemblyCache GlobalAssemblyCache

アセンブリがグローバル アセンブリ キャッシュから読み込まれたかどうかを示す値を取得します。Gets a value that indicates whether the assembly was loaded from the global assembly cache.

HostContext HostContext HostContext HostContext

動的アセンブリが作成されるホスト コンテキストを取得します。Gets the host context where the dynamic assembly is being created.

ImageRuntimeVersion ImageRuntimeVersion ImageRuntimeVersion ImageRuntimeVersion

マニフェストを格納しているファイルに保存される共通言語ランタイムのバージョンを取得します。Gets the version of the common language runtime that will be saved in the file containing the manifest.

IsCollectible IsCollectible IsCollectible IsCollectible

このアセンブリが収集可能な AssemblyLoadContext に保持されているかどうかを示す値を取得します。Gets a value that indicates whether this assembly is held in a collectible AssemblyLoadContext.

(Inherited from Assembly)
IsDynamic IsDynamic IsDynamic IsDynamic

現在のアセンブリが動的アセンブリであることを示す値を取得します。Gets a value that indicates that the current assembly is a dynamic assembly.

IsFullyTrusted IsFullyTrusted IsFullyTrusted IsFullyTrusted

現在のアセンブリが完全信頼で読み込まれたかどうかを示す値を取得します。Gets a value that indicates whether the current assembly is loaded with full trust.

(Inherited from Assembly)
Location Location Location Location

マニフェストを格納している読み込み済みファイルがシャドウ コピーされていない場合に、このファイルの場所をコードベース書式で取得します。Gets the location, in codebase format, of the loaded file that contains the manifest if it is not shadow-copied.

ManifestModule ManifestModule ManifestModule ManifestModule

アセンブリ マニフェストを格納している現在の AssemblyBuilder 内のモジュールを取得します。Gets the module in the current AssemblyBuilder that contains the assembly manifest.

Modules Modules Modules Modules
PermissionSet PermissionSet PermissionSet PermissionSet

現在の動的アセンブリの許可セットを取得します。Gets the grant set of the current dynamic assembly.

ReflectionOnly ReflectionOnly ReflectionOnly ReflectionOnly

その動的アセンブリが、リフレクションのみのコンテキストで使用されるかどうかを示す値を取得します。Gets a value indicating whether the dynamic assembly is in the reflection-only context.

SecurityRuleSet SecurityRuleSet SecurityRuleSet SecurityRuleSet

共通言語ランタイム (CLR: Common Language Runtime) によってこのアセンブリに適用されるセキュリティ規則のセットを示す値を取得します。Gets a value that indicates which set of security rules the common language runtime (CLR) enforces for this assembly.

メソッド

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

このアセンブリに既存のリソース ファイルを追加します。Adds an existing resource file to this assembly.

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

このアセンブリに既存のリソース ファイルを追加します。Adds an existing resource file to this assembly.

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

大文字小文字を区別する検索を使用してこのアセンブリから指定された型を検索し、システム アクティベーターを使用してこの型のインスタンスを作成します。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)

オプションの大文字小文字を区別する検索を使用してこのアセンブリから指定された型を検索し、システム アクティベーターを使用してこの型のインスタンスを作成します。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[])

オプションの大文字小文字を区別する検索を使用して、このアセンブリから指定された型を検索し、システム アクティベーターを使用してこの型のインスタンスを作成し、指定されたカルチャ設定、引数、バインディング属性、およびアクティベーション属性を設定します。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)

指定した名前とアクセス権を持つ動的アセンブリを定義します。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>)

指定した名前、アクセス権、および属性を持つ新しいアセンブリを定義します。Defines a new assembly that has the specified name, access rights, and attributes.

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

このアセンブリに名前付き遷移動的モジュールを定義します。Defines a named transient dynamic module in this assembly.

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

このアセンブリに名前付き遷移動的モジュールを定義し、シンボル情報を作成するかどうかを指定します。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)

指定したファイルに保存される指定した名前の持続可能動的モジュールを定義します。Defines a persistable dynamic module with the given name that will be saved to the specified file. シンボル情報は作成されません。No symbol information is emitted.

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

モジュール名、モジュールの保存先ファイルの名前、既定のシンボル ライターを使用してシンボル情報を出力するかどうかを指定して、持続可能動的モジュールを定義します。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)

既定のパブリック リソース属性を使用して、このアセンブリのスタンドアロン マネージド リソースを定義します。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)

このアセンブリのスタンドアロン マネージド リソースを定義します。Defines a standalone managed resource for this assembly. マネージド リソースには属性を指定できます。Attributes can be specified for the managed resource.

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

このアセンブリのアンマネージ リソースをバイトの非透過 BLOB として定義します。Defines an unmanaged resource for this assembly as an opaque blob of bytes.

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

リソース ファイル名を指定して、このアセンブリのアンマネージ リソース ファイルを定義します。Defines an unmanaged resource file for this assembly given the name of the resource file.

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

アセンブリの AssemblyName オブジェクトおよびアセンブリのカスタム属性で指定された情報を使用して、アンマネージ バージョン情報リソースを定義します。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)

指定された仕様を使用して、このアセンブリのアンマネージ バージョン情報リソースを定義します。Defines an unmanaged version information resource for this assembly with the given specifications.

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

対象のインスタンスが、指定したオブジェクトに等しいかどうかを示す値を返します。Returns a value that indicates whether this instance is equal to the specified object.

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

現在の AssemblyBuilder に適用されたカスタム属性をすべて返します。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)

現在の AssemblyBuilder に適用されており、指定された属性の型から派生するすべてのカスタム属性を返します。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()

現在の AssemblyBuilder に適用されている属性に関する情報を含む CustomAttributeData オブジェクトを返します。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)

指定した名前の動的モジュールを返します。Returns the dynamic module with the specified name.

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

このアセンブリで定義されているエクスポート型を取得します。Gets the exported types defined in this assembly.

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

このアセンブリのマニフェストのファイル テーブル内の指定されたファイルの FileStream を取得します。Gets a FileStream for the specified file in the file table of the manifest of this assembly.

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

アセンブリ マニフェストのファイル テーブルのファイルを取得します。Gets the files in the file table of an assembly manifest.

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

リソース モジュールを含めるかどうかを指定して、アセンブリ マニフェストのファイル テーブルのファイルを取得します。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()

このインスタンスのハッシュ コードを返します。Returns the hash code for this instance.

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

このアセンブリの一部であるすべての読み込み済みモジュールを取得します。Gets all the loaded modules that are part of this assembly.

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

このアセンブリの一部である読み込み済みのモジュールをすべて返します。オプションでリソース モジュールも返します。Returns all the loaded modules that are part of this assembly, and optionally includes resource modules.

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

指定されたリソースが永続化された方法に関する情報を返します。Returns information about how the given resource has been persisted.

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

このアセンブリから、指定されたマニフェスト リソースを読み込みます。Loads the specified manifest resource from this assembly.

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

このアセンブリから、指定されたマニフェスト リソースを読み込みます。Loads the specified manifest resource from this assembly.

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

このアセンブリから、指定された型の名前空間によってスコープが指定されている、指定されたマニフェスト リソースを読み込みます。Loads the specified manifest resource, scoped by the namespace of the specified type, from this assembly.

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

このアセンブリから指定されたモジュールを取得します。Gets the specified module in this assembly.

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

このアセンブリの一部であるすべてのモジュールを取得します。Gets all the modules that are part of this assembly.

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

このアセンブリの一部であるモジュールをすべて取得します。オプションでリソース モジュールも取得します。Gets all the modules that are part of this assembly, and optionally includes resource modules.

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

このアセンブリの AssemblyName を取得します。Gets an AssemblyName for this assembly.

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

現在の動的アセンブリが作成された時に指定した AssemblyName を取得し、指定されたとおりにコード ベースを設定します。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)

シリアル化情報と、このアセンブリの再インスタンス化に必要なすべてのデータを取得します。Gets serialization information with all of the data needed to reinstantiate this assembly.

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

この AssemblyBuilder で参照されるアセンブリの AssemblyName オブジェクトの不完全なリストを取得します。Gets an incomplete list of AssemblyName objects for the assemblies that are referenced by this AssemblyBuilder.

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

指定されたカルチャ設定のサテライト アセンブリを取得します。Gets the satellite assembly for the specified culture.

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

指定されたバージョンの、指定されたカルチャ設定のサテライト アセンブリを取得します。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)

指定した名前の Type オブジェクトを、アセンブリ インスタンスから取得します。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)

指定した名前の Type オブジェクトをアセンブリ インスタンスから取得し、型が見つからない場合は、オプションで例外をスローします。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)

現在の AssemblyBuilder で定義および作成された型から、指定された型を取得します。Gets the specified type from the types that have been defined and created in the current AssemblyBuilder.

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

このアセンブリで定義されている型を取得します。Gets the types defined in this assembly.

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

指定された属性型の 1 つ以上のインスタンスがこのメンバーに適用されているかどうかを示す値を返します。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[])

生成されたモジュールを含んだ COFF ベースのイメージ、またはリソース ファイルと共に、このアセンブリの内部モジュールを読み込みます。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[])

生成されたモジュールを含んだ COFF ベースのイメージ、またはリソース ファイルと共に、このアセンブリの内部モジュールを読み込みます。Loads the module, internal to this assembly, with a common object file format (COFF)-based image containing an emitted module, or a resource file. モジュールのシンボルを表す生バイトも読み込まれます。The raw bytes representing the symbols for the module are also loaded.

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

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

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

この動的アセンブリをディスクに保存します。Saves this dynamic assembly to disk.

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

アセンブリの実行可能ファイルに含まれるコードの性質、および保存先プラットフォームを指定して、この動的アセンブリをディスクに保存します。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[])

指定したカスタム属性 BLOB を使用して、このアセンブリのカスタム属性を設定します。Set a custom attribute on this assembly using a specified custom attribute blob.

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

カスタム属性ビルダーを使用して、このアセンブリのカスタム属性を設定します。Set a custom attribute on this assembly using a custom attribute builder.

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

コンソール アプリケーションを構築するという前提で、この動的アセンブリのエントリ ポイントを設定します。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)

このアセンブリのエントリ ポイントを設定し、構築するポータブル実行可能 (PE) ファイルの型を定義します。Sets the entry point for this assembly and defines the type of the portable executable (PE file) being built.

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

アセンブリの完全名を返します。この名前は表示名とも呼ばれます。Returns the full name of the assembly, also known as the display name.

(Inherited from Assembly)

明示的なインターフェイスの実装

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()

現在のインスタンスの型を返します。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)

一連の名前を対応する一連のディスパッチ識別子に割り当てます。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)

オブジェクトの型情報を取得します。この型情報を使用して、インターフェイスの型情報を取得できます。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)

オブジェクトが提供する型情報インターフェイスの数 (0 または 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)

オブジェクトによって公開されたプロパティおよびメソッドへのアクセスを提供します。Provides access to properties and methods exposed by an object.

イベント

ModuleResolve ModuleResolve ModuleResolve ModuleResolve

共通言語ランタイム クラス ローダーが、通常の方法で参照をアセンブリの内部モジュールに解決できないときに発生します。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)

拡張メソッド

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)

指定されたアセンブリに適用される指定された型のカスタム属性を取得します。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)

指定されたアセンブリに適用される指定された型のカスタム属性を取得します。Retrieves a custom attribute of a specified type that is applied to a specified assembly.

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

指定されたアセンブリに適用されるカスタム属性のコレクションを取得します。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)

指定されたアセンブリに適用されている、指定された型のカスタム属性のコレクションを取得します。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)

指定されたアセンブリに適用されている、指定された型のカスタム属性のコレクションを取得します。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)

指定された型のカスタム属性が指定されたアセンブリに適用されているかどうかを示します。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)

セキュリティ

ReflectionPermission
などの機構を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[]). MemberAccess (関連する列挙体)Associated enumeration: MemberAccess.

適用対象

こちらもご覧ください