DynamicMethod Konstruktoren

Definition

Erstellt eine dynamische Methode.

Überlädt

Name Beschreibung
DynamicMethod(String, Type, Type[])

Initialisiert eine anonym gehostete dynamische Methode, wobei der Methodenname, der Rückgabetyp und die Parametertypen angegeben werden.

DynamicMethod(String, Type, Type[], Boolean)

Initialisiert eine anonym gehostete dynamische Methode, wobei der Methodenname, der Rückgabetyp, die Parametertypen angegeben werden und ob jiT-Sichtbarkeitsprüfungen für Typen und Member übersprungen werden sollen, auf die von der Microsoft Zwischensprache (MSIL) der dynamischen Methode zugegriffen wird.

DynamicMethod(String, Type, Type[], Module)

Erstellt eine dynamische Methode, die global für ein Modul ist, wobei der Methodenname, der Rückgabetyp, die Parametertypen und das Modul angegeben werden.

DynamicMethod(String, Type, Type[], Type)

Erstellt eine dynamische Methode, die den Methodennamen, rückgabetyp, Parametertypen und den Typ angibt, dem die dynamische Methode logisch zugeordnet ist.

DynamicMethod(String, Type, Type[], Module, Boolean)

Erstellt eine dynamische Methode, die für ein Modul global ist, wobei der Methodenname, der Rückgabetyp, parametertypen, das Modul angegeben wird und ob Die Sichtbarkeitsprüfungen für Typen und Member übersprungen werden sollen, auf die von der Microsoft Zwischensprache (MSIL) der dynamischen Methode zugegriffen wird.

DynamicMethod(String, Type, Type[], Type, Boolean)

Erstellt eine dynamische Methode, die den Methodennamen, den Rückgabetyp, Parametertypen, den Typ angibt, dem die dynamische Methode logisch zugeordnet ist und ob jiT-Sichtbarkeitsprüfungen für Typen und Member übersprungen werden sollen, auf die von der Microsoft Zwischensprache (MSIL) der dynamischen Methode zugegriffen wird.

DynamicMethod(String, MethodAttributes, CallingConventions, Type, Type[], Module, Boolean)

Erstellt eine dynamische Methode, die global für ein Modul ist, und gibt den Methodennamen, Attribute, Aufrufkonventionen, Rückgabetyp, Parametertypen, Modul und ob JiT-Sichtbarkeitsprüfungen für Typen und Member übersprungen werden sollen, auf die von der Microsoft Zwischensprache (MSIL) der dynamischen Methode zugegriffen wird.

DynamicMethod(String, MethodAttributes, CallingConventions, Type, Type[], Type, Boolean)

Erstellt eine dynamische Methode, die den Methodennamen, Attribute, Aufrufkonventionen, Rückgabetyp, Parametertypen, den Typ angibt, dem die dynamische Methode logisch zugeordnet ist, und ob jiT-Sichtbarkeitsprüfungen für Typen und Member übersprungen werden sollen, auf die von der Microsoft Zwischensprache (MSIL) der dynamischen Methode zugegriffen wird.

DynamicMethod(String, Type, Type[])

Initialisiert eine anonym gehostete dynamische Methode, wobei der Methodenname, der Rückgabetyp und die Parametertypen angegeben werden.

public:
 DynamicMethod(System::String ^ name, Type ^ returnType, cli::array <Type ^> ^ parameterTypes);
public DynamicMethod(string name, Type returnType, Type[] parameterTypes);
new System.Reflection.Emit.DynamicMethod : string * Type * Type[] -> System.Reflection.Emit.DynamicMethod
Public Sub New (name As String, returnType As Type, parameterTypes As Type())

Parameter

name
String

Der Name der dynamischen Methode. Dies kann eine leere Zeichenfolge sein, kann aber nicht sein null.

returnType
Type

Ein Type Objekt, das den Rückgabetyp der dynamischen Methode angibt oder null wenn die Methode keinen Rückgabetyp aufweist.

parameterTypes
Type[]

Ein Array von Type Objekten, die die Typen der Parameter der dynamischen Methode angeben oder null wenn die Methode keine Parameter aufweist.

Ausnahmen

Ein Element von parameterTypes ist null oder Void.

name ist null.

.NET Framework- und .NET Core-Versionen, die älter als 2.1 sind: returnType ist ein Typ, für den IsByReftrue zurückgibt.

Hinweise

Die dynamische Methode, die von diesem Konstruktor erstellt wird, ist einer anonymen Assembly anstelle eines vorhandenen Typs oder Moduls zugeordnet. Die anonyme Assembly ist nur vorhanden, um eine Sandkastenumgebung für dynamische Methoden bereitzustellen, d. h., sie von einem anderen Code zu isolieren. Diese Umgebung sorgt dafür, dass die dynamische Methode von teilweise vertrauenswürdigen Code ausgegeben und ausgeführt wird.

Dieser Konstruktor gibt an, dass Just-in-Time-Sichtbarkeitsprüfungen (Just-in-Time, JIT) für die Microsoft Zwischensprache (MSIL) der dynamischen Methode erzwungen werden. Das heißt, der Code in der dynamischen Methode hat Zugriff auf öffentliche Methoden öffentlicher Klassen. Ausnahmen werden ausgelöst, wenn die Methode versucht, auf Typen oder Member zuzugreifen, die private, protected oder internal (Friend in Visual Basic). Verwenden Sie den DynamicMethod(String, Type, Type[], Boolean) Konstruktor, um eine dynamische Methode zu erstellen, die eingeschränkte Möglichkeit zum Überspringen von JIT-Sichtbarkeitsprüfungen hat.

Wenn eine anonym gehostete dynamische Methode erstellt wird, ist der Aufrufstapel der emittierenden Assembly enthalten. Wenn die Methode aufgerufen wird, werden die Berechtigungen der emittierenden Assembly anstelle der Berechtigungen des tatsächlichen Aufrufers verwendet. Die dynamische Methode kann daher nicht auf einer höheren Berechtigungsebene ausgeführt werden als die der Assembly, die sie ausgegeben hat, auch wenn sie von einer Assembly übergeben und ausgeführt wird, die eine höhere Vertrauensebene aufweist.

Dieser Konstruktor gibt die Methodenattribute MethodAttributes.Public und MethodAttributes.Staticdie aufrufende Konvention CallingConventions.Standardan.

Note

Dieser Konstruktor wurde in .NET Framework 3.5 oder höher eingeführt.

Weitere Informationen

Gilt für:

DynamicMethod(String, Type, Type[], Boolean)

Initialisiert eine anonym gehostete dynamische Methode, wobei der Methodenname, der Rückgabetyp, die Parametertypen angegeben werden und ob jiT-Sichtbarkeitsprüfungen für Typen und Member übersprungen werden sollen, auf die von der Microsoft Zwischensprache (MSIL) der dynamischen Methode zugegriffen wird.

public:
 DynamicMethod(System::String ^ name, Type ^ returnType, cli::array <Type ^> ^ parameterTypes, bool restrictedSkipVisibility);
public DynamicMethod(string name, Type returnType, Type[] parameterTypes, bool restrictedSkipVisibility);
new System.Reflection.Emit.DynamicMethod : string * Type * Type[] * bool -> System.Reflection.Emit.DynamicMethod
Public Sub New (name As String, returnType As Type, parameterTypes As Type(), restrictedSkipVisibility As Boolean)

Parameter

name
String

Der Name der dynamischen Methode. Dies kann eine leere Zeichenfolge sein, kann aber nicht sein null.

returnType
Type

Ein Type Objekt, das den Rückgabetyp der dynamischen Methode angibt oder null wenn die Methode keinen Rückgabetyp aufweist.

parameterTypes
Type[]

Ein Array von Type Objekten, die die Typen der Parameter der dynamischen Methode angeben oder null wenn die Methode keine Parameter aufweist.

restrictedSkipVisibility
Boolean

trueum JIT-Sichtbarkeitsprüfungen für Typen und Member zu überspringen, auf die von der MSIL der dynamischen Methode zugegriffen wird, mit dieser Einschränkung: Die Vertrauensstufe der Assemblys, die diese Typen und Member enthalten, müssen gleich oder kleiner als die Vertrauensstufe des Aufrufstapels sein, der die dynamische Methode ausgibt; andernfalls . false

Ausnahmen

Ein Element von parameterTypes ist null oder Void.

name ist null.

.NET Framework- und .NET Core-Versionen, die älter als 2.1 sind: returnType ist ein Typ, für den IsByReftrue zurückgibt.

Hinweise

Die dynamische Methode, die von diesem Konstruktor erstellt wird, ist einer anonymen Assembly anstelle eines vorhandenen Typs oder Moduls zugeordnet. Die anonyme Assembly ist nur vorhanden, um eine Sandkastenumgebung für dynamische Methoden bereitzustellen, d. h., sie von einem anderen Code zu isolieren. Diese Umgebung sorgt dafür, dass die dynamische Methode von teilweise vertrauenswürdigen Code ausgegeben und ausgeführt wird.

Anonym gehostete dynamische Methoden haben keinen automatischen Zugriff auf Typen oder Member, die private, protected oder internal (Friend in Visual Basic). Dies unterscheidet sich von dynamischen Methoden, die einem vorhandenen Typ oder Modul zugeordnet sind, die Zugriff auf ausgeblendete Member in ihrem zugeordneten Bereich haben.

Geben Sie true für restrictedSkipVisibility an, wenn die dynamische Methode auf Typen oder Member zugreifen muss, die private, protected, oder internal. Dadurch erhält die dynamische Methode eingeschränkten Zugriff auf diese Member. Das heißt, auf die Mitglieder kann nur zugegriffen werden, wenn die folgenden Bedingungen erfüllt sind:

  • Die Zielmember gehören zu einer Assembly, die eine Vertrauensstufe aufweist, die gleich oder niedriger ist als die Aufrufkette, die die dynamische Methode emittiert.

  • Der Aufrufstapel, der die dynamische Methode ausgibt, wird mit dem ReflectionPermission-Flag und dem ReflectionPermissionFlag.RestrictedMemberAccess-Flag versehen. Dies gilt immer, wenn der Code mit voller Vertrauenswürdigheit ausgeführt wird. Bei teilweise vertrauenswürdigen Code gilt dies nur, wenn der Host die Berechtigung explizit erteilt.

    Important

    Wenn die Berechtigung nicht erteilt wurde, wird beim Aufruf oder beim Aufrufen der dynamischen Methode eine Sicherheits ausnahme ausgelöst CreateDelegate , nicht beim Aufrufen dieses Konstruktors. Zum Ausgeben der dynamischen Methode sind keine speziellen Berechtigungen erforderlich.

Beispielsweise kann eine dynamische Methode, die mit restrictedSkipVisibility set erstellt wird, auf true ein privates Mitglied einer beliebigen Assembly im Aufrufstapel zugreifen, wenn der Aufrufstapel eingeschränkten Memberzugriff gewährt wurde. Wenn die dynamische Methode mit teilweise vertrauenswürdigem Code im Aufrufstapel erstellt wird, kann sie nicht auf ein privates Mitglied eines Typs in einer .NET Framework-Assembly zugreifen, da solche Assemblys vollständig vertrauenswürdig sind.

Wenn restrictedSkipVisibilityfalse ist, werden JIT-Sichtbarkeitsprüfungen erzwungen. Der Code in der dynamischen Methode hat Zugriff auf öffentliche Methoden öffentlicher Klassen, und Ausnahmen werden ausgelöst, wenn versucht wird, auf Typen oder Member zuzugreifen, die private, protectedoder internal.

Wenn eine anonym gehostete dynamische Methode erstellt wird, ist der Aufrufstapel der emittierenden Assembly enthalten. Wenn die Methode aufgerufen wird, werden die Berechtigungen des emittierenden Aufrufstapels anstelle der Berechtigungen des tatsächlichen Aufrufers verwendet. Die dynamische Methode kann daher nicht auf einer höheren Berechtigungsebene ausgeführt werden als die der Assembly, die sie ausgegeben hat, auch wenn sie von einer Assembly übergeben und ausgeführt wird, die eine höhere Vertrauensebene aufweist.

Dieser Konstruktor gibt die Methodenattribute MethodAttributes.Public und MethodAttributes.Staticdie aufrufende Konvention CallingConventions.Standardan.

Note

Dieser Konstruktor wurde in .NET Framework 3.5 oder höher eingeführt.

Weitere Informationen

Gilt für:

DynamicMethod(String, Type, Type[], Module)

Erstellt eine dynamische Methode, die global für ein Modul ist, wobei der Methodenname, der Rückgabetyp, die Parametertypen und das Modul angegeben werden.

public:
 DynamicMethod(System::String ^ name, Type ^ returnType, cli::array <Type ^> ^ parameterTypes, System::Reflection::Module ^ m);
public DynamicMethod(string name, Type returnType, Type[] parameterTypes, System.Reflection.Module m);
new System.Reflection.Emit.DynamicMethod : string * Type * Type[] * System.Reflection.Module -> System.Reflection.Emit.DynamicMethod
Public Sub New (name As String, returnType As Type, parameterTypes As Type(), m As Module)

Parameter

name
String

Der Name der dynamischen Methode. Dies kann eine leere Zeichenfolge sein, kann aber nicht sein null.

returnType
Type

Ein Type Objekt, das den Rückgabetyp der dynamischen Methode angibt oder null wenn die Methode keinen Rückgabetyp aufweist.

parameterTypes
Type[]

Ein Array von Type Objekten, die die Typen der Parameter der dynamischen Methode angeben oder null wenn die Methode keine Parameter aufweist.

m
Module

A Module representing the module with which the dynamic method is to be logically associated.

Ausnahmen

Ein Element von parameterTypes ist null oder Void.

-oder-

m ist ein Modul, das anonymes Hosting für dynamische Methoden bereitstellt.

name ist null.

-oder-

m ist null.

.NET Framework- und .NET Core-Versionen, die älter als 2.1 sind: returnType ist ein Typ, für den IsByReftrue zurückgibt.

Beispiele

Im folgenden Codebeispiel wird eine dynamische Methode erstellt, die zwei Parameter verwendet. Im Beispiel wird ein einfacher Funktionstext ausgegeben, der den ersten Parameter in der Konsole druckt, und im Beispiel wird der zweite Parameter als Rückgabewert der Methode verwendet. Im Beispiel wird die Methode abgeschlossen, indem sie einen Delegaten erstellt, den Delegaten mit verschiedenen Parametern aufruft und schließlich die dynamische Methode mithilfe der Invoke(Object, BindingFlags, Binder, Object[], CultureInfo) Methode aufruft.

using System;
using System.Reflection;
using System.Reflection.Emit;
using Microsoft.VisualBasic;

public class Test
{
    // Declare a delegate that will be used to execute the completed
    // dynamic method.
    private delegate int HelloInvoker(string msg, int ret);

    public static void Main()
    {
        // Create an array that specifies the types of the parameters
        // of the dynamic method. This method has a string parameter
        // and an int parameter.
        Type[] helloArgs = {typeof(string), typeof(int)};

        // Create a dynamic method with the name "Hello", a return type
        // of int, and two parameters whose types are specified by the
        // array helloArgs. Create the method in the module that
        // defines the Test class.
        DynamicMethod hello = new DynamicMethod("Hello",
            typeof(int),
            helloArgs,
            typeof(Test).Module);

        // Create an array that specifies the parameter types of the
        // overload of Console.WriteLine to be used in Hello.
        Type[] writeStringArgs = {typeof(string)};
        // Get the overload of Console.WriteLine that has one
        // String parameter.
        MethodInfo writeString =
            typeof(Console).GetMethod("WriteLine", writeStringArgs);

        // Get an ILGenerator and emit a body for the dynamic method.
        ILGenerator il = hello.GetILGenerator();
        // Load the first argument, which is a string, onto the stack.
        il.Emit(OpCodes.Ldarg_0);
        // Call the overload of Console.WriteLine that prints a string.
        il.EmitCall(OpCodes.Call, writeString, null);
        // The Hello method returns the value of the second argument;
        // to do this, load the onto the stack and return.
        il.Emit(OpCodes.Ldarg_1);
        il.Emit(OpCodes.Ret);

        // Create a delegate that represents the dynamic method. This
        // action completes the method, and any further attempts to
        // change the method will cause an exception.
        HelloInvoker hi =
            (HelloInvoker) hello.CreateDelegate(typeof(HelloInvoker));

        // Use the delegate to execute the dynamic method. Save and
        // print the return value.
        int retval = hi("\r\nHello, World!", 42);
        Console.WriteLine("Executing delegate hi(\"Hello, World!\", 42) returned {0}",
            retval);

        // Do it again, with different arguments.
        retval = hi("\r\nHi, Mom!", 5280);
        Console.WriteLine("Executing delegate hi(\"Hi, Mom!\", 5280) returned {0}",
            retval);

        // Create an array of arguments to use with the Invoke method.
        object[] invokeArgs = {"\r\nHello, World!", 42};
        // Invoke the dynamic method using the arguments. This is much
        // slower than using the delegate, because you must create an
        // array to contain the arguments, and ValueType arguments
        // must be boxed.
        object objRet = hello.Invoke(null, invokeArgs);
        Console.WriteLine("hello.Invoke returned {0}", objRet);
    }
}
Imports System.Reflection
Imports System.Reflection.Emit

Public Class Test
    ' Declare a delegate that will be used to execute the completed
    ' dynamic method. 
    Private Delegate Function HelloInvoker(ByVal msg As String, _
        ByVal ret As Integer) As Integer

    Public Shared Sub Main()
        ' Create an array that specifies the types of the parameters
        ' of the dynamic method. This method has a String parameter
        ' and an Integer parameter.
        Dim helloArgs() As Type = {GetType(String), GetType(Integer)}

        ' Create a dynamic method with the name "Hello", a return type
        ' of Integer, and two parameters whose types are specified by
        ' the array helloArgs. Create the method in the module that
        ' defines the Test class.
        Dim hello As New DynamicMethod("Hello", _
            GetType(Integer), _
            helloArgs, _
            GetType(Test).Module)

        ' Create an array that specifies the parameter types of the
        ' overload of Console.WriteLine to be used in Hello.
        Dim writeStringArgs() As Type = {GetType(String)}
        ' Get the overload of Console.WriteLine that has one
        ' String parameter.
        Dim writeString As MethodInfo = GetType(Console). _
            GetMethod("WriteLine", writeStringArgs) 

        ' Get an ILGenerator and emit a body for the dynamic method.
        Dim il As ILGenerator = hello.GetILGenerator()
        ' Load the first argument, which is a string, onto the stack.
        il.Emit(OpCodes.Ldarg_0)
        ' Call the overload of Console.WriteLine that prints a string.
        il.EmitCall(OpCodes.Call, writeString, Nothing)
        ' The Hello method returns the value of the second argument;
        ' to do this, load the onto the stack and return.
        il.Emit(OpCodes.Ldarg_1)
        il.Emit(OpCodes.Ret)

        ' Create a delegate that represents the dynamic method. This
        ' action completes the method, and any further attempts to
        ' change the method will cause an exception.
    Dim hi As HelloInvoker = _
            hello.CreateDelegate(GetType(HelloInvoker))

        ' Use the delegate to execute the dynamic method. Save and
        ' print the return value.
        Dim retval As Integer = hi(vbCrLf & "Hello, World!", 42)
        Console.WriteLine("Executing delegate hi(""Hello, World!"", 42) returned " _
            & retval)

        ' Do it again, with different arguments.
        retval = hi(vbCrLf & "Hi, Mom!", 5280)
        Console.WriteLine("Executing delegate hi(""Hi, Mom!"", 5280) returned " _
            & retval)

        ' Create an array of arguments to use with the Invoke method.
        Dim invokeArgs() As Object = {vbCrLf & "Hello, World!", 42}
        ' Invoke the dynamic method using the arguments. This is much
        ' slower than using the delegate, because you must create an
        ' array to contain the arguments, and ValueType arguments
        ' must be boxed. Note that this overload of Invoke is 
        ' inherited from MethodBase, and simply calls the more 
        ' complete overload of Invoke.
        Dim objRet As Object = hello.Invoke(Nothing, invokeArgs)
        Console.WriteLine("hello.Invoke returned " & objRet)
    End Sub
End Class

' This code example produces the following output:
'
'Hello, World!
'Executing delegate hi("Hello, World!", 42) returned 42
'
'Hi, Mom!
'Executing delegate hi("Hi, Mom!", 5280) returned 5280
'
'Hello, World!
'hello.Invoke returned 42
'

Hinweise

Dieser Konstruktor gibt Methodenattribute MethodAttributes.Public und Aufrufkonventionen CallingConventions.Standardan MethodAttributes.Staticund überspringt keine Just-in-Time-Sichtbarkeitsprüfungen (JIT).

Die mit diesem Konstruktor erstellte dynamische Methode hat Zugriff auf öffentliche und internal (Friend in Visual Basic) Member aller Typen, die in Modul menthalten sind.

Note

Aus Gründen der Abwärtskompatibilität fordert dieser Konstruktor SecurityPermission mit dem SecurityPermissionFlag.ControlEvidence Flag an, wenn beide der folgenden Bedingungen erfüllt sind: m ist ein anderes Modul als das aufrufende Modul, und die Anforderung für ReflectionPermission mit dem ReflectionPermissionFlag.MemberAccess Flag ist fehlgeschlagen. Wenn die Anforderung von SecurityPermission erfolgreich ist, ist der Vorgang zulässig.

Weitere Informationen

Gilt für:

DynamicMethod(String, Type, Type[], Type)

Erstellt eine dynamische Methode, die den Methodennamen, rückgabetyp, Parametertypen und den Typ angibt, dem die dynamische Methode logisch zugeordnet ist.

public:
 DynamicMethod(System::String ^ name, Type ^ returnType, cli::array <Type ^> ^ parameterTypes, Type ^ owner);
public DynamicMethod(string name, Type returnType, Type[] parameterTypes, Type owner);
new System.Reflection.Emit.DynamicMethod : string * Type * Type[] * Type -> System.Reflection.Emit.DynamicMethod
Public Sub New (name As String, returnType As Type, parameterTypes As Type(), owner As Type)

Parameter

name
String

Der Name der dynamischen Methode. Dies kann eine leere Zeichenfolge sein, kann aber nicht sein null.

returnType
Type

Ein Type Objekt, das den Rückgabetyp der dynamischen Methode angibt oder null wenn die Methode keinen Rückgabetyp aufweist.

parameterTypes
Type[]

Ein Array von Type Objekten, die die Typen der Parameter der dynamischen Methode angeben oder null wenn die Methode keine Parameter aufweist.

owner
Type

A Type , mit dem die dynamische Methode logisch verknüpft ist. Die dynamische Methode hat Zugriff auf alle Member des Typs.

Ausnahmen

Ein Element von parameterTypes ist null oder Void.

-oder-

owner ist eine Schnittstelle, ein Array, ein offener generischer Typ oder ein Typparameter eines generischen Typs oder einer Methode.

name ist null.

-oder-

owner ist null.

.NET Framework- und .NET Core-Versionen, die älter als 2.1 sind: returnType ist ein Typ, für den IsByReftrue zurückgibt.

Beispiele

Im folgenden Codebeispiel wird ein DynamicMethod logisch einem Typ zugeordnete Code erstellt. Diese Zuordnung gewährt ihr Zugriff auf die privaten Mitglieder dieses Typs.

Das Codebeispiel definiert eine Klasse Example mit einem privaten Feld, einer Klasse mit dem Namen DerivedFromExample , die von der ersten Klasse abgeleitet wird, einen Delegattyp, UseLikeStatic der zurückgegeben Int32 wird und Parameter vom Typ Example hat, und Int32einen Delegattyp mit dem Namen UseLikeInstance , der zurückgegeben Int32 wird und einen Parameter vom Typ Int32hat.

Der Beispielcode erstellt dann ein DynamicMethod-Objekt, das das private Feld einer Instanz von Example ändert und den vorherigen Wert zurückgibt.

Note

Im Allgemeinen ist das Ändern der internen Klassenfelder keine gute objektorientierte Codierungspraxis.

Der Beispielcode erstellt eine Instanz von Example und erstellt dann zwei Stellvertretungen. Der erste ist vom Typ UseLikeStatic, der die gleichen Parameter wie die dynamische Methode hat. Die zweite ist vom Typ UseLikeInstance, der den ersten Parameter (vom Typ Example) fehlt. Dieser Delegat wird mithilfe der CreateDelegate(Type, Object) Methodenüberladung erstellt. Der zweite Parameter dieser Methodenüberladung ist eine Instanz von Example, in diesem Fall die soeben erstellte Instanz, die an den neu erstellten Delegaten gebunden ist. Wenn diese Stellvertretung aufgerufen wird, wirkt die dynamische Methode auf die gebundene Instanz von Example.

Note

Dies ist ein Beispiel für die lockeren Regeln für die in .NET Framework 2.0 eingeführte Stellvertretungsbindung sowie neue Überladungen der Delegate.CreateDelegate Methode. Weitere Informationen finden Sie in der Delegate Klasse.

Der UseLikeStatic Delegat wird aufgerufen und übergibt die Instanz, die Example an den UseLikeInstance Delegaten gebunden ist. Anschließend wird der UseLikeInstance-Delegate aufgerufen, sodass beide Delegates auf dieselbe Instanz von Example wirken. Die Änderungen an den Werten des internen Felds werden nach jedem Aufruf angezeigt. Schließlich wird ein UseLikeInstance Delegat an eine Instanz von DerivedFromExample gebunden, und die Delegataufrufe werden wiederholt.

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

// These classes are for demonstration purposes.
//
public class Example
{
    private int id = 0;
    public Example(int id)
    {
        this.id = id;
    }
    public int ID { get { return id; }}
}

public class DerivedFromExample : Example
{
    public DerivedFromExample(int id) : base(id) {}
}

// Two delegates are declared: UseLikeInstance treats the dynamic
// method as if it were an instance method, and UseLikeStatic
// treats the dynamic method in the ordinary fashion.
//
public delegate int UseLikeInstance(int newID);
public delegate int UseLikeStatic(Example ex, int newID);

public class Demo
{
    public static void Main()
    {
        // This dynamic method changes the private id field. It has
        // no name; it returns the old id value (return type int);
        // it takes two parameters, an instance of Example and
        // an int that is the new value of id; and it is declared
        // with Example as the owner type, so it can access all
        // members, public and private.
        //
        DynamicMethod changeID = new DynamicMethod(
            "",
            typeof(int),
            new Type[] { typeof(Example), typeof(int) },
            typeof(Example)
        );

        // Get a FieldInfo for the private field 'id'.
        FieldInfo fid = typeof(Example).GetField(
            "id",
            BindingFlags.NonPublic | BindingFlags.Instance
        );

        ILGenerator ilg = changeID.GetILGenerator();

        // Push the current value of the id field onto the
        // evaluation stack. It's an instance field, so load the
        // instance of Example before accessing the field.
        ilg.Emit(OpCodes.Ldarg_0);
        ilg.Emit(OpCodes.Ldfld, fid);

        // Load the instance of Example again, load the new value
        // of id, and store the new field value.
        ilg.Emit(OpCodes.Ldarg_0);
        ilg.Emit(OpCodes.Ldarg_1);
        ilg.Emit(OpCodes.Stfld, fid);

        // The original value of the id field is now the only
        // thing on the stack, so return from the call.
        ilg.Emit(OpCodes.Ret);

        // Create a delegate that uses changeID in the ordinary
        // way, as a static method that takes an instance of
        // Example and an int.
        //
        UseLikeStatic uls =
            (UseLikeStatic) changeID.CreateDelegate(
                typeof(UseLikeStatic)
            );

        // Create an instance of Example with an id of 42.
        //
        Example ex = new Example(42);

        // Create a delegate that is bound to the instance of
        // of Example. This is possible because the first
        // parameter of changeID is of type Example. The
        // delegate has all the parameters of changeID except
        // the first.
        UseLikeInstance uli =
            (UseLikeInstance) changeID.CreateDelegate(
                typeof(UseLikeInstance),
                ex
            );

        // First, change the value of id by calling changeID as
        // a static method, passing in the instance of Example.
        //
        Console.WriteLine(
            "Change the value of id; previous value: {0}",
            uls(ex, 1492)
        );

        // Change the value of id again using the delegate bound
        // to the instance of Example.
        //
        Console.WriteLine(
            "Change the value of id; previous value: {0}",
            uli(2700)
        );

        Console.WriteLine("Final value of id: {0}", ex.ID);

        // Now repeat the process with a class that derives
        // from Example.
        //
        DerivedFromExample dfex = new DerivedFromExample(71);

        uli = (UseLikeInstance) changeID.CreateDelegate(
                typeof(UseLikeInstance),
                dfex
            );

        Console.WriteLine(
            "Change the value of id; previous value: {0}",
            uls(dfex, 73)
        );
        Console.WriteLine(
            "Change the value of id; previous value: {0}",
            uli(79)
        );
        Console.WriteLine("Final value of id: {0}", dfex.ID);
    }
}

/* This code example produces the following output:

Change the value of id; previous value: 42
Change the value of id; previous value: 1492
Final value of id: 2700
Change the value of id; previous value: 71
Change the value of id; previous value: 73
Final value of id: 79
 */
Imports System.Reflection
Imports System.Reflection.Emit

' These classes are for demonstration purposes.
'
Public Class Example
    Private _id As Integer = 0
    
    Public Sub New(ByVal newId As Integer) 
        _id = newId    
    End Sub
    
    Public ReadOnly Property ID() As Integer 
        Get
            Return _id
        End Get
    End Property 
End Class

Public Class DerivedFromExample
    Inherits Example
    
    Public Sub New(ByVal newId As Integer) 
        MyBase.New(newId)
    End Sub
End Class
 
' Two delegates are declared: UseLikeInstance treats the dynamic
' method as if it were an instance method, and UseLikeStatic
' treats the dynamic method in the ordinary fashion.
' 
Public Delegate Function UseLikeInstance(ByVal newID As Integer) _
    As Integer 
Public Delegate Function UseLikeStatic(ByVal ex As Example, _
    ByVal newID As Integer) As Integer 

Public Class Demo
    
    Public Shared Sub Main() 
        ' This dynamic method changes the private _id field. It 
        ' has no name; it returns the old _id value (return type 
        ' Integer); it takes two parameters, an instance of Example 
        ' and an Integer that is the new value of _id; and it is 
        ' declared with Example as the owner type, so it can 
        ' access all members, public and private.
        '
        Dim changeID As New DynamicMethod( _
            "", _
            GetType(Integer), _
            New Type() {GetType(Example), GetType(Integer)}, _
            GetType(Example) _
        )
        
        ' Get a FieldInfo for the private field '_id'.
        Dim fid As FieldInfo = GetType(Example).GetField( _
            "_id", _
            BindingFlags.NonPublic Or BindingFlags.Instance _
        )
        
        Dim ilg As ILGenerator = changeID.GetILGenerator()
        
        ' Push the current value of the id field onto the 
        ' evaluation stack. It's an instance field, so load the
        ' instance of Example before accessing the field.
        ilg.Emit(OpCodes.Ldarg_0)
        ilg.Emit(OpCodes.Ldfld, fid)
        
        ' Load the instance of Example again, load the new value 
        ' of id, and store the new field value. 
        ilg.Emit(OpCodes.Ldarg_0)
        ilg.Emit(OpCodes.Ldarg_1)
        ilg.Emit(OpCodes.Stfld, fid)
        
        ' The original value of the id field is now the only 
        ' thing on the stack, so return from the call.
        ilg.Emit(OpCodes.Ret)
        
        
        ' Create a delegate that uses changeID in the ordinary
        ' way, as a static method that takes an instance of
        ' Example and an Integer.
        '
        Dim uls As UseLikeStatic = CType( _
            changeID.CreateDelegate(GetType(UseLikeStatic)), _
            UseLikeStatic _
        )
        
        ' Create an instance of Example with an id of 42.
        '
        Dim ex As New Example(42)
        
        ' Create a delegate that is bound to the instance of 
        ' of Example. This is possible because the first 
        ' parameter of changeID is of type Example. The 
        ' delegate has all the parameters of changeID except
        ' the first.
        Dim uli As UseLikeInstance = CType( _
            changeID.CreateDelegate( _
                GetType(UseLikeInstance), _
                ex), _
            UseLikeInstance _
        )
        
        ' First, change the value of _id by calling changeID as
        ' a static method, passing in the instance of Example.
        '
        Console.WriteLine( _
            "Change the value of _id; previous value: {0}", _
            uls(ex, 1492) _
        )
        
        ' Change the value of _id again using the delegate 
        ' bound to the instance of Example.
        '
        Console.WriteLine( _
            "Change the value of _id; previous value: {0}", _
            uli(2700) _
        )
        
        Console.WriteLine("Final value of _id: {0}", ex.ID)
    

        ' Now repeat the process with a class that derives
        ' from Example.
        '
        Dim dfex As New DerivedFromExample(71)

        uli = CType( _
            changeID.CreateDelegate( _
                GetType(UseLikeInstance), _
                dfex), _
            UseLikeInstance _
        )

        Console.WriteLine( _
            "Change the value of _id; previous value: {0}", _
            uls(dfex, 73) _
        )
        Console.WriteLine( _
            "Change the value of _id; previous value: {0}", _
            uli(79) _
        )
        Console.WriteLine("Final value of _id: {0}", dfex.ID)

    End Sub
End Class

' This code example produces the following output:
'
'Change the value of _id; previous value: 42
'Change the value of _id; previous value: 1492
'Final value of _id: 2700
'Change the value of _id; previous value: 71
'Change the value of _id; previous value: 73
'Final value of _id: 79'

Hinweise

Die mit diesem Konstruktor erstellte dynamische Methode hat Zugriff auf alle Member des Typs owner, sowie auf öffentliche und internal (Friend in Visual Basic) Member aller anderen Typen in dem Modul, das owner enthält.

Dieser Konstruktor gibt Methodenattribute MethodAttributes.Public und Aufrufkonventionen CallingConventions.Standardan MethodAttributes.Staticund überspringt keine Just-in-Time-Sichtbarkeitsprüfungen (JIT).

Note

Aus Gründen der Abwärtskompatibilität fordert dieser Konstruktor SecurityPermission mit dem SecurityPermissionFlag.ControlEvidence-Flag an, wenn die folgenden Bedingungen erfüllt sind: owner befindet sich in einem anderen Modul als dem aufrufenden Modul, und die Anforderung für ReflectionPermission, das ReflectionPermissionFlag.MemberAccess-Flag, ist fehlgeschlagen. Wenn die Anforderung von SecurityPermission erfolgreich ist, ist der Vorgang zulässig.

Weitere Informationen

Gilt für:

DynamicMethod(String, Type, Type[], Module, Boolean)

Erstellt eine dynamische Methode, die für ein Modul global ist, wobei der Methodenname, der Rückgabetyp, parametertypen, das Modul angegeben wird und ob Die Sichtbarkeitsprüfungen für Typen und Member übersprungen werden sollen, auf die von der Microsoft Zwischensprache (MSIL) der dynamischen Methode zugegriffen wird.

public:
 DynamicMethod(System::String ^ name, Type ^ returnType, cli::array <Type ^> ^ parameterTypes, System::Reflection::Module ^ m, bool skipVisibility);
public DynamicMethod(string name, Type returnType, Type[] parameterTypes, System.Reflection.Module m, bool skipVisibility);
new System.Reflection.Emit.DynamicMethod : string * Type * Type[] * System.Reflection.Module * bool -> System.Reflection.Emit.DynamicMethod
Public Sub New (name As String, returnType As Type, parameterTypes As Type(), m As Module, skipVisibility As Boolean)

Parameter

name
String

Der Name der dynamischen Methode. Dies kann eine leere Zeichenfolge sein, kann aber nicht sein null.

returnType
Type

Ein Type Objekt, das den Rückgabetyp der dynamischen Methode angibt oder null wenn die Methode keinen Rückgabetyp aufweist.

parameterTypes
Type[]

Ein Array von Type Objekten, die die Typen der Parameter der dynamischen Methode angeben oder null wenn die Methode keine Parameter aufweist.

m
Module

A Module representing the module with which the dynamic method is to be logically associated.

skipVisibility
Boolean

true um JIT-Sichtbarkeitsprüfungen für Typen und Member zu überspringen, auf die vom MSIL der dynamischen Methode zugegriffen wird.

Ausnahmen

Ein Element von parameterTypes ist null oder Void.

-oder-

m ist ein Modul, das anonymes Hosting für dynamische Methoden bereitstellt.

name ist null.

-oder-

m ist null.

.NET Framework- und .NET Core-Versionen, die älter als 2.1 sind: returnType ist ein Typ, für den IsByReftrue zurückgibt.

Hinweise

Dieser Konstruktor gibt Methodenattribute MethodAttributes.Public und MethodAttributes.Static- und Aufrufkonventionen CallingConventions.Standardan.

Die mit diesem Konstruktor erstellte dynamische Methode hat Zugriff auf öffentliche und internal (Friend in Visual Basic) Member aller Typen in enthaltenen Modul m. Wenn Sie die Sichtbarkeitsprüfungen des JIT-Compilers überspringen, kann die dynamische Methode auch auf private und geschützte Member aller anderen Typen zugreifen. Dies ist beispielsweise hilfreich, wenn Sie Code zum Serialisieren von Objekten schreiben.

Note

Aus Gründen der Abwärtskompatibilität fordert dieser Konstruktor SecurityPermission mit dem SecurityPermissionFlag.ControlEvidence Flag an, wenn beide der folgenden Bedingungen erfüllt sind: m ist ein anderes Modul als das aufrufende Modul, und die Anforderung für ReflectionPermission mit dem ReflectionPermissionFlag.MemberAccess Flag ist fehlgeschlagen. Wenn die Anforderung von SecurityPermission erfolgreich ist, ist der Vorgang zulässig.

Weitere Informationen

Gilt für:

DynamicMethod(String, Type, Type[], Type, Boolean)

Erstellt eine dynamische Methode, die den Methodennamen, den Rückgabetyp, Parametertypen, den Typ angibt, dem die dynamische Methode logisch zugeordnet ist und ob jiT-Sichtbarkeitsprüfungen für Typen und Member übersprungen werden sollen, auf die von der Microsoft Zwischensprache (MSIL) der dynamischen Methode zugegriffen wird.

public:
 DynamicMethod(System::String ^ name, Type ^ returnType, cli::array <Type ^> ^ parameterTypes, Type ^ owner, bool skipVisibility);
public DynamicMethod(string name, Type returnType, Type[] parameterTypes, Type owner, bool skipVisibility);
new System.Reflection.Emit.DynamicMethod : string * Type * Type[] * Type * bool -> System.Reflection.Emit.DynamicMethod
Public Sub New (name As String, returnType As Type, parameterTypes As Type(), owner As Type, skipVisibility As Boolean)

Parameter

name
String

Der Name der dynamischen Methode. Dies kann eine leere Zeichenfolge sein, kann aber nicht sein null.

returnType
Type

Ein Type Objekt, das den Rückgabetyp der dynamischen Methode angibt oder null wenn die Methode keinen Rückgabetyp aufweist.

parameterTypes
Type[]

Ein Array von Type Objekten, die die Typen der Parameter der dynamischen Methode angeben oder null wenn die Methode keine Parameter aufweist.

owner
Type

A Type , mit dem die dynamische Methode logisch verknüpft ist. Die dynamische Methode hat Zugriff auf alle Member des Typs.

skipVisibility
Boolean

truejiT-Sichtbarkeitsprüfungen über Typen und Member zu überspringen, auf die vom MSIL der dynamischen Methode zugegriffen wird; andernfalls . false

Ausnahmen

Ein Element von parameterTypes ist null oder Void.

-oder-

owner ist eine Schnittstelle, ein Array, ein offener generischer Typ oder ein Typparameter eines generischen Typs oder einer Methode.

name ist null.

-oder-

owner ist null.

.NET Framework- und .NET Core-Versionen, die älter als 2.1 sind: returnType ist ein Typ, für den IsByReftrue zurückgibt.

Hinweise

Die mit diesem Konstruktor erstellte dynamische Methode hat Zugriff auf alle Member des Typs owner, sowie auf öffentliche und internal (Friend in Visual Basic) Member aller anderen Typen in dem Modul, das owner enthält. Wenn Sie die Sichtbarkeitsprüfungen des JIT-Compilers überspringen, kann die dynamische Methode auch auf private und geschützte Member aller anderen Typen zugreifen. Dies ist beispielsweise hilfreich, wenn Sie Code zum Serialisieren von Objekten schreiben.

Dieser Konstruktor gibt Methodenattribute MethodAttributes.Public und MethodAttributes.Static- und Aufrufkonventionen CallingConventions.Standardan.

Note

Aus Gründen der Abwärtskompatibilität fordert dieser Konstruktor SecurityPermission mit dem SecurityPermissionFlag.ControlEvidence-Flag an, wenn die folgenden Bedingungen erfüllt sind: owner befindet sich in einem anderen Modul als dem aufrufenden Modul, und die Anforderung für ReflectionPermission, das ReflectionPermissionFlag.MemberAccess-Flag, ist fehlgeschlagen. Wenn die Anforderung von SecurityPermission erfolgreich ist, ist der Vorgang zulässig.

Weitere Informationen

Gilt für:

DynamicMethod(String, MethodAttributes, CallingConventions, Type, Type[], Module, Boolean)

Erstellt eine dynamische Methode, die global für ein Modul ist, und gibt den Methodennamen, Attribute, Aufrufkonventionen, Rückgabetyp, Parametertypen, Modul und ob JiT-Sichtbarkeitsprüfungen für Typen und Member übersprungen werden sollen, auf die von der Microsoft Zwischensprache (MSIL) der dynamischen Methode zugegriffen wird.

public:
 DynamicMethod(System::String ^ name, System::Reflection::MethodAttributes attributes, System::Reflection::CallingConventions callingConvention, Type ^ returnType, cli::array <Type ^> ^ parameterTypes, System::Reflection::Module ^ m, bool skipVisibility);
public DynamicMethod(string name, System.Reflection.MethodAttributes attributes, System.Reflection.CallingConventions callingConvention, Type returnType, Type[] parameterTypes, System.Reflection.Module m, bool skipVisibility);
new System.Reflection.Emit.DynamicMethod : string * System.Reflection.MethodAttributes * System.Reflection.CallingConventions * Type * Type[] * System.Reflection.Module * bool -> System.Reflection.Emit.DynamicMethod
Public Sub New (name As String, attributes As MethodAttributes, callingConvention As CallingConventions, returnType As Type, parameterTypes As Type(), m As Module, skipVisibility As Boolean)

Parameter

name
String

Der Name der dynamischen Methode. Dies kann eine leere Zeichenfolge sein, kann aber nicht sein null.

attributes
MethodAttributes

Eine bitweise Kombination von MethodAttributes Werten, die die Attribute der dynamischen Methode angibt. Die einzige zulässige Kombination ist Public und Static.

callingConvention
CallingConventions

Die Aufrufkonvention für die dynamische Methode. Muss Standard sein.

returnType
Type

Ein Type Objekt, das den Rückgabetyp der dynamischen Methode angibt oder null wenn die Methode keinen Rückgabetyp aufweist.

parameterTypes
Type[]

Ein Array von Type Objekten, die die Typen der Parameter der dynamischen Methode angeben oder null wenn die Methode keine Parameter aufweist.

m
Module

A Module representing the module with which the dynamic method is to be logically associated.

skipVisibility
Boolean

truejiT-Sichtbarkeitsprüfungen über Typen und Member zu überspringen, auf die vom MSIL der dynamischen Methode zugegriffen wird; andernfalls . false

Ausnahmen

Ein Element von parameterTypes ist null oder Void.

-oder-

m ist ein Modul, das anonymes Hosting für dynamische Methoden bereitstellt.

name ist null.

-oder-

m ist null.

attributes ist eine Kombination aus anderen Kennzeichen als Public und Static.

-oder-

callingConvention ist nicht Standard.

-oder-

returnType ist ein Typ, für den IsByRef zurückgegeben wird true.

Hinweise

Die mit diesem Konstruktor erstellte dynamische Methode hat Zugriff auf öffentliche und internal (Friend in Visual Basic) Member aller öffentlichen und internen Typen, die in Modul m enthalten sind.

Wenn Sie die Sichtbarkeitsprüfungen des JIT-Compilers überspringen, kann die dynamische Methode auch auf private und geschützte Member aller anderen Typen im Modul und in allen anderen Assemblys zugreifen. Dies ist beispielsweise hilfreich, wenn Sie Code zum Serialisieren von Objekten schreiben.

Note

Aus Gründen der Abwärtskompatibilität fordert dieser Konstruktor SecurityPermission mit dem SecurityPermissionFlag.ControlEvidence Flag an, wenn beide der folgenden Bedingungen erfüllt sind: m ist ein anderes Modul als das aufrufende Modul, und die Anforderung für ReflectionPermission mit dem ReflectionPermissionFlag.MemberAccess Flag ist fehlgeschlagen. Wenn die Anforderung von SecurityPermission erfolgreich ist, ist der Vorgang zulässig.

Weitere Informationen

Gilt für:

DynamicMethod(String, MethodAttributes, CallingConventions, Type, Type[], Type, Boolean)

Erstellt eine dynamische Methode, die den Methodennamen, Attribute, Aufrufkonventionen, Rückgabetyp, Parametertypen, den Typ angibt, dem die dynamische Methode logisch zugeordnet ist, und ob jiT-Sichtbarkeitsprüfungen für Typen und Member übersprungen werden sollen, auf die von der Microsoft Zwischensprache (MSIL) der dynamischen Methode zugegriffen wird.

public:
 DynamicMethod(System::String ^ name, System::Reflection::MethodAttributes attributes, System::Reflection::CallingConventions callingConvention, Type ^ returnType, cli::array <Type ^> ^ parameterTypes, Type ^ owner, bool skipVisibility);
public DynamicMethod(string name, System.Reflection.MethodAttributes attributes, System.Reflection.CallingConventions callingConvention, Type returnType, Type[] parameterTypes, Type owner, bool skipVisibility);
new System.Reflection.Emit.DynamicMethod : string * System.Reflection.MethodAttributes * System.Reflection.CallingConventions * Type * Type[] * Type * bool -> System.Reflection.Emit.DynamicMethod
Public Sub New (name As String, attributes As MethodAttributes, callingConvention As CallingConventions, returnType As Type, parameterTypes As Type(), owner As Type, skipVisibility As Boolean)

Parameter

name
String

Der Name der dynamischen Methode. Dies kann eine leere Zeichenfolge sein, kann aber nicht sein null.

attributes
MethodAttributes

Eine bitweise Kombination von MethodAttributes Werten, die die Attribute der dynamischen Methode angibt. Die einzige zulässige Kombination ist Public und Static.

callingConvention
CallingConventions

Die Aufrufkonvention für die dynamische Methode. Muss Standard sein.

returnType
Type

Ein Type Objekt, das den Rückgabetyp der dynamischen Methode angibt oder null wenn die Methode keinen Rückgabetyp aufweist.

parameterTypes
Type[]

Ein Array von Type Objekten, die die Typen der Parameter der dynamischen Methode angeben oder null wenn die Methode keine Parameter aufweist.

owner
Type

A Type , mit dem die dynamische Methode logisch verknüpft ist. Die dynamische Methode hat Zugriff auf alle Member des Typs.

skipVisibility
Boolean

truejiT-Sichtbarkeitsprüfungen über Typen und Member zu überspringen, auf die vom MSIL der dynamischen Methode zugegriffen wird; andernfalls . false

Ausnahmen

Ein Element von parameterTypes ist null oder Void.

-oder-

owner ist eine Schnittstelle, ein Array, ein offener generischer Typ oder ein Typparameter eines generischen Typs oder einer Methode.

name ist null.

-oder-

owner ist null.

attributes ist eine Kombination aus anderen Kennzeichen als Public und Static.

-oder-

callingConvention ist nicht Standard.

-oder-

returnType ist ein Typ, für den IsByRef zurückgegeben wird true.

Hinweise

Die dynamische Methode ist global für das Modul, das den Typ ownerenthält. Er hat Zugriff auf alle Member des Typs owner.

Die mit diesem Konstruktor erstellte dynamische Methode hat Zugriff auf alle Member des Typs owner sowie auf öffentliche und internal (Friend in Visual Basic) Member aller Typen, die im Modul enthalten sind, das owner enthält. Wenn Sie die Sichtbarkeitsprüfungen des JIT-Compilers überspringen, kann die dynamische Methode auch auf private und geschützte Member aller anderen Typen zugreifen. Dies ist beispielsweise hilfreich, wenn Sie Code zum Serialisieren von Objekten schreiben.

Note

Aus Gründen der Abwärtskompatibilität fordert dieser Konstruktor SecurityPermission mit dem SecurityPermissionFlag.ControlEvidence-Flag an, wenn die folgenden Bedingungen erfüllt sind: owner befindet sich in einem anderen Modul als dem aufrufenden Modul, und die Anforderung für ReflectionPermission, das ReflectionPermissionFlag.MemberAccess-Flag, ist fehlgeschlagen. Wenn die Anforderung von SecurityPermission erfolgreich ist, ist der Vorgang zulässig.

Weitere Informationen

Gilt für: