Auf Englisch lesen

Teilen über


Type.GetMethod Methode

Definition

Ruft eine bestimmte Methode des aktuellen Type ab.

Überlädt

GetMethod(String, Int32, BindingFlags, Binder, CallingConventions, Type[], ParameterModifier[])

Sucht nach der angegebenen Methode, deren Parameter der angegebenen Anzahl generischer Parameter und den angegebenen Argumenttypen und -modifizierern entsprechen, und verwendet dabei die angegebenen Bindungseinschränkungen und die angegebene Aufrufkonvention.

GetMethod(String, BindingFlags, Binder, CallingConventions, Type[], ParameterModifier[])

Sucht nach der angegebenen Methode, deren Parameter den angegebenen Argumenttypen und -modifizierern entsprechen, und verwendet dabei die angegebenen Bindungseinschränkungen und die angegebene Aufrufkonvention.

GetMethod(String, Int32, BindingFlags, Binder, Type[], ParameterModifier[])

Sucht unter Verwendung der angegebenen Bindungseinschränkungen nach der angegebenen Methode, deren Parameter der angegebenen Anzahl generischer Parameter und den angegebenen Argumenttypen und -modifizierern entsprechen.

GetMethod(String, BindingFlags, Binder, Type[], ParameterModifier[])

Sucht unter Verwendung der angegebenen Bindungseinschränkungen nach der angegebenen Methode, deren Parameter den angegebenen Argumenttypen und -modifizierern entsprechen.

GetMethod(String, Int32, Type[], ParameterModifier[])

Sucht die angegebene öffentliche Methode, deren Parameter der angegebenen Anzahl generischer Parameter und den angegebenen Argumenttypen und -modifizierern entsprechen.

GetMethod(String, Int32, BindingFlags, Type[])
GetMethod(String, BindingFlags)

Sucht die angegebene Methode unter Verwendung der angegebenen Bindungseinschränkungen.

GetMethod(String, BindingFlags, Type[])

Sucht unter Verwendung der angegebenen Bindungseinschränkungen nach der angegebenen Methode, deren Parameter mit den angegebenen Argumenttypen übereinstimmen.

GetMethod(String, Int32, Type[])

Sucht die angegebene öffentliche Methode, deren Parameter der angegebenen Anzahl generischer Parameter und den angegebenen Argumenttypen entsprechen.

GetMethod(String, Type[])

Sucht die angegebene öffentliche Methode, deren Parameter den angegebenen Argumenttypen entsprechen.

GetMethod(String)

Sucht die öffentliche Methode mit dem angegebenen Namen.

GetMethod(String, Type[], ParameterModifier[])

Sucht die angegebene öffentliche Methode, deren Parameter den angegebenen Argumenttypen und -modifizierern entsprechen.

GetMethod(String, Int32, BindingFlags, Binder, CallingConventions, Type[], ParameterModifier[])

Quelle:
Type.cs
Quelle:
Type.cs
Quelle:
Type.cs

Sucht nach der angegebenen Methode, deren Parameter der angegebenen Anzahl generischer Parameter und den angegebenen Argumenttypen und -modifizierern entsprechen, und verwendet dabei die angegebenen Bindungseinschränkungen und die angegebene Aufrufkonvention.

C#
public System.Reflection.MethodInfo? GetMethod (string name, int genericParameterCount, System.Reflection.BindingFlags bindingAttr, System.Reflection.Binder? binder, System.Reflection.CallingConventions callConvention, Type[] types, System.Reflection.ParameterModifier[]? modifiers);
C#
public System.Reflection.MethodInfo GetMethod (string name, int genericParameterCount, System.Reflection.BindingFlags bindingAttr, System.Reflection.Binder binder, System.Reflection.CallingConventions callConvention, Type[] types, System.Reflection.ParameterModifier[] modifiers);

Parameter

name
String

Die Zeichenfolge, die den Namen der abzurufenden öffentlichen Methode enthält.

genericParameterCount
Int32

Die Anzahl der generischen Typparameter der Methode.

bindingAttr
BindingFlags

Eine bitweise Kombination der Enumerationswerte, die angeben, wie die Suche durchgeführt wird.

- oder -

Default, damit null zurückgegeben wird.

binder
Binder

Ein Objekt, das eine Gruppe von Eigenschaften definiert und eine Bindung ermöglicht. Dazu kann die Auswahl einer überladenen Methode, die Umwandlung von Argumenttypen und der Aufruf eines Members durch Reflektion gehören.

- oder -

Ein Nullverweis (Nothing in Visual Basic), wenn DefaultBinder verwendet werden soll.

callConvention
CallingConventions

Das Objekt, das die Regeln für Reihenfolge und Layout der Argumente, die Art der Übergabe des Rückgabewerts, die für Argumente zu verwendenden Register und die Art der Stapelbereinigung angibt.

types
Type[]

Ein Array von Type-Objekten, das die Anzahl, die Reihenfolge und den Typ der Parameter der abzurufenden Methode darstellt.

- oder -

Ein leeres Array von Type-Objekten (bereitgestellt vom EmptyTypes-Feld) zum Abrufen einer Methode, die keine Parameter akzeptiert.

modifiers
ParameterModifier[]

Ein Array von ParameterModifier-Objekten, die die Attribute darstellen, die dem entsprechenden Element im types-Array zugeordnet sind. Darf nur bei Aufrufen über COM-Interop verwendet werden. Es werden außerdem nur Parameter berücksichtigt, die als Verweis übergeben werden. Der Standardbinder verarbeitet diesen Parameter nicht.

Gibt zurück

Ein-Objekt, das die Methode darstellt, die der angegebenen Anzahl von generischen Parametern und den angegebenen Argumenttypen, -modifizierern, Bindungseinschränkungen und Aufrufkonventionen entspricht, sofern gefunden. Andernfalls null.

Ausnahmen

name ist null.

- oder -

types ist null.

- oder -

Ein Element im types-Array ist null.

genericParameterCount ist ein negativer Wert.

Gilt für:

.NET 9 und andere Versionen
Produkt Versionen
.NET Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Standard 2.1

GetMethod(String, BindingFlags, Binder, CallingConventions, Type[], ParameterModifier[])

Quelle:
Type.cs
Quelle:
Type.cs
Quelle:
Type.cs

Sucht nach der angegebenen Methode, deren Parameter den angegebenen Argumenttypen und -modifizierern entsprechen, und verwendet dabei die angegebenen Bindungseinschränkungen und die angegebene Aufrufkonvention.

C#
public System.Reflection.MethodInfo? GetMethod (string name, System.Reflection.BindingFlags bindingAttr, System.Reflection.Binder? binder, System.Reflection.CallingConventions callConvention, Type[] types, System.Reflection.ParameterModifier[]? modifiers);
C#
public System.Reflection.MethodInfo GetMethod (string name, System.Reflection.BindingFlags bindingAttr, System.Reflection.Binder binder, System.Reflection.CallingConventions callConvention, Type[] types, System.Reflection.ParameterModifier[] modifiers);

Parameter

name
String

Die Zeichenfolge, die den Namen der abzurufenden Methode enthält.

bindingAttr
BindingFlags

Eine bitweise Kombination der Enumerationswerte, die angeben, wie die Suche durchgeführt wird.

- oder -

Default, damit null zurückgegeben wird.

binder
Binder

Ein Objekt, das eine Gruppe von Eigenschaften definiert und eine Bindung ermöglicht. Dazu kann die Auswahl einer überladenen Methode, die Umwandlung von Argumenttypen und der Aufruf eines Members durch Reflektion gehören.

- oder -

Ein Nullverweis (Nothing in Visual Basic), wenn DefaultBinder verwendet werden soll.

callConvention
CallingConventions

Das Objekt, das die Regeln für Reihenfolge und Layout der Argumente, die Art der Übergabe des Rückgabewerts, die für Argumente zu verwendenden Register und die Art der Stapelbereinigung angibt.

types
Type[]

Ein Array von Type-Objekten, das die Anzahl, die Reihenfolge und den Typ der Parameter der abzurufenden Methode darstellt.

- oder -

Ein leeres Array von Type-Objekten (bereitgestellt vom EmptyTypes-Feld) zum Abrufen einer Methode, die keine Parameter akzeptiert.

modifiers
ParameterModifier[]

Ein Array von ParameterModifier-Objekten, die die Attribute darstellen, die dem entsprechenden Element im types-Array zugeordnet sind. Darf nur bei Aufrufen über COM-Interop verwendet werden. Es werden außerdem nur Parameter berücksichtigt, die als Verweis übergeben werden. Der Standardbinder verarbeitet diesen Parameter nicht.

Gibt zurück

Ein Objekt, das die Methode darstellt, die den angegebenen Anforderungen entspricht, sofern diese gefunden wird. Andernfalls null.

Implementiert

Ausnahmen

Es wurden mehrere Methoden gefunden, die den angegebenen Namen aufweisen und den angegebenen Bindungseinschränkungen entsprechen.

name ist null.

- oder -

types ist null.

- oder -

Eines der Elemente in types ist null.

types ist mehrdimensional.

- oder -

modifiers ist mehrdimensional.

Beispiele

Im folgenden Beispiel werden bestimmte Überladungen von ermittelt, die MethodABindungseinschränkungen angeben, Konventionen aufrufen und eine Vielzahl von Argumenttypen angeben.

Hinweis

Für das Visual C# 2005-Beispiel ist die /unsafe Compileroption erforderlich.

C#

using System;
using System.Reflection;

class Program3
{
    // Methods to get:

    public void MethodA(int i, int j) { }

    public void MethodA(int[] i) { }

    public unsafe void MethodA(int* i) { }

    public void MethodA(ref int r) {}

    // Method that takes an out parameter:
    public void MethodA(int i, out int o) { o = 100;}

  static void Main(string[] args)
  {
    MethodInfo mInfo;

    // Get MethodA(int i, int j)
    mInfo = typeof(Program).GetMethod("MethodA",
        BindingFlags.Public | BindingFlags.Instance,
        null,
        CallingConventions.Any,
        new Type[] { typeof(int), typeof(int) },
        null);
    Console.WriteLine("Found method: {0}", mInfo);

    // Get MethodA(int[] i)
    mInfo = typeof(Program).GetMethod("MethodA",
        BindingFlags.Public | BindingFlags.Instance,
        null,
        CallingConventions.Any,
        new Type[] { typeof(int[]) },
        null);
    Console.WriteLine("Found method: {0}", mInfo);

    // Get MethodA(int* i)
    mInfo = typeof(Program).GetMethod("MethodA",
        BindingFlags.Public | BindingFlags.Instance,
        null,
        CallingConventions.Any,
        new Type[] { typeof(int).MakePointerType() },
        null);
    Console.WriteLine("Found method: {0}", mInfo);

    // Get MethodA(ref int r)
    mInfo = typeof(Program).GetMethod("MethodA",
        BindingFlags.Public | BindingFlags.Instance,
        null,
        CallingConventions.Any,
        new Type[] { typeof(int).MakeByRefType() },
        null);
    Console.WriteLine("Found method: {0}", mInfo);

    // Get MethodA(int i, out int o)
    mInfo = typeof(Program).GetMethod("MethodA",
        BindingFlags.Public | BindingFlags.Instance,
        null,
        CallingConventions.Any,
        new Type[] { typeof(int), typeof(int).MakeByRefType() },
        null);
    Console.WriteLine("Found method: {0}", mInfo);
  }
}

Hinweise

Obwohl der Standardbinder (den modifiers -Parameter) nicht verarbeitet ParameterModifier , können Sie die abstrakte System.Reflection.Binder Klasse verwenden, um einen benutzerdefinierten Binder zu schreiben, der verarbeitetmodifiers. ParameterModifier wird nur beim Aufrufen über COM-Interop verwendet, und nur Parameter, die als Verweis übergeben werden, werden behandelt.

Die folgende Tabelle zeigt, welche Member einer Basisklasse von den GetXXX Methoden zurückgegeben werden, wenn sie einen Typ reflektieren.

Memberart statischen Nicht statisch
Konstruktor Nein Nein
Feld Nein Ja. Ein Feld wird immer nach Name und Signatur ausgeblendet.
Ereignis Nicht zutreffend Die allgemeine Typsystemregel ist, dass die Vererbung mit der der Methoden identisch ist, die die -Eigenschaft implementieren. Reflektion behandelt Eigenschaften als Hide-by-Name-and-Signature. Siehe Hinweis 2 unten.
Methode Nein Ja. Eine Methode (sowohl virtuell als auch nicht virtuell) kann hide-by-name oder hide-by-name-and-signature sein.
Geschachtelter Typ Nein Nein
Eigenschaft Nicht zutreffend Die allgemeine Typsystemregel ist, dass die Vererbung mit der der Methoden identisch ist, die die -Eigenschaft implementieren. Reflektion behandelt Eigenschaften als hide-by-name-and-signature. Siehe Hinweis 2 weiter unten.
  1. Hide-by-name-and-signature berücksichtigt alle Teile der Signatur, einschließlich benutzerdefinierter Modifizierer, Rückgabetypen, Parametertypen, Sentinels und nicht verwalteter Aufrufkonventionen. Dies ist ein binärer Vergleich.

  2. Für die Reflektion werden Eigenschaften und Ereignisse nach Name und Signatur ausgeblendet. Wenn Sie über eine Eigenschaft mit einem get- und einem set-Accessor in der Basisklasse verfügen, die abgeleitete Klasse jedoch nur über einen get-Accessor verfügt, blendet die abgeleitete Klasseneigenschaft die Basisklasseneigenschaft aus, und Sie können nicht auf den Setter für die Basisklasse zugreifen.

  3. Benutzerdefinierte Attribute sind nicht Teil des allgemeinen Typsystems.

Die folgenden BindingFlags Filterflags können verwendet werden, um zu definieren, welche Methoden in die Suche einbezogen werden sollen:

  • Sie müssen entweder BindingFlags.Instance oder BindingFlags.Static angeben, um eine Rückgabe zu erhalten.

  • Geben Sie an BindingFlags.Public , um öffentliche Methoden in die Suche einzuschließen.

  • Geben Sie an BindingFlags.NonPublic , um nicht öffentliche Methoden (d. h. private, interne und geschützte Methoden) in die Suche einzuschließen.

  • Geben Sie anBindingFlags.FlattenHierarchy, um und protected statische Member nach oben in der Hierarchie einzuschließenpublic. private Statische Member in geerbten Klassen sind nicht enthalten.

Die folgenden BindingFlags Modifiziererflags können verwendet werden, um die Funktionsweise der Suche zu ändern:

  • BindingFlags.IgnoreCase , um den Fall von namezu ignorieren.

  • BindingFlags.DeclaredOnly , um nur die Methoden zu durchsuchen, die Typefür deklariert sind, und nicht methoden, die einfach geerbt wurden.

Weitere Informationen finden Sie unter System.Reflection.BindingFlags.

Hinweis

Sie können beim Suchen nach Konstruktoren und Methoden keine Parameter weglassen. Parameter können beim Aufrufen nur weggelassen werden.

Wenn der aktuelle einen konstruierten generischen Type Typ darstellt, gibt diese Methode den MethodInfo mit den Typparametern zurück, die durch die entsprechenden Typargumente ersetzt werden.

Wenn der aktuelle einen Typparameter in der Definition eines generischen Typs oder einer generischen Type Methode darstellt, durchsucht diese Methode die Methoden der Klasseneinschränkung oder die Methoden von Object , wenn keine Klasseneinschränkung vorhanden ist.

Hinweis

Schließen Sie bei generischen Methoden die Typargumente nicht in ein name. Der C#-Code GetMember("MyMethod<int>") sucht beispielsweise nach einem Member mit dem Textnamen "MyMethod<int>" und nicht nach einer Methode namens MyMethod , die ein generisches Argument vom Typ intaufweist.

Weitere Informationen

Gilt für:

.NET 9 und andere Versionen
Produkt Versionen
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

GetMethod(String, Int32, BindingFlags, Binder, Type[], ParameterModifier[])

Quelle:
Type.cs
Quelle:
Type.cs
Quelle:
Type.cs

Sucht unter Verwendung der angegebenen Bindungseinschränkungen nach der angegebenen Methode, deren Parameter der angegebenen Anzahl generischer Parameter und den angegebenen Argumenttypen und -modifizierern entsprechen.

C#
public System.Reflection.MethodInfo? GetMethod (string name, int genericParameterCount, System.Reflection.BindingFlags bindingAttr, System.Reflection.Binder? binder, Type[] types, System.Reflection.ParameterModifier[]? modifiers);
C#
public System.Reflection.MethodInfo GetMethod (string name, int genericParameterCount, System.Reflection.BindingFlags bindingAttr, System.Reflection.Binder binder, Type[] types, System.Reflection.ParameterModifier[] modifiers);

Parameter

name
String

Die Zeichenfolge, die den Namen der abzurufenden öffentlichen Methode enthält.

genericParameterCount
Int32

Die Anzahl der generischen Typparameter der Methode.

bindingAttr
BindingFlags

Eine bitweise Kombination der Enumerationswerte, die angeben, wie die Suche durchgeführt wird.

- oder -

Default, damit null zurückgegeben wird.

binder
Binder

Ein Objekt, das eine Gruppe von Eigenschaften definiert und eine Bindung ermöglicht. Dazu kann die Auswahl einer überladenen Methode, die Umwandlung von Argumenttypen und der Aufruf eines Members durch Reflektion gehören.

- oder -

Ein Nullverweis (Nothing in Visual Basic), wenn DefaultBinderverwendet werden soll.

types
Type[]

Ein Array von Type -Objekten, das die Anzahl, die Reihenfolge und den Typ der Parameter der abzurufenden Methode darstellt.

- oder -

Ein leeres Array von Type-Objekten (bereitgestellt vom EmptyTypes-Feld) zum Abrufen einer Methode, die keine Parameter akzeptiert.

modifiers
ParameterModifier[]

Ein Array von ParameterModifier-Objekten, die die Attribute darstellen, die dem entsprechenden Element im types-Array zugeordnet sind. Darf nur bei Aufrufen über COM-Interop verwendet werden. Es werden außerdem nur Parameter berücksichtigt, die als Verweis übergeben werden. Der Standardbinder verarbeitet diesen Parameter nicht.

Gibt zurück

Ein-Objekt, das die Methode darstellt, die der angegebenen Anzahl von generischen Parametern und den angegebenen Argumenttypen, -modifizierern und Bindungseinschränkungen entspricht, sofern gefunden. Andernfalls null.

Ausnahmen

name ist null.

- oder -

types ist null.

- oder -

Ein Element im types-Array ist null.

genericParameterCount ist ein negativer Wert.

Gilt für:

.NET 9 und andere Versionen
Produkt Versionen
.NET Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Standard 2.1

GetMethod(String, BindingFlags, Binder, Type[], ParameterModifier[])

Quelle:
Type.cs
Quelle:
Type.cs
Quelle:
Type.cs

Sucht unter Verwendung der angegebenen Bindungseinschränkungen nach der angegebenen Methode, deren Parameter den angegebenen Argumenttypen und -modifizierern entsprechen.

C#
public System.Reflection.MethodInfo? GetMethod (string name, System.Reflection.BindingFlags bindingAttr, System.Reflection.Binder? binder, Type[] types, System.Reflection.ParameterModifier[]? modifiers);
C#
public System.Reflection.MethodInfo GetMethod (string name, System.Reflection.BindingFlags bindingAttr, System.Reflection.Binder binder, Type[] types, System.Reflection.ParameterModifier[] modifiers);

Parameter

name
String

Die Zeichenfolge, die den Namen der abzurufenden Methode enthält.

bindingAttr
BindingFlags

Eine bitweise Kombination der Enumerationswerte, die angeben, wie die Suche durchgeführt wird.

- oder -

Default, damit null zurückgegeben wird.

binder
Binder

Ein Objekt, das eine Gruppe von Eigenschaften definiert und eine Bindung ermöglicht. Dazu kann die Auswahl einer überladenen Methode, die Umwandlung von Argumenttypen und der Aufruf eines Members durch Reflektion gehören.

- oder -

Ein Nullverweis (Nothing in Visual Basic), wenn DefaultBinderverwendet werden soll.

types
Type[]

Ein Array von Type -Objekten, das die Anzahl, die Reihenfolge und den Typ der Parameter der abzurufenden Methode darstellt.

- oder -

Ein leeres Array von Type-Objekten (bereitgestellt vom EmptyTypes-Feld) zum Abrufen einer Methode, die keine Parameter akzeptiert.

modifiers
ParameterModifier[]

Ein Array von ParameterModifier-Objekten, die die Attribute darstellen, die dem entsprechenden Element im types-Array zugeordnet sind. Darf nur bei Aufrufen über COM-Interop verwendet werden. Es werden außerdem nur Parameter berücksichtigt, die als Verweis übergeben werden. Der Standardbinder verarbeitet diesen Parameter nicht.

Gibt zurück

Ein Objekt, das die Methode darstellt, die den angegebenen Anforderungen entspricht, sofern diese gefunden wird. Andernfalls null.

Implementiert

Ausnahmen

Es wurden mehrere Methoden gefunden, die den angegebenen Namen aufweisen und den angegebenen Bindungseinschränkungen entsprechen.

name ist null.

- oder -

types ist null.

- oder -

Eines der Elemente in types ist null.

types ist mehrdimensional.

- oder -

modifiers ist mehrdimensional.

Beispiele

Im folgenden Beispiel werden bestimmte Überladungen von MethodAermittelt, die Bindungseinschränkungen und eine Vielzahl von Argumenttypen angeben.

Hinweis

Für das Visual C# 2005-Beispiel ist die /unsafe Compileroption erforderlich.

C#

using System;
using System.Reflection;

class Program5
{
    // Methods to get:

    public void MethodA(int i, int j) { }

    public void MethodA(int[] i) { }

    public unsafe void MethodA(int* i) { }

    public void MethodA(ref int r) {}

    // Method that takes an out parameter.
    public void MethodA(int i, out int o) { o = 100; }

  static void Main(string[] args)
  {
    MethodInfo mInfo;

    // Get MethodA(int i, int j)
    mInfo = typeof(Program).GetMethod("MethodA",
        BindingFlags.Public | BindingFlags.Instance,
        null,
        new Type[] { typeof(int), typeof(int) },
        null);
    Console.WriteLine("Found method: {0}", mInfo);

    // Get MethodA(int[] i)
    mInfo = typeof(Program).GetMethod("MethodA",
        BindingFlags.Public | BindingFlags.Instance,
        null,
        new Type[] { typeof(int[]) },
        null);
    Console.WriteLine("Found method: {0}", mInfo);

    // Get MethodA(int* i)
    mInfo = typeof(Program).GetMethod("MethodA",
        BindingFlags.Public | BindingFlags.Instance,
        null,
        new Type[] { typeof(int).MakePointerType() },
        null);
    Console.WriteLine("Found method: {0}", mInfo);

    // Get MethodA(ref int r)
    mInfo = typeof(Program).GetMethod("MethodA",
        BindingFlags.Public | BindingFlags.Instance,
        null,
        new Type[] { typeof(int).MakeByRefType() },
        null);
    Console.WriteLine("Found method: {0}", mInfo);

    // Get MethodA(int i, out int o)
    mInfo = typeof(Program).GetMethod("MethodA",
        BindingFlags.Public | BindingFlags.Instance,
        null,
        new Type[] { typeof(int), typeof(int).MakeByRefType() },
        null);
    Console.WriteLine("Found method: {0}", mInfo);
  }
}

Hinweise

Obwohl der Standardbinder nicht verarbeitet ParameterModifier wird (der modifiers -Parameter), können Sie die abstrakte System.Reflection.Binder Klasse verwenden, um einen benutzerdefinierten Binder zu schreiben, der verarbeitet modifiers. ParameterModifier wird nur beim Aufrufen über COM-Interop verwendet, und nur Parameter, die als Verweis übergeben werden, werden behandelt.

Die folgenden BindingFlags Filterflags können verwendet werden, um zu definieren, welche Methoden in die Suche einbezogen werden sollen:

  • Sie müssen entweder BindingFlags.Instance oder BindingFlags.Static angeben, um eine Rückgabe zu erhalten.

  • Geben Sie an BindingFlags.Public , um öffentliche Methoden in die Suche einzuschließen.

  • Geben Sie an BindingFlags.NonPublic , um nicht öffentliche Methoden (d. h. private, interne und geschützte Methoden) in die Suche einzuschließen.

  • Geben Sie anBindingFlags.FlattenHierarchy, um und protected statische Member nach oben in der Hierarchie einzuschließenpublic. private Statische Member in geerbten Klassen sind nicht enthalten.

Die folgenden BindingFlags Modifiziererflags können verwendet werden, um die Funktionsweise der Suche zu ändern:

  • BindingFlags.IgnoreCase , um den Fall von namezu ignorieren.

  • BindingFlags.DeclaredOnly , um nur die Methoden zu durchsuchen, die Typefür deklariert sind, und nicht methoden, die einfach geerbt wurden.

Weitere Informationen finden Sie unter System.Reflection.BindingFlags.

Hinweis

Sie können beim Suchen nach Konstruktoren und Methoden keine Parameter weglassen. Parameter können beim Aufrufen nur weggelassen werden.

Wenn der aktuelle einen konstruierten generischen Type Typ darstellt, gibt diese Methode den MethodInfo mit den Typparametern zurück, die durch die entsprechenden Typargumente ersetzt werden.

Wenn der aktuelle einen Typparameter in der Definition eines generischen Typs oder einer generischen Type Methode darstellt, durchsucht diese Methode die Methoden der Klasseneinschränkung oder die Methoden von Object , wenn keine Klasseneinschränkung vorhanden ist.

Hinweis

Schließen Sie bei generischen Methoden die Typargumente nicht in ein name. Der C#-Code GetMember("MyMethod<int>") sucht beispielsweise nach einem Member mit dem Textnamen "MyMethod<int>" und nicht nach einer Methode namens MyMethod , die ein generisches Argument vom Typ intaufweist.

Weitere Informationen

Gilt für:

.NET 9 und andere Versionen
Produkt Versionen
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

GetMethod(String, Int32, Type[], ParameterModifier[])

Quelle:
Type.cs
Quelle:
Type.cs
Quelle:
Type.cs

Sucht die angegebene öffentliche Methode, deren Parameter der angegebenen Anzahl generischer Parameter und den angegebenen Argumenttypen und -modifizierern entsprechen.

C#
public System.Reflection.MethodInfo? GetMethod (string name, int genericParameterCount, Type[] types, System.Reflection.ParameterModifier[]? modifiers);
C#
public System.Reflection.MethodInfo GetMethod (string name, int genericParameterCount, Type[] types, System.Reflection.ParameterModifier[] modifiers);

Parameter

name
String

Die Zeichenfolge, die den Namen der abzurufenden öffentlichen Methode enthält.

genericParameterCount
Int32

Die Anzahl der generischen Typparameter der Methode.

types
Type[]

Ein Array von Type-Objekten, das die Anzahl, die Reihenfolge und den Typ der Parameter der abzurufenden Methode darstellt.

- oder -

Ein leeres Array von Type-Objekten (bereitgestellt vom EmptyTypes-Feld) zum Abrufen einer Methode, die keine Parameter akzeptiert.

modifiers
ParameterModifier[]

Ein Array von ParameterModifier-Objekten, die die Attribute darstellen, die dem entsprechenden Element im types-Array zugeordnet sind. Darf nur bei Aufrufen über COM-Interop verwendet werden. Es werden außerdem nur Parameter berücksichtigt, die als Verweis übergeben werden. Der Standardbinder verarbeitet diesen Parameter nicht.

Gibt zurück

Ein Objekt, das die öffentliche Methode darstellt, die der angegebenen Anzahl generischer Parameter und den angegebenen Argumenttypen und -modifizierern entsprechen, sofern gefunden, andernfalls null.

Ausnahmen

name ist null.

- oder -

types ist null.

- oder -

Ein Element im types-Array ist null.

genericParameterCount ist ein negativer Wert.

Gilt für:

.NET 9 und andere Versionen
Produkt Versionen
.NET Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Standard 2.1

GetMethod(String, Int32, BindingFlags, Type[])

Quelle:
Type.cs
C#
public System.Reflection.MethodInfo? GetMethod (string name, int genericParameterCount, System.Reflection.BindingFlags bindingAttr, Type[] types);

Parameter

name
String
genericParameterCount
Int32
bindingAttr
BindingFlags
types
Type[]

Gibt zurück

Gilt für:

.NET 9
Produkt Versionen
.NET 9

GetMethod(String, BindingFlags)

Quelle:
Type.cs
Quelle:
Type.cs
Quelle:
Type.cs

Sucht die angegebene Methode unter Verwendung der angegebenen Bindungseinschränkungen.

C#
public System.Reflection.MethodInfo? GetMethod (string name, System.Reflection.BindingFlags bindingAttr);
C#
public System.Reflection.MethodInfo GetMethod (string name, System.Reflection.BindingFlags bindingAttr);

Parameter

name
String

Die Zeichenfolge, die den Namen der abzurufenden Methode enthält.

bindingAttr
BindingFlags

Eine bitweise Kombination der Enumerationswerte, die angeben, wie die Suche durchgeführt wird.

- oder -

Default, damit null zurückgegeben wird.

Gibt zurück

Ein Objekt, das die Methode darstellt, die den angegebenen Anforderungen entspricht, sofern diese gefunden wird. Andernfalls null.

Implementiert

Ausnahmen

Es wurden mehrere Methoden gefunden, die den angegebenen Namen aufweisen und den angegebenen Bindungseinschränkungen entsprechen.

name ist null.

Beispiele

Im folgenden Beispiel wird die Methode abgerufen, die mit den angegebenen Bindungsflags übereinstimmt.

C#
using System;
using System.Reflection;

class Program2
{
    // Method to get:
    public void MethodA() { }

    static void Main(string[] args)
    {
        // Get MethodA()
        MethodInfo mInfo = typeof(Program).GetMethod("MethodA",
            BindingFlags.Public | BindingFlags.Instance);
        Console.WriteLine("Found method: {0}", mInfo);
    }
}

Hinweise

Die folgenden BindingFlags Filterflags können verwendet werden, um zu definieren, welche Methoden in die Suche einbezogen werden sollen:

Die folgenden BindingFlags Modifiziererflags können verwendet werden, um die Funktionsweise der Suche zu ändern:

Weitere Informationen finden Sie unter System.Reflection.BindingFlags.

Wenn eine Methode überladen ist und mehrere Überladungen die durch das bindingAttr Argument angegebenen Einschränkungen erfüllen, löst die Methode eine Ausnahme aus AmbiguousMatchException . Im folgenden Beispiel wird eine Ausnahme ausgelöst, weil:

  • Der TestClass Typ verfügt über zwei öffentliche instance-Überladungen der DisplayValue -Methode und DisplayValue(String)DisplayValue(String, Object[]).

  • Der TestClass Typ verfügt über zwei öffentliche instance-Überladungen der Equals -Methode, von denen eine von Objectgeerbt wird: Equals(TestClass) und Equals(Object).

C#
using System;
using System.Reflection;

public class TestClass
{
    public void DisplayValue(String s)
    {
        Console.WriteLine(s);
    }

    public void DisplayValue(String s, params Object[] values)
    {
        Console.WriteLine(s, values);
    }

    public static bool Equals(TestClass t1, TestClass t2)
    {
        return Object.ReferenceEquals(t1, t2);
    }

    public bool Equals(TestClass t)
    {
        return Object.ReferenceEquals(this, t);
    }
}

public class Example1
{
    public static void Main()
    {
        Type t = typeof(TestClass);

        RetrieveMethod(t, "DisplayValue", BindingFlags.Public | BindingFlags.Instance);

        RetrieveMethod(t, "Equals", BindingFlags.Public | BindingFlags.Instance);

        RetrieveMethod(t, "Equals", BindingFlags.Public | BindingFlags.Instance | BindingFlags.DeclaredOnly);

        RetrieveMethod(t, "Equals", BindingFlags.Public | BindingFlags.Static);
    }

    private static void RetrieveMethod(Type t, String name, BindingFlags flags)
    {
        try
        {
            MethodInfo m = t.GetMethod(name, flags);
            if (m != null)
            {
                Console.Write("{0}.{1}(", t.Name, m.Name);
                ParameterInfo[] parms = m.GetParameters();
                for (int ctr = 0; ctr < parms.Length; ctr++)
                {
                    Console.Write(parms[ctr].ParameterType.Name);
                    if (ctr < parms.Length - 1)
                        Console.Write(", ");
                }
                Console.WriteLine(")");
            }
            else
            {
                Console.WriteLine("Method not found");
            }
        }
        catch (AmbiguousMatchException)
        {
            Console.WriteLine("The following duplicate matches were found:");
            MethodInfo[] methods = t.GetMethods(flags);
            foreach (var method in methods)
            {
                if (method.Name != name) continue;

                Console.Write("   {0}.{1}(", t.Name, method.Name);
                ParameterInfo[] parms = method.GetParameters();
                for (int ctr = 0; ctr < parms.Length; ctr++)
                {
                    Console.Write(parms[ctr].ParameterType.Name);
                    if (ctr < parms.Length - 1)
                        Console.Write(", ");
                }
                Console.WriteLine(")");
            }
        }
        Console.WriteLine();
    }
}
// The example displays the following output:
//       The following duplicate matches were found:
//          TestClass.DisplayValue(String)
//          TestClass.DisplayValue(String, Object[])
//       
//       The following duplicate matches were found:
//          TestClass.Equals(TestClass)
//          TestClass.Equals(Object)
//       
//       TestClass.Equals(TestClass)
//       
//       TestClass.Equals(TestClass, TestClass)

Sie können eine der folgenden Aktionen ausführen, um eine bestimmte Methode abzurufen:

  • Ändern Sie die Bindungseinschränkungen. Im vorherigen Beispiel wird beim Versuch, eine öffentliche instance Equals Methode abzurufen, die vom Typ deklariert und nicht geerbt wird, erfolgreich abgerufenEquals(TestClass).

  • Rufen Sie eine Überladung der -Methode auf, die GetMethod einen types Parameter enthält, der die Typen der Parameter der Methode definiert.

  • Rufen Sie die GetMethods(BindingFlags) -Methode auf, um ein Array abzurufen, das alle Methoden enthält, die zu einem Typ gehören und über die angegebenen Bindungsattribute verfügen. Anschließend können Sie es durchlaufen, um die doppelten Methoden namens namezu identifizieren. Dieser Ansatz wird im Handler des vorherigen Beispiels für die AmbiguousMatchException Ausnahme veranschaulicht.

Wenn der aktuelle einen konstruierten generischen Type Typ darstellt, gibt diese Methode den MethodInfo mit den Typparametern zurück, die durch die entsprechenden Typargumente ersetzt werden.

Wenn der aktuelle einen Typparameter in der Definition eines generischen Typs oder einer generischen Type Methode darstellt, durchsucht diese Methode die Methoden der Klasseneinschränkung oder die Methoden von Object , wenn keine Klasseneinschränkung vorhanden ist.

Hinweis

Schließen Sie bei generischen Methoden die Typargumente nicht in ein name. Der C#-Code GetMember("MyMethod<int>") sucht beispielsweise nach einem Member mit dem Textnamen "MyMethod<int>" und nicht nach einer Methode namens MyMethod , die ein generisches Argument vom Typ intaufweist.

Weitere Informationen

Gilt für:

.NET 9 und andere Versionen
Produkt Versionen
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

GetMethod(String, BindingFlags, Type[])

Quelle:
Type.cs
Quelle:
Type.cs
Quelle:
Type.cs

Sucht unter Verwendung der angegebenen Bindungseinschränkungen nach der angegebenen Methode, deren Parameter mit den angegebenen Argumenttypen übereinstimmen.

C#
public System.Reflection.MethodInfo? GetMethod (string name, System.Reflection.BindingFlags bindingAttr, Type[] types);

Parameter

name
String

Die Zeichenfolge, die den Namen der abzurufenden Methode enthält.

bindingAttr
BindingFlags

Eine bitweise Kombination der Enumerationswerte, die angeben, wie die Suche durchgeführt wird. Oder: Standardmäßig wird zurückgegeben null.

types
Type[]

Ein Array von Type-Objekten, das die Anzahl, die Reihenfolge und den Typ der Parameter der abzurufenden Methode darstellt. Oder: Ein leeres Array von Type Objekten (wie vom EmptyTypes Feld bereitgestellt), um eine Methode abzurufen, die keine Parameter akzeptiert.

Gibt zurück

Ein Objekt, das die Methode darstellt, die den angegebenen Anforderungen entspricht, sofern diese gefunden wird. Andernfalls null.

Gilt für:

.NET 9 und andere Versionen
Produkt Versionen
.NET 6, 7, 8, 9

GetMethod(String, Int32, Type[])

Quelle:
Type.cs
Quelle:
Type.cs
Quelle:
Type.cs

Sucht die angegebene öffentliche Methode, deren Parameter der angegebenen Anzahl generischer Parameter und den angegebenen Argumenttypen entsprechen.

C#
public System.Reflection.MethodInfo? GetMethod (string name, int genericParameterCount, Type[] types);
C#
public System.Reflection.MethodInfo GetMethod (string name, int genericParameterCount, Type[] types);

Parameter

name
String

Die Zeichenfolge, die den Namen der abzurufenden öffentlichen Methode enthält.

genericParameterCount
Int32

Die Anzahl der generischen Typparameter der Methode.

types
Type[]

Ein Array von Type-Objekten, das die Anzahl, die Reihenfolge und den Typ der Parameter der abzurufenden Methode darstellt.

- oder -

Ein leeres Array von Type-Objekten (bereitgestellt vom EmptyTypes-Feld) zum Abrufen einer Methode, die keine Parameter akzeptiert.

Gibt zurück

Ein Objekt, das die öffentliche Methode darstellt, deren Parameter der angegebenen Anzahl generischer Parameter und den angegebenen Argumenttypen entsprechen, sofern gefunden, andernfalls null.

Ausnahmen

name ist null.

- oder -

types ist null.

- oder -

Ein Element im types-Array ist null.

genericParameterCount ist ein negativer Wert.

Gilt für:

.NET 9 und andere Versionen
Produkt Versionen
.NET Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Standard 2.1

GetMethod(String, Type[])

Quelle:
Type.cs
Quelle:
Type.cs
Quelle:
Type.cs

Sucht die angegebene öffentliche Methode, deren Parameter den angegebenen Argumenttypen entsprechen.

C#
public System.Reflection.MethodInfo? GetMethod (string name, Type[] types);
C#
public System.Reflection.MethodInfo GetMethod (string name, Type[] types);

Parameter

name
String

Die Zeichenfolge, die den Namen der abzurufenden öffentlichen Methode enthält.

types
Type[]

Ein Array von Type-Objekten, das die Anzahl, die Reihenfolge und den Typ der Parameter der abzurufenden Methode darstellt.

- oder -

Ein leeres Array von Type-Objekten (bereitgestellt vom EmptyTypes-Feld) zum Abrufen einer Methode, die keine Parameter akzeptiert.

Gibt zurück

Ein Objekt, das die öffentliche Methode darstellt, deren Parameter den angegebenen Argumenttypen entsprechen, sofern gefunden, andernfalls null.

Implementiert

Ausnahmen

Es wurden mehrere Methoden mit dem angegebenen Namen und den angegebenen Parametern gefunden.

name ist null.

- oder -

types ist null.

- oder -

Eines der Elemente in types ist null.

types ist mehrdimensional.

Beispiele

Im folgenden Beispiel werden bestimmte Überladungen von MethodAgefunden, die eine Vielzahl von Argumenttypen angeben.

Hinweis

Für das Visual C# 2005-Beispiel ist die /unsafe Compileroption erforderlich.

C#

using System;
using System.Reflection;

class Program4
{
    // Methods to get:

    public void MethodA(int i, int j) { }

    public void MethodA(int[] i) { }

    public unsafe void MethodA(int* i) { }

    public void MethodA(ref int r) {}

    // Method that takes an out parameter:
    public void MethodA(int i, out int o) { o = 100;}

  static void Main(string[] args)
  {
    MethodInfo mInfo;

    // Get MethodA(int i, int i)
    mInfo = typeof(Program).GetMethod("MethodA",
        new Type[] { typeof(int), typeof(int) });
    Console.WriteLine("Found method: {0}", mInfo);

    // Get MethodA(int[] i)
    mInfo = typeof(Program).GetMethod("MethodA",
        new Type[] { typeof(int[]) });
    Console.WriteLine("Found method: {0}", mInfo);

    // Get MethodA(int* i)
    mInfo = typeof(Program).GetMethod("MethodA",
        new Type[] { typeof(int).MakePointerType() });
    Console.WriteLine("Found method: {0}", mInfo);

    // Get MethodA(ref int r)
    mInfo = typeof(Program).GetMethod("MethodA",
        new Type[] { typeof(int).MakeByRefType() });
    Console.WriteLine("Found method: {0}", mInfo);

    // Get MethodA(int i, out int o)
    mInfo = typeof(Program).GetMethod("MethodA",
        new Type[] { typeof(int), typeof(int).MakeByRefType() });
    Console.WriteLine("Found method: {0}", mInfo);
  }
}

Im folgenden Beispiel werden Objekte abgerufen, die die Add Methoden eines nicht generischen Typs (der ArrayList -Klasse), eines offenen MethodInfo generischen Typs (die List<T> -Klasse) und eines geschlossenen generischen Typs (den List(Of String) Typ) darstellen.

C#
using System;
using System.Collections;
using System.Collections.Generic;
using System.Reflection;

public class Example
{
   public static void Main()
   {
      // Get a Type object that represents a non-generic type.
      GetAddMethod(typeof(ArrayList));

      var list = new List<String>();
      // Get a Type object that represents a constructed generic type.
      Type closed = list.GetType();
      GetAddMethod(closed);
      
      // Get a Type object that represents an open generic type.
      Type open = typeof(List<>);
      GetAddMethod(open);
   }

   private static void GetAddMethod(Type typ)
   {
      MethodInfo method;
      // Determine if this is a generic type.
      if (typ.IsGenericType) {
         // Is it an open generic type?
         if (typ.ContainsGenericParameters)
            method = typ.GetMethod("Add", typ.GetGenericArguments());
         // Get closed generic type arguments.
         else
            method = typ.GetMethod("Add", typ.GenericTypeArguments);
      }
      // This is not a generic type.
      else {
         method = typ.GetMethod("Add", new Type[] { typeof(Object) } );
      }

      // Test if an Add method was found.
      if (method == null) { 
         Console.WriteLine("No Add method found.");
         return;
      }   
      
      Type t = method.ReflectedType;
      Console.Write("{0}.{1}.{2}(", t.Namespace, t.Name, method.Name);
      ParameterInfo[] parms = method.GetParameters();
      for (int ctr = 0; ctr < parms.Length; ctr++)
         Console.Write("{0}{1}", parms[ctr].ParameterType.Name, 
                       ctr < parms.Length - 1 ? ", " : "");

      Console.WriteLine(")");
   }   
}
// The example displays the following output:
//       System.Collections.ArrayList.Add(Object)
//       System.Collections.Generic.List`1.Add(String)
//       System.Collections.Generic.List`1.Add(T)

Im Beispiel wird eine GetAddMethod Methode definiert, die das entsprechende MethodInfo Objekt abruft. Um das types Argument für einen offenen generischen Typ bereitzustellen, wird die Type.GetGenericArguments -Methode aufgerufen. Um das types Argument für einen geschlossenen generischen Typ bereitzustellen, wird der Wert der Type.GenericTypeArguments -Eigenschaft abgerufen.

Hinweise

Bei der Suche nach name wird die Groß-/Kleinschreibung beachtet. Die Suche umfasst öffentliche statische und öffentliche instance Methoden.

Hinweis

Sie können beim Suchen nach Konstruktoren und Methoden keine Parameter weglassen. Parameter können beim Aufrufen nur weggelassen werden.

Wenn der aktuelle einen konstruierten generischen Type Typ darstellt, gibt diese Methode den MethodInfo mit den Typparametern zurück, die durch die entsprechenden Typargumente ersetzt werden.

Wenn der aktuelle einen Typparameter in der Definition eines generischen Typs oder einer generischen Type Methode darstellt, durchsucht diese Methode die Methoden der Klasseneinschränkung oder die Methoden von Object , wenn keine Klasseneinschränkung vorhanden ist.

Hinweis

Der name Parameter kann keine Typargumente enthalten. Der C#-Code GetMethod("MyGenericMethod<int>") sucht beispielsweise nach einer Methode mit dem Textnamen "MyGenericMethod<int>" und nicht nach einer Methode namens MyGenericMethod , die über ein generisches Argument vom Typ intverfügt. Verwenden Sie GetMethod("MyGenericMethod") stattdessen mit dem entsprechenden Parameter im types Array.

Weitere Informationen

Gilt für:

.NET 9 und andere Versionen
Produkt Versionen
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

GetMethod(String)

Quelle:
Type.cs
Quelle:
Type.cs
Quelle:
Type.cs

Sucht die öffentliche Methode mit dem angegebenen Namen.

C#
public System.Reflection.MethodInfo? GetMethod (string name);
C#
public System.Reflection.MethodInfo GetMethod (string name);

Parameter

name
String

Die Zeichenfolge, die den Namen der abzurufenden öffentlichen Methode enthält.

Gibt zurück

Ein Objekt, das die öffentliche Methode mit dem angegebenen Namen darstellt, sofern gefunden, andernfalls null.

Implementiert

Ausnahmen

Es wurden mehrere Methoden mit dem angegebenen Namen gefunden.

name ist null.

Beispiele

Im folgenden Beispiel wird eine Methode namens MethodAabgerufen.

C#

using System;
using System.Reflection;

class Program
{

    // Method to get:
    public void MethodA() { }

    static void Main(string[] args)
    {

        // Get MethodA()
        MethodInfo mInfo = typeof(Program).GetMethod("MethodA");
        Console.WriteLine("Found method: {0}", mInfo);
    }
}

Hinweise

Bei der Suche nach name wird die Groß-/Kleinschreibung beachtet. Die Suche umfasst öffentliche statische und öffentliche instance Methoden.

Wenn eine Methode überladen ist und über mehrere öffentliche Methoden verfügt, löst die GetMethod(String) Methode eine Ausnahme aus AmbiguousMatchException . Im folgenden Beispiel wird eine Ausnahme ausgelöst, da es mehr als eine öffentliche Überladung der Int32.ToString Methode gibt. Da die Methode andererseits Person.ToString außer Kraft setzt Object.ToString und daher nicht überladen wird, kann die GetMethod(String) Methode das MethodInfo Objekt abrufen.

C#
using System;
using System.Reflection;

public class Person
{
    public String FirstName;
    public String LastName;

    public override String ToString()
    {
        return (FirstName + " " + LastName).Trim();
    }
}

public class Example2
{
    public static void Main()
    {
        Type t = typeof(Person);
        RetrieveMethod(t, "ToString");

        t = typeof(Int32);
        RetrieveMethod(t, "ToString");
    }

    private static void RetrieveMethod(Type t, String name)
    {
        try
        {
            MethodInfo m = t.GetMethod(name);
            if (m != null)
                Console.WriteLine("{0}.{1}: {2} method", m.ReflectedType.Name,
                                  m.Name, m.IsStatic ? "Static" : "Instance");
            else
                Console.WriteLine("{0}.ToString method not found", t.Name);
        }
        catch (AmbiguousMatchException)
        {
            Console.WriteLine("{0}.{1} has multiple public overloads.",
                              t.Name, name);
        }
    }
}
// The example displays the following output:
//       Person.ToString: Instance method
//       Int32.ToString has multiple public overloads.

Sie können eine der folgenden Aktionen ausführen, um eine bestimmte Methode abzurufen:

  • Rufen Sie die -Methode auf GetMethod(String, BindingFlags) , und geben Sie ein bindingAttr Argument an, das die Methode eindeutig identifiziert. Wenn die Ausnahme beispielsweise ausgelöst wird, weil ein Typ eine statische und eine instance Überladung aufweist, können Sie ein bindingAttr Argument von BindingFlags.InstanceOrBindingFlags.Instanceangeben.

  • Rufen Sie eine Überladung der Methode auf, die GetMethod einen types Parameter enthält, der die Typen der Parameter der Methode definiert.

  • Rufen Sie die GetMethods() -Methode auf, um ein Array abzurufen, das alle öffentlichen Methoden enthält, die zu einem Typ gehören. Anschließend können Sie es durchlaufen, um die doppelten Methoden mit dem Namen namezu identifizieren.

Wenn der aktuelle einen konstruierten generischen Type Typ darstellt, gibt diese Methode den MethodInfo zurück, wobei die Typparameter durch die entsprechenden Typargumente ersetzt werden.

Wenn der aktuelle Type einen Typparameter in der Definition eines generischen Typs oder einer generischen Methode darstellt, durchsucht diese Methode die Methoden der Klasseneinschränkung oder die Methoden von Object , wenn keine Klasseneinschränkung vorhanden ist.

Hinweis

Schließen Sie bei generischen Methoden die Typargumente nicht in ein name. Der C#-Code GetMember("MyMethod<int>") sucht beispielsweise nach einem Element mit dem Textnamen "MyMethod<int>" und nicht nach einer Methode namens MyMethod , die ein generisches Argument vom Typ aufweist int.

Weitere Informationen

Gilt für:

.NET 9 und andere Versionen
Produkt Versionen
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

GetMethod(String, Type[], ParameterModifier[])

Quelle:
Type.cs
Quelle:
Type.cs
Quelle:
Type.cs

Sucht die angegebene öffentliche Methode, deren Parameter den angegebenen Argumenttypen und -modifizierern entsprechen.

C#
public System.Reflection.MethodInfo? GetMethod (string name, Type[] types, System.Reflection.ParameterModifier[]? modifiers);
C#
public System.Reflection.MethodInfo GetMethod (string name, Type[] types, System.Reflection.ParameterModifier[] modifiers);

Parameter

name
String

Die Zeichenfolge, die den Namen der abzurufenden öffentlichen Methode enthält.

types
Type[]

Ein Array von Type-Objekten, das die Anzahl, die Reihenfolge und den Typ der Parameter der abzurufenden Methode darstellt.

- oder -

Ein leeres Array von Type-Objekten (bereitgestellt vom EmptyTypes-Feld) zum Abrufen einer Methode, die keine Parameter akzeptiert.

modifiers
ParameterModifier[]

Ein Array von ParameterModifier-Objekten, die die Attribute darstellen, die dem entsprechenden Element im types-Array zugeordnet sind. Darf nur bei Aufrufen über COM-Interop verwendet werden. Es werden außerdem nur Parameter berücksichtigt, die als Verweis übergeben werden. Der Standardbinder verarbeitet diesen Parameter nicht.

Gibt zurück

Ein Objekt, das die öffentliche Methode darstellt, die den angegebenen Anforderungen entspricht, sofern gefunden, andernfalls null.

Implementiert

Ausnahmen

Es wurden mehrere Methoden mit dem angegebenen Namen und den angegebenen Parametern gefunden.

name ist null.

- oder -

types ist null.

- oder -

Eines der Elemente in types ist null.

types ist mehrdimensional.

- oder -

modifiers ist mehrdimensional.

Hinweise

Obwohl der Standardbinder (den modifiers -Parameter) nicht verarbeitet ParameterModifier , können Sie die abstrakte System.Reflection.Binder Klasse verwenden, um einen benutzerdefinierten Binder zu schreiben, der verarbeitetmodifiers. ParameterModifier wird nur beim Aufrufen über COM-Interop verwendet, und nur Parameter, die als Verweis übergeben werden, werden behandelt.

Bei der Suche nach name wird die Groß-/Kleinschreibung beachtet. Die Suche umfasst öffentliche statische und öffentliche instance Methoden.

Hinweis

Sie können Parameter beim Suchen nach Konstruktoren und Methoden nicht weglassen. Sie können Parameter nur beim Aufrufen weglassen.

Wenn der aktuelle einen konstruierten generischen Type Typ darstellt, gibt diese Methode den MethodInfo zurück, wobei die Typparameter durch die entsprechenden Typargumente ersetzt werden.

Wenn der aktuelle Type einen Typparameter in der Definition eines generischen Typs oder einer generischen Methode darstellt, durchsucht diese Methode die Methoden der Klasseneinschränkung oder die Methoden von Object , wenn keine Klasseneinschränkung vorhanden ist.

Hinweis

Schließen Sie bei generischen Methoden die Typargumente nicht in ein name. Der C#-Code GetMethod("MyMethod<int>") sucht beispielsweise nach einem Element mit dem Textnamen "MyMethod<int>" und nicht nach einer Methode namens MyMethod , die ein generisches Argument vom Typ aufweist int. Verwenden Sie GetMethod("MyMethod") stattdessen mit dem entsprechenden Parameter im types Array.

Weitere Informationen

Gilt für:

.NET 9 und andere Versionen
Produkt Versionen
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1