AssemblyBuilder Kelas

Definisi

Ruang nama:

System.Reflection.Emit

Rakitan:

netstandard.dll, System.Reflection.Emit.dll

Sumber:

AssemblyBuilder.cs

Mendefinisikan dan mewakili rakitan dinamis.

public ref class AssemblyBuilder abstract : System::Reflection::Assembly

public abstract class AssemblyBuilder : System.Reflection.Assembly

type AssemblyBuilder = class
    inherit Assembly

Public MustInherit Class AssemblyBuilder
Inherits Assembly

Warisan

Object

Assembly

AssemblyBuilder

Turunan

System.Reflection.Emit.PersistedAssemblyBuilder

Contoh

Contoh kode berikut menunjukkan cara menentukan dan menggunakan rakitan dinamis. Contoh rakitan berisi satu jenis, MyDynamicType, yang memiliki bidang privat, properti yang mendapatkan dan mengatur bidang privat, konstruktor yang menginisialisasi bidang privat, dan metode yang mengalikan angka yang disediakan pengguna dengan nilai bidang privat dan mengembalikan hasilnya.

using System;
using System.Reflection;
using System.Reflection.Emit;

class DemoAssemblyBuilder
{
    public static void Main()
    {
        // This code creates an assembly that 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;
            }
        }
        */

        var aName = new AssemblyName("DynamicAssemblyExample");
        AssemblyBuilder ab =
            AssemblyBuilder.DefineDynamicAssembly(
                aName,
                AssemblyBuilderAccess.Run);

        // The module name is usually the same as the assembly name.
        ModuleBuilder mb = ab.DefineDynamicModule(aName.Name ?? "DynamicAssemblyExample");

        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);
        ConstructorInfo? ci = typeof(object).GetConstructor(Type.EmptyTypes);
        ctor1IL.Emit(OpCodes.Call, ci!);
        // 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();

        // 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 = null;
        if (t is not null)
            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 = null;
        if (t is not null)
            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
 */

open System
open System.Threading
open System.Reflection
open System.Reflection.Emit

// This code creates an assembly that 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;
    }
}
*)

let assemblyName = new AssemblyName("DynamicAssemblyExample")
let assemblyBuilder =
    AssemblyBuilder.DefineDynamicAssembly(
        assemblyName,
        AssemblyBuilderAccess.Run)

// The module name is usually the same as the assembly name.
let moduleBuilder =
    assemblyBuilder.DefineDynamicModule(assemblyName.Name)

let typeBuilder =
    moduleBuilder.DefineType(
        "MyDynamicType",
        TypeAttributes.Public)

// Add a private field of type int (Int32)
let fieldBuilderNumber =
    typeBuilder.DefineField(
        "m_number",
        typeof<int>,
        FieldAttributes.Private)

// Define a constructor1 that takes an integer argument and
// stores it in the private field.
let parameterTypes = [| typeof<int> |]
let ctor1 =
    typeBuilder.DefineConstructor(
        MethodAttributes.Public,
        CallingConventions.Standard,
        parameterTypes)

let 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<obj>.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, fieldBuilderNumber)
ctor1IL.Emit(OpCodes.Ret)

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

let 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)
let propertyBuilderNumber =
    typeBuilder.DefineProperty(
        "Number",
        PropertyAttributes.HasDefault,
        typeof<int>,
        null)

// The property "set" and property "get" methods require a special
// set of attributes.
let 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)
let methodBuilderNumberGetAccessor =
    typeBuilder.DefineMethod(
        "get_number",
        getSetAttr,
        typeof<int>,
        Type.EmptyTypes)

let numberGetIL =
    methodBuilderNumberGetAccessor.GetILGenerator()

// For an instance property, argument zero ir 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, fieldBuilderNumber)
numberGetIL.Emit(OpCodes.Ret)

// Define the "set" accessor method for Number, which has no return
// type and takes one argument of type int (Int32).
let methodBuilderNumberSetAccessor =
    typeBuilder.DefineMethod(
        "set_number",
        getSetAttr,
        null,
        [| typeof<int> |])

let numberSetIL =
    methodBuilderNumberSetAccessor.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, fieldBuilderNumber)
numberSetIL.Emit(OpCodes.Ret)

// Last, map the "get" and "set" accessor methods to the
// PropertyBuilder. The property is now complete.
propertyBuilderNumber.SetGetMethod(methodBuilderNumberGetAccessor)
propertyBuilderNumber.SetSetMethod(methodBuilderNumberSetAccessor)

// 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.
let methodBuilder =
    typeBuilder.DefineMethod(
        "MyMethod",
        MethodAttributes.Public,
        typeof<int>,
        [| typeof<int> |])

let methodIL = methodBuilder.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.
methodIL.Emit(OpCodes.Ldarg_0)
methodIL.Emit(OpCodes.Ldfld, fieldBuilderNumber)
methodIL.Emit(OpCodes.Ldarg_1)
methodIL.Emit(OpCodes.Mul)
methodIL.Emit(OpCodes.Ret)

// Finish the type
let typ = typeBuilder.CreateType()

// Because AssemblyBuilderAccess includes Run, the code can be
// executed immediately. Start by getting reflection objects for
// the method and the property.
let methodInfo = typ.GetMethod("MyMethod")
let propertyInfo = typ.GetProperty("Number")

// Create an instance of MyDynamicType using the default
// constructor.
let obj1 = Activator.CreateInstance(typ)

// 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.
printfn "obj1.Number: %A" (propertyInfo.GetValue(obj1, null))
propertyInfo.SetValue(obj1, 127, null)
printfn "obj1.Number: %A" (propertyInfo.GetValue(obj1, null))

// Call MyMethod, pasing 22, and display the return value, 22
// times 127. Arguments must be passed as an array, even when
// there is only one.
let arguments: obj array = [| 22 |]
printfn "obj1.MyMethod(22): %A" (methodInfo.Invoke(obj1, 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.
let constructorArguments: obj array = [| 5280 |]
let obj2 = Activator.CreateInstance(typ, constructorArguments)
printfn "obj2.Number: %A" (propertyInfo.GetValue(obj2, null))

(* This code produces the following output:

obj1.Number: 42
obj1.Number: 127
obj1.MyMethod(22): 2794
obj1.Number: 5280
*)

Imports System.Reflection
Imports System.Reflection.Emit

Class DemoAssemblyBuilder

    Public Shared Sub Main()

        ' This code creates an assembly that 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 = _
            AssemblyBuilder.DefineDynamicAssembly( _
                aName, _
                AssemblyBuilderAccess.Run)

        ' The module name is usually the same as the assembly name.
        Dim mb As ModuleBuilder = ab.DefineDynamicModule( _
            aName.Name)
      
        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()

        ' 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

Keterangan

Rakitan dinamis adalah rakitan yang dibuat menggunakan API Reflection Emit. Rakitan dinamis dapat mereferensikan jenis yang ditentukan dalam rakitan dinamis atau statis lainnya. Anda dapat menggunakan AssemblyBuilder untuk menghasilkan rakitan dinamis dalam memori dan menjalankan kodenya selama eksekusi aplikasi yang sama. .NET 9 memperkenalkan PersistedAssemblyBuilder jenis dengan implementasi pantulan yang dikelola sepenuhnya yang memungkinkan Anda menyimpan rakitan ke file. Rakitan dinamis hanya dapat terdiri dari satu modul dinamis.

Rakitan dinamis yang dapat dijalankan di .NET

Untuk mendapatkan objek yang dapat AssemblyBuilder dijalankan, gunakan AssemblyBuilder.DefineDynamicAssembly metode . Rakitan dinamis dapat dibuat menggunakan salah satu mode akses berikut:

• AssemblyBuilderAccess.Run

  Rakitan dinamis yang diwakili oleh AssemblyBuilder dapat digunakan untuk mengeksekusi kode yang dihasilkan.

• AssemblyBuilderAccess.RunAndCollect

  Rakitan dinamis yang diwakili oleh dapat digunakan untuk menjalankan kode yang AssemblyBuilder dipancarkan dan secara otomatis direklamasi oleh pengumpul sampah.

Mode akses harus ditentukan dengan memberikan nilai AssemblyBuilderAccess yang sesuai dalam panggilan ke metode AssemblyBuilder.DefineDynamicAssembly ketika rakitan dinamis ditentukan dan tidak dapat diubah nanti. Runtime menggunakan mode akses rakitan dinamis untuk mengoptimalkan representasi internal rakitan.

Contoh berikut menunjukkan cara membuat dan menjalankan sebuah assembly:

public void CreateAndRunAssembly(string assemblyPath)
{
    AssemblyBuilder ab = AssemblyBuilder.DefineDynamicAssembly(new AssemblyName("MyAssembly"), AssemblyBuilderAccess.Run);
    ModuleBuilder mob = ab.DefineDynamicModule("MyModule");
    TypeBuilder tb = mob.DefineType("MyType", TypeAttributes.Public | TypeAttributes.Class);
    MethodBuilder mb = tb.DefineMethod("SumMethod", MethodAttributes.Public | MethodAttributes.Static,
                                                                   typeof(int), new Type[] {typeof(int), typeof(int)});
    ILGenerator il = mb.GetILGenerator();
    il.Emit(OpCodes.Ldarg_0);
    il.Emit(OpCodes.Ldarg_1);
    il.Emit(OpCodes.Add);
    il.Emit(OpCodes.Ret);

    Type type = tb.CreateType();

    MethodInfo method = type.GetMethod("SumMethod");
    Console.WriteLine(method.Invoke(null, new object[] { 5, 10 }));
}

Jenisnya PersistedAssemblyBuilder , yang berasal dari AssemblyBuilder, memungkinkan Anda menyimpan rakitan dinamis. Untuk informasi selengkapnya, lihat skenario penggunaan dan contoh di PersistedAssemblyBuilder.

Konstruktor

Nama	Deskripsi
AssemblyBuilder()	Menginisialisasi instans baru dari kelas AssemblyBuilder.

Properti

Nama	Deskripsi
CodeBase	Kedaluwarsa. Mendapatkan lokasi rakitan, seperti yang ditentukan awalnya (seperti dalam AssemblyName objek).
CustomAttributes	Mendapatkan koleksi yang berisi atribut kustom assembly ini. (Diperoleh dari Assembly)
DefinedTypes	Mendapatkan koleksi jenis yang ditentukan dalam rakitan ini. (Diperoleh dari Assembly)
EntryPoint	Mengembalikan titik masuk rakitan ini.
EscapedCodeBase	Kedaluwarsa. Mendapatkan URI, termasuk karakter escape, yang mewakili basis kode. (Diperoleh dari Assembly)
ExportedTypes	Mendapatkan kumpulan jenis publik yang ditentukan dalam rakitan ini yang terlihat di luar rakitan. (Diperoleh dari Assembly)
FullName	Mendapatkan nama tampilan rakitan dinamis saat ini.
GlobalAssemblyCache	Kedaluwarsa. Mendapatkan nilai yang menunjukkan apakah assembly dimuat dari cache assembly global (hanya.NET Framework). (Diperoleh dari Assembly)
HostContext	Mendapatkan konteks host tempat assembly dinamis sedang dibuat.
ImageRuntimeVersion	Mendapatkan string yang mewakili versi runtime bahasa umum (CLR) yang disimpan dalam file yang berisi manifes. (Diperoleh dari Assembly)
IsCollectible	Mendapatkan nilai yang menunjukkan apakah rakitan dinamis ini dipegang dalam koleksi AssemblyLoadContext.
IsDynamic	Mendapatkan nilai yang menunjukkan bahwa rakitan saat ini adalah rakitan dinamis.
IsFullyTrusted	Mendapatkan nilai yang menunjukkan apakah rakitan saat ini dimuat dengan kepercayaan penuh. (Diperoleh dari Assembly)
Location	Mendapatkan lokasi, dalam format basis kode, dari file yang dimuat yang berisi manifes jika tidak disalin bayangan.
ManifestModule	Mendapatkan modul dalam saat ini AssemblyBuilder yang berisi manifes perakitan.
Modules	Mendapatkan koleksi yang berisi modul dalam rakitan ini. (Diperoleh dari Assembly)
ReflectionOnly	Mendapatkan nilai yang menunjukkan apakah rakitan dinamis berada dalam konteks hanya refleksi.
SecurityRuleSet	Mendapatkan nilai yang menunjukkan kumpulan aturan keamanan mana yang diterapkan runtime bahasa umum (CLR) untuk rakitan ini. (Diperoleh dari Assembly)

Metode

Nama	Deskripsi
CreateInstance(String, Boolean, BindingFlags, Binder, Object[], CultureInfo, Object[])	Menemukan jenis yang ditentukan dari rakitan ini dan membuat instansnya menggunakan aktivator sistem, dengan pencarian peka huruf besar/kecil opsional dan memiliki kultur, argumen, dan atribut pengikatan dan aktivasi yang ditentukan. (Diperoleh dari Assembly)
CreateInstance(String, Boolean)	Menemukan jenis yang ditentukan dari rakitan ini dan membuat instansnya menggunakan aktivator sistem, dengan pencarian peka huruf besar/kecil opsional. (Diperoleh dari Assembly)
CreateInstance(String)	Menemukan jenis yang ditentukan dari rakitan ini dan membuat instansnya menggunakan aktivator sistem, menggunakan pencarian peka huruf besar/kecil. (Diperoleh dari Assembly)
DefineDynamicAssembly(AssemblyName, AssemblyBuilderAccess, IEnumerable<CustomAttributeBuilder>)	Menentukan rakitan dinamis yang memiliki nama, hak akses, dan atribut yang ditentukan.
DefineDynamicAssembly(AssemblyName, AssemblyBuilderAccess)	Menentukan rakitan dinamis yang memiliki nama dan hak akses yang ditentukan.
DefineDynamicModule(String)	Mendefinisikan modul dinamis sementara bernama dalam rakitan ini.
DefineDynamicModuleCore(String)	Ketika ditimpa dalam kelas turunan, mendefinisikan modul dinamis dalam rakitan ini.
Equals(Object)	Mengembalikan nilai yang menunjukkan apakah instans ini sama dengan objek yang ditentukan.
GetCustomAttributes(Boolean)	Mengembalikan semua atribut kustom yang telah diterapkan ke saat ini AssemblyBuilder.
GetCustomAttributes(Type, Boolean)	Mengembalikan semua atribut kustom yang telah diterapkan ke saat ini AssemblyBuilder, dan yang berasal dari jenis atribut tertentu.
GetCustomAttributesData()	Mengembalikan CustomAttributeData objek yang berisi informasi tentang atribut yang telah diterapkan ke .AssemblyBuilder
GetDynamicModule(String)	Mengembalikan modul dinamis dengan nama yang ditentukan.
GetDynamicModuleCore(String)	Saat ditimpa dalam kelas turunan, mengembalikan modul dinamis dengan nama yang ditentukan.
GetExportedTypes()	Mendapatkan jenis yang diekspor yang ditentukan dalam rakitan ini.
GetFile(String)	FileStream Mendapatkan untuk file yang ditentukan dalam tabel file manifes perakitan ini.
GetFiles()	Mendapatkan file dalam tabel file manifes perakitan. (Diperoleh dari Assembly)
GetFiles(Boolean)	Mendapatkan file dalam tabel file manifes perakitan, menentukan apakah akan menyertakan modul sumber daya.
GetForwardedTypes()	Mendefinisikan dan mewakili rakitan dinamis. (Diperoleh dari Assembly)
GetHashCode()	Mengembalikan kode hash untuk instans ini.
GetLoadedModules()	Mendapatkan semua modul yang dimuat yang merupakan bagian dari rakitan ini. (Diperoleh dari Assembly)
GetLoadedModules(Boolean)	Mengembalikan semua modul yang dimuat yang merupakan bagian dari rakitan ini, dan secara opsional menyertakan modul sumber daya.
GetManifestResourceInfo(String)	Mengembalikan informasi tentang bagaimana sumber daya yang diberikan telah dipertahankan.
GetManifestResourceNames()	Memuat sumber daya manifes yang ditentukan dari rakitan ini.
GetManifestResourceStream(String)	Memuat sumber daya manifes yang ditentukan dari rakitan ini.
GetManifestResourceStream(Type, String)	Memuat sumber daya manifes yang ditentukan, yang dicakup oleh namespace dari jenis yang ditentukan, dari rakitan ini.
GetModule(String)	Mendapatkan modul yang ditentukan dalam rakitan ini.
GetModules()	Mendapatkan semua modul yang merupakan bagian dari perakitan ini. (Diperoleh dari Assembly)
GetModules(Boolean)	Mendapatkan semua modul yang merupakan bagian dari perakitan ini, dan secara opsional menyertakan modul sumber daya.
GetName()	AssemblyName Mendapatkan untuk rakitan ini. (Diperoleh dari Assembly)
GetName(Boolean)	AssemblyName Mendapatkan yang ditentukan ketika rakitan dinamis saat ini dibuat, dan mengatur basis kode seperti yang ditentukan.
GetObjectData(SerializationInfo, StreamingContext)	Kedaluwarsa. Mendapatkan informasi serialisasi dengan semua data yang diperlukan untuk menginstansiasi kembali perakitan ini. (Diperoleh dari Assembly)
GetReferencedAssemblies()	Mendapatkan daftar AssemblyName objek yang tidak lengkap untuk rakitan yang dirujuk oleh ini AssemblyBuilder.
GetSatelliteAssembly(CultureInfo, Version)	Mendapatkan versi rakitan satelit yang ditentukan untuk budaya yang ditentukan.
GetSatelliteAssembly(CultureInfo)	Mendapatkan rakitan satelit untuk budaya yang ditentukan.
GetType(String, Boolean, Boolean)	Mendapatkan jenis yang ditentukan dari jenis yang telah ditentukan dan dibuat di saat ini AssemblyBuilder.
GetType(String, Boolean)	Mendapatkan objek dengan nama yang ditentukan dalam instans Type rakitan dan secara opsional melemparkan pengecualian jika jenisnya tidak ditemukan. (Diperoleh dari Assembly)
GetType(String)	Mendapatkan objek dengan nama yang ditentukan dalam instans Type rakitan. (Diperoleh dari Assembly)
GetTypes()	Mendapatkan semua jenis yang ditentukan dalam rakitan ini. (Diperoleh dari Assembly)
IsDefined(Type, Boolean)	Mengembalikan nilai yang menunjukkan apakah satu atau beberapa instans dari jenis atribut yang ditentukan diterapkan ke anggota ini.
LoadModule(String, Byte[], Byte[])	Memuat modul, internal ke rakitan ini, dengan gambar berbasis format file objek umum (COFF) yang berisi modul yang dipancarkan, atau file sumber daya. Byte mentah yang mewakili simbol untuk modul juga dimuat. (Diperoleh dari Assembly)
LoadModule(String, Byte[])	Memuat modul, internal ke rakitan ini, dengan gambar berbasis format file objek umum (COFF) yang berisi modul yang dipancarkan, atau file sumber daya. (Diperoleh dari Assembly)
MemberwiseClone()	Membuat salinan dangkal dari Objectsaat ini. (Diperoleh dari Object)
SetCustomAttribute(ConstructorInfo, Byte[])	Atur atribut kustom pada rakitan ini menggunakan blob atribut kustom tertentu.
SetCustomAttribute(CustomAttributeBuilder)	Atur atribut kustom pada rakitan ini menggunakan pembangun atribut kustom.
SetCustomAttributeCore(ConstructorInfo, ReadOnlySpan<Byte>)	Saat ditimpa di kelas turunan, atur atribut kustom pada rakitan ini.
ToString()	Mengembalikan nama lengkap rakitan, juga dikenal sebagai nama tampilan. (Diperoleh dari Assembly)

Acara

Nama	Deskripsi
ModuleResolve	Terjadi ketika pemuat kelas runtime bahasa umum tidak dapat menyelesaikan referensi ke modul internal perakitan melalui cara normal. (Diperoleh dari Assembly)

Metode Ekstensi

Nama	Deskripsi
GetCustomAttribute(Assembly, Type)	Mengambil atribut kustom dari jenis tertentu yang diterapkan ke rakitan tertentu.
GetCustomAttribute<T>(Assembly)	Mengambil atribut kustom dari jenis tertentu yang diterapkan ke rakitan tertentu.
GetCustomAttributes(Assembly, Type)	Mengambil kumpulan atribut kustom dari jenis tertentu yang diterapkan ke rakitan tertentu.
GetCustomAttributes(Assembly)	Mengambil kumpulan atribut kustom yang diterapkan ke rakitan tertentu.
GetCustomAttributes<T>(Assembly)	Mengambil kumpulan atribut kustom dari jenis tertentu yang diterapkan ke rakitan tertentu.
GetExportedTypes(Assembly)	Mendefinisikan dan mewakili rakitan dinamis.
GetModules(Assembly)	Mendefinisikan dan mewakili rakitan dinamis.
GetTypes(Assembly)	Mendefinisikan dan mewakili rakitan dinamis.
IsDefined(Assembly, Type)	Menunjukkan apakah atribut kustom dari jenis tertentu diterapkan ke rakitan tertentu.
TryGetRawMetadata(Assembly, Byte*, Int32)	Mengambil bagian metadata dari rakitan, untuk digunakan dengan MetadataReader.

Lihat juga

• DefineDynamicAssembly
• Memancarkan Metode dan Rakitan Dinamis