Type.GetMethod Méthode

Définition

Espace de noms:

System

Assembly:

System.Runtime.dll

Obtient une méthode spécifique du Type actuel.

Surcharges

GetMethod(String, Int32, BindingFlags, Binder, CallingConventions, Type[], ParameterModifier[])	Recherche la méthode spécifiée dont les paramètres correspondent au nombre de paramètres génériques, aux types d'arguments et aux modificateurs spécifiés, en utilisant les contraintes de liaison et la convention d'appel indiquées.
GetMethod(String, BindingFlags, Binder, CallingConventions, Type[], ParameterModifier[])	Recherche la méthode spécifiée dont les paramètres correspondent aux types d'arguments et aux modificateurs spécifiés, en utilisant les contraintes de liaison et la convention d'appel indiquées.
GetMethod(String, Int32, BindingFlags, Binder, Type[], ParameterModifier[])	Recherche la méthode spécifiée dont les paramètres correspondent au nombre de paramètres génériques, aux types d'arguments et aux modificateurs spécifiés, à l'aide des contraintes de liaison spécifiées.
GetMethod(String, BindingFlags, Binder, Type[], ParameterModifier[])	Recherche la méthode spécifiée dont les paramètres correspondent aux types d'arguments et modificateurs spécifiés, à l'aide des contraintes de liaison spécifiées.
GetMethod(String, Int32, Type[], ParameterModifier[])	Recherche la méthode publique spécifiée dont les paramètres correspondent au nombre d’arguments génériques, aux modificateurs et aux types d’arguments spécifiés.
GetMethod(String, BindingFlags)	Recherche la méthode spécifiée, à l'aide des contraintes de liaison spécifiées.
GetMethod(String, BindingFlags, Type[])	Recherche la méthode spécifiée dont les paramètres correspondent aux types d’arguments spécifiés, à l’aide des contraintes de liaison spécifiées.
GetMethod(String, Int32, Type[])	Recherche la méthode publique spécifiée dont les paramètres correspondent au nombre d’arguments génériques et aux types d’arguments spécifiés.
GetMethod(String, Type[])	Recherche la méthode publique spécifiée dont les paramètres correspondent aux types d'arguments spécifiés.
GetMethod(String)	Recherche la méthode publique avec le nom spécifié.
GetMethod(String, Type[], ParameterModifier[])	Recherche la méthode publique spécifiée dont les paramètres correspondent aux types d’arguments et modificateurs spécifiés.

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

Source:

Type.cs

Recherche la méthode spécifiée dont les paramètres correspondent au nombre de paramètres génériques, aux types d'arguments et aux modificateurs spécifiés, en utilisant les contraintes de liaison et la convention d'appel indiquées.

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

Paramètres

name

String

Chaîne contenant le nom de la méthode publique à obtenir.

genericParameterCount

Int32

Le nombre de paramètres de type générique de la méthode.

bindingAttr

BindingFlags

Combinaison de bits de valeurs d’énumération qui spécifie la façon dont est effectuée la recherche.

- ou -

Default pour retourner null.

binder

Binder

Objet qui définit un ensemble de propriétés et permet la liaison, ce qui peut impliquer la sélection d'une méthode surchargée, la contrainte de types d'arguments et l'appel d'un membre par la réflexion.

- ou -

Référence null (Nothing en Visual Basic) pour utiliser DefaultBinder.

callConvention

CallingConventions

Objet qui spécifie l'ensemble de règles à utiliser en ce qui concerne l'ordre et la disposition des arguments, la manière dont la valeur de retour est passée, les registres utilisés pour les arguments et la manière dont la pile est nettoyée.

types

Type[]

Tableau d'objets Type représentant le nombre, l'ordre et le type des paramètres de la méthode à obtenir.

- ou -

Tableau vide d'objets Type (tels que le champ EmptyTypes les fournit) pour obtenir une méthode qui ne prend aucun paramètre.

modifiers

ParameterModifier[]

Tableau d'objets ParameterModifier représentant les attributs associés à l'élément correspondant dans le tableau types. À utiliser uniquement au moment d'un appel via COM Interop ; de plus, seuls sont gérés les paramètres passés par référence. Le binder par défaut ne traite pas ce paramètre.

Retours

MethodInfo

Objet représentant la méthode correspondant au nombre de paramètres génériques, types d'arguments, modificateurs, contraintes de liaison et convention d'appel spécifiés, si trouvés ; sinon, null.

Exceptions

ArgumentNullException

name a la valeur null.

-ou-

types a la valeur null.

- ou -

Un des éléments dans le tableau types est null.

ArgumentException

genericParameterCount est un nombre négatif.

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

Source:

Type.cs

Recherche la méthode spécifiée dont les paramètres correspondent aux types d'arguments et aux modificateurs spécifiés, en utilisant les contraintes de liaison et la convention d'appel indiquées.

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

Paramètres

name

String

Chaîne contenant le nom de la méthode à obtenir.

bindingAttr

BindingFlags

Combinaison de bits de valeurs d’énumération qui spécifie la façon dont est effectuée la recherche.

- ou -

Default pour retourner null.

binder

Binder

Objet qui définit un ensemble de propriétés et permet la liaison, ce qui peut impliquer la sélection d'une méthode surchargée, la contrainte de types d'arguments et l'appel d'un membre par la réflexion.

- ou -

Référence null (Nothing en Visual Basic) pour utiliser DefaultBinder.

callConvention

CallingConventions

Objet qui spécifie l'ensemble de règles à utiliser en ce qui concerne l'ordre et la disposition des arguments, la manière dont la valeur de retour est passée, les registres utilisés pour les arguments et la manière dont la pile est nettoyée.

types

Type[]

Tableau d'objets Type représentant le nombre, l'ordre et le type des paramètres de la méthode à obtenir.

- ou -

Tableau vide d'objets Type (tels que le champ EmptyTypes les fournit) pour obtenir une méthode qui ne prend aucun paramètre.

modifiers

ParameterModifier[]

Tableau d'objets ParameterModifier représentant les attributs associés à l'élément correspondant dans le tableau types. À utiliser uniquement au moment d'un appel via COM Interop ; de plus, seuls sont gérés les paramètres passés par référence. Le binder par défaut ne traite pas ce paramètre.

Retours

MethodInfo

Objet qui représente la méthode correspondant aux critères spécifiés, si elle est trouvée ; sinon, null.

Exceptions

AmbiguousMatchException

Au moins deux méthodes portent le nom spécifié et correspondent aux contraintes de liaison spécifiées.

ArgumentNullException

name a la valeur null.

-ou-

types a la valeur null.

- ou -

Un des éléments de types est null.

ArgumentException

types est multidimensionnel.

- ou -

modifiers est multidimensionnel.

Exemples

L’exemple suivant recherche des surcharges spécifiques de , en spécifiant des contraintes de MethodAliaison, des conventions d’appel et divers types d’arguments.

Notes

L’exemple Visual C# 2005 nécessite l’option du /unsafe compilateur.

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);
  }
}

Remarques

Bien que le classeur par défaut ne traite ParameterModifier pas (le modifiers paramètre), vous pouvez utiliser la classe abstraite System.Reflection.Binder pour écrire un classeur personnalisé qui traite modifiers. ParameterModifier est utilisé uniquement lors de l’appel via COM Interop, et seuls les paramètres passés par référence sont gérés.

Le tableau suivant montre quels membres d’une classe de base sont retournés par les méthodes lors de la GetXXX réflexion sur un type.

Type de membre	statique	Non statique
Constructeur	Non	Non
Champ	Non	Oui. Un champ est toujours masqué par nom et signature.
Événement	Non applicable	La règle système de type courante est que l’héritage est identique à celui des méthodes qui implémentent la propriété . Reflection traite les propriétés comme masquage par nom et signature. Voir la note 2 ci-dessous.
Méthode	Non	Oui. Une méthode (virtuelle et non virtuelle) peut être hide-by-name ou hide-by-name-and-signature.
Type imbriqué	Non	Non
Propriété	Non applicable	La règle système de type courante est que l’héritage est identique à celui des méthodes qui implémentent la propriété . Reflection traite les propriétés comme masquage par nom et signature. Voir la note 2 ci-dessous.

1. Masquer par nom et signature prend en compte toutes les parties de la signature, y compris les modificateurs personnalisés, les types de retour, les types de paramètres, les sentinelles et les conventions d’appel non managées. Il s’agit d’une comparaison binaire.

2. Pour la réflexion, les propriétés et les événements sont masqués par nom et signature. Si vous avez une propriété avec un accesseur get et un accesseur set dans la classe de base, mais que la classe dérivée n’a qu’un accesseur get, la propriété de classe dérivée masque la propriété de classe de base et vous ne pourrez pas accéder à l’élément setter sur la classe de base.

3. Les attributs personnalisés ne font pas partie du système de type commun.

Les indicateurs de filtre suivants BindingFlags peuvent être utilisés pour définir les méthodes à inclure dans la recherche :

• Vous devez spécifier ou BindingFlags.InstanceBindingFlags.Static pour obtenir un retour.

• Spécifiez BindingFlags.Public pour inclure des méthodes publiques dans la recherche.

• Spécifiez BindingFlags.NonPublic pour inclure des méthodes non publiques (c’est-à-dire des méthodes privées, internes et protégées) dans la recherche.

• Spécifiez BindingFlags.FlattenHierarchy pour inclure et protected les public membres statiques dans la hiérarchie ; private les membres statiques dans les classes héritées ne sont pas inclus.

Les indicateurs de modification suivants BindingFlags peuvent être utilisés pour modifier le fonctionnement de la recherche :

• BindingFlags.IgnoreCase pour ignorer le cas de name.

• BindingFlags.DeclaredOnly pour rechercher uniquement les méthodes déclarées sur le Type, et non les méthodes qui ont été simplement héritées.

Consultez la rubrique System.Reflection.BindingFlags (éventuellement en anglais) pour plus d'informations.

Notes

Vous ne pouvez pas omettre des paramètres lors de la recherche de constructeurs et de méthodes. Vous ne pouvez omettre des paramètres que lors de l’appel.

Si le actuel Type représente un type générique construit, cette méthode retourne le MethodInfo avec les paramètres de type remplacés par les arguments de type appropriés.

Si le actuel Type représente un paramètre de type dans la définition d’un type générique ou d’une méthode générique, cette méthode recherche les méthodes de la contrainte de classe ou les méthodes de s’il n’existe aucune contrainte de Object classe.

Notes

Pour les méthodes génériques, n’incluez pas les arguments de type dans name. Par exemple, le code GetMember("MyMethod<int>") C# recherche un membre avec le nom de texte «MyMethod<int> », plutôt qu’une méthode nommée MyMethod qui a un argument générique de type int.

Voir aussi

• MethodInfo
• String
• BindingFlags
• Binder
• DefaultBinder
• CallingConventions
• ParameterModifier
• GetMethodImpl(String, BindingFlags, Binder, CallingConventions, Type[], ParameterModifier[])
• GetMethods()

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

Source:

Type.cs

Recherche la méthode spécifiée dont les paramètres correspondent au nombre de paramètres génériques, aux types d'arguments et aux modificateurs spécifiés, à l'aide des contraintes de liaison spécifiées.

C#

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

Paramètres

name

String

Chaîne contenant le nom de la méthode publique à obtenir.

genericParameterCount

Int32

Le nombre de paramètres de type générique de la méthode.

bindingAttr

BindingFlags

Combinaison de bits de valeurs d’énumération qui spécifie la façon dont est effectuée la recherche.

- ou -

Default pour retourner null.

binder

Binder

Objet qui définit un ensemble de propriétés et permet la liaison, ce qui peut impliquer la sélection d'une méthode surchargée, la contrainte de types d'arguments et l'appel d'un membre par la réflexion.

- ou -

Référence null (Nothing en Visual Basic) pour utiliser DefaultBinder.

types

Type[]

Tableau d'objets Type représentant le nombre, l'ordre et le type des paramètres de la méthode à obtenir.

- ou -

Tableau vide d'objets Type (tels que le champ EmptyTypes les fournit) pour obtenir une méthode qui ne prend aucun paramètre.

modifiers

ParameterModifier[]

Tableau d'objets ParameterModifier représentant les attributs associés à l'élément correspondant dans le tableau types. À utiliser uniquement au moment d'un appel via COM Interop ; de plus, seuls sont gérés les paramètres passés par référence. Le binder par défaut ne traite pas ce paramètre.

Retours

MethodInfo

Objet représentant la méthode correspondant au nombre de paramètres génériques spécifiés, aux types d'arguments, aux modificateurs et aux contraintes de liaison, si trouvés ; sinon, null.

Exceptions

ArgumentNullException

name a la valeur null.

-ou-

types a la valeur null.

- ou -

Un des éléments dans le tableau types est null.

ArgumentException

genericParameterCount est un nombre négatif.

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

Source:

Type.cs

Recherche la méthode spécifiée dont les paramètres correspondent aux types d'arguments et modificateurs spécifiés, à l'aide des contraintes de liaison spécifiées.

C#

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

Paramètres

name

String

Chaîne contenant le nom de la méthode à obtenir.

bindingAttr

BindingFlags

Combinaison de bits de valeurs d’énumération qui spécifie la façon dont est effectuée la recherche.

- ou -

Default pour retourner null.

binder

Binder

Objet qui définit un ensemble de propriétés et permet la liaison, ce qui peut impliquer la sélection d'une méthode surchargée, la contrainte de types d'arguments et l'appel d'un membre par la réflexion.

- ou -

Référence null (Nothing en Visual Basic) pour utiliser DefaultBinder.

types

Type[]

Tableau d'objets Type représentant le nombre, l'ordre et le type des paramètres de la méthode à obtenir.

- ou -

Tableau vide d'objets Type (tels que le champ EmptyTypes les fournit) pour obtenir une méthode qui ne prend aucun paramètre.

modifiers

ParameterModifier[]

Tableau d'objets ParameterModifier représentant les attributs associés à l'élément correspondant dans le tableau types. À utiliser uniquement au moment d'un appel via COM Interop ; de plus, seuls sont gérés les paramètres passés par référence. Le binder par défaut ne traite pas ce paramètre.

Retours

MethodInfo

Objet qui représente la méthode correspondant aux critères spécifiés, si elle est trouvée ; sinon, null.

Implémente

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

Exceptions

AmbiguousMatchException

Au moins deux méthodes portent le nom spécifié et correspondent aux contraintes de liaison spécifiées.

ArgumentNullException

name a la valeur null.

-ou-

types a la valeur null.

- ou -

Un des éléments de types est null.

ArgumentException

types est multidimensionnel.

- ou -

modifiers est multidimensionnel.

Exemples

L’exemple suivant recherche des surcharges spécifiques de MethodA, en spécifiant des contraintes de liaison et divers types d’arguments.

Notes

L’exemple Visual C# 2005 nécessite l’option du /unsafe compilateur.

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);
  }
}

Remarques

Bien que le classeur par défaut ne traite ParameterModifier pas (le modifiers paramètre), vous pouvez utiliser la classe abstraite System.Reflection.Binder pour écrire un classeur personnalisé qui traite modifiers. ParameterModifier est utilisé uniquement lors de l’appel via COM Interop, et seuls les paramètres passés par référence sont gérés.

Les indicateurs de filtre suivants BindingFlags peuvent être utilisés pour définir les méthodes à inclure dans la recherche :

• Vous devez spécifier ou BindingFlags.InstanceBindingFlags.Static pour obtenir un retour.

• Spécifiez BindingFlags.Public pour inclure des méthodes publiques dans la recherche.

• Spécifiez BindingFlags.NonPublic pour inclure des méthodes non publiques (c’est-à-dire des méthodes privées, internes et protégées) dans la recherche.

• Spécifiez BindingFlags.FlattenHierarchy pour inclure et protected les public membres statiques dans la hiérarchie ; private les membres statiques dans les classes héritées ne sont pas inclus.

Les indicateurs de modification suivants BindingFlags peuvent être utilisés pour modifier le fonctionnement de la recherche :

• BindingFlags.IgnoreCase pour ignorer le cas de name.

• BindingFlags.DeclaredOnly pour rechercher uniquement les méthodes déclarées sur le Type, et non les méthodes qui ont été simplement héritées.

Consultez la rubrique System.Reflection.BindingFlags (éventuellement en anglais) pour plus d'informations.

Notes

Vous ne pouvez pas omettre des paramètres lors de la recherche de constructeurs et de méthodes. Vous ne pouvez omettre des paramètres que lors de l’appel.

Si le actuel Type représente un type générique construit, cette méthode retourne le MethodInfo avec les paramètres de type remplacés par les arguments de type appropriés.

Si le actuel Type représente un paramètre de type dans la définition d’un type générique ou d’une méthode générique, cette méthode recherche les méthodes de la contrainte de classe ou les méthodes de s’il n’existe aucune contrainte de Object classe.

Notes

Pour les méthodes génériques, n’incluez pas les arguments de type dans name. Par exemple, le code GetMember("MyMethod<int>") C# recherche un membre avec le nom de texte «MyMethod<int> », plutôt qu’une méthode nommée MyMethod qui a un argument générique de type int.

Voir aussi

• MethodInfo
• String
• BindingFlags
• Binder
• DefaultBinder
• ParameterModifier
• GetMethodImpl(String, BindingFlags, Binder, CallingConventions, Type[], ParameterModifier[])
• GetMethods()

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

Source:

Type.cs

Recherche la méthode publique spécifiée dont les paramètres correspondent au nombre d’arguments génériques, aux modificateurs et aux types d’arguments spécifiés.

C#

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

Paramètres

name

String

Chaîne contenant le nom de la méthode publique à obtenir.

genericParameterCount

Int32

Le nombre de paramètres de type générique de la méthode.

types

Type[]

Tableau d'objets Type représentant le nombre, l'ordre et le type des paramètres de la méthode à obtenir.

- ou -

Tableau vide d'objets Type (tels que le champ EmptyTypes les fournit) pour obtenir une méthode qui ne prend aucun paramètre.

modifiers

ParameterModifier[]

Tableau d'objets ParameterModifier représentant les attributs associés à l'élément correspondant dans le tableau types. À utiliser uniquement au moment d'un appel via COM Interop ; de plus, seuls sont gérés les paramètres passés par référence. Le binder par défaut ne traite pas ce paramètre.

Retours

MethodInfo

Objet représentant la méthode publique correspondant au nombre de paramètres génériques, types d'arguments et modificateurs spécifiés, si trouvés ; sinon, null.

Exceptions

ArgumentNullException

name a la valeur null.

-ou-

types a la valeur null.

- ou -

Un des éléments dans le tableau types est null.

ArgumentException

genericParameterCount est un nombre négatif.

GetMethod(String, BindingFlags)

Source:

Type.cs

Recherche la méthode spécifiée, à l'aide des contraintes de liaison spécifiées.

C#

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

Paramètres

name

String

Chaîne contenant le nom de la méthode à obtenir.

bindingAttr

BindingFlags

Combinaison de bits de valeurs d’énumération qui spécifie la façon dont est effectuée la recherche.

- ou -

Default pour retourner null.

Retours

MethodInfo

Objet qui représente la méthode correspondant aux critères spécifiés, si elle est trouvée ; sinon, null.

Implémente

GetMethod(String, BindingFlags)

Exceptions

AmbiguousMatchException

Au moins deux méthodes portent le nom spécifié et correspondent aux contraintes de liaison spécifiées.

ArgumentNullException

name a la valeur null.

Exemples

L’exemple suivant obtient la méthode qui correspond aux indicateurs de liaison spécifiés.

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);
    }
}

Remarques

Les indicateurs de filtre suivants BindingFlags peuvent être utilisés pour définir les méthodes à inclure dans la recherche :

• Vous devez spécifier ou BindingFlags.InstanceBindingFlags.Static pour obtenir un retour.

• Spécifiez BindingFlags.Public pour inclure des méthodes publiques dans la recherche.

• Spécifiez BindingFlags.NonPublic pour inclure des méthodes non publiques (c’est-à-dire des méthodes privées, internes et protégées) dans la recherche.

• Spécifiez BindingFlags.FlattenHierarchy pour inclure et protected les public membres statiques dans la hiérarchie ; private les membres statiques dans les classes héritées ne sont pas inclus.

Les indicateurs de modification suivants BindingFlags peuvent être utilisés pour modifier le fonctionnement de la recherche :

• BindingFlags.IgnoreCase pour ignorer le cas de name.

• BindingFlags.DeclaredOnly pour rechercher uniquement les méthodes déclarées sur , Typeet non les méthodes qui ont été simplement héritées.

Consultez la rubrique System.Reflection.BindingFlags (éventuellement en anglais) pour plus d'informations.

Si une méthode est surchargée et que plusieurs surcharges répondent aux contraintes spécifiées par l’argument bindingAttr , la méthode lève une AmbiguousMatchException exception. Dans l’exemple suivant, une exception est levée parce que :

• Le TestClass type a deux surcharges de instance publiques de la DisplayValue méthode et DisplayValue(String)DisplayValue(String, Object[]).

• Le TestClass type a deux surcharges de instance publiques de la Equals méthode, dont l’une est héritée de Object: Equals(TestClass) et 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)

Vous pouvez effectuer l’une des opérations suivantes pour récupérer une méthode spécifique :

• Modifiez les contraintes de liaison. Dans l’exemple précédent, la tentative de récupération d’une méthode de instance Equals publique déclarée par le type et non héritée récupère Equals(TestClass)avec succès .

• Appelez une surcharge de la GetMethod méthode qui inclut un types paramètre qui définit les types des paramètres de la méthode.

• Appelez la GetMethods(BindingFlags) méthode pour récupérer un tableau contenant toutes les méthodes appartenant à un type qui ont les attributs de liaison spécifiés. Vous pouvez ensuite l’itérer pour identifier les méthodes dupliquées nommées name. Cette approche est illustrée dans le gestionnaire de l’exemple précédent pour l’exception AmbiguousMatchException .

Si le courant Type représente un type générique construit, cette méthode retourne le MethodInfo avec les paramètres de type remplacés par les arguments de type appropriés.

Si le actuel Type représente un paramètre de type dans la définition d’un type générique ou d’une méthode générique, cette méthode recherche les méthodes de la contrainte de classe ou les méthodes de s’il n’existe aucune contrainte de Object classe.

Notes

Pour les méthodes génériques, n’incluez pas les arguments de type dans name. Par exemple, le code GetMember("MyMethod<int>") C# recherche un membre avec le nom de texte «MyMethod<int> », plutôt qu’une méthode nommée MyMethod qui a un argument générique de type int.

Voir aussi

• MethodInfo
• String
• BindingFlags
• DefaultBinder
• GetMethodImpl(String, BindingFlags, Binder, CallingConventions, Type[], ParameterModifier[])
• GetMethods()

GetMethod(String, BindingFlags, Type[])

Source:

Type.cs

Recherche la méthode spécifiée dont les paramètres correspondent aux types d’arguments spécifiés, à l’aide des contraintes de liaison spécifiées.

C#

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

Paramètres

name

String

Chaîne contenant le nom de la méthode à obtenir.

bindingAttr

BindingFlags

Combinaison de bits de valeurs d’énumération qui spécifie la façon dont est effectuée la recherche. -ou- Par défaut pour retourner null.

types

Type[]

Tableau d'objets Type représentant le nombre, l'ordre et le type des paramètres de la méthode à obtenir. -ou- Tableau vide d’objets Type (tel que fourni par le EmptyTypes champ) pour obtenir une méthode qui ne prend aucun paramètre.

Retours

MethodInfo

Objet qui représente la méthode correspondant aux critères spécifiés, si elle est trouvée ; sinon, null.

GetMethod(String, Int32, Type[])

Source:

Type.cs

Recherche la méthode publique spécifiée dont les paramètres correspondent au nombre d’arguments génériques et aux types d’arguments spécifiés.

C#

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

Paramètres

name

String

Chaîne contenant le nom de la méthode publique à obtenir.

genericParameterCount

Int32

Le nombre de paramètres de type générique de la méthode.

types

Type[]

Tableau d'objets Type représentant le nombre, l'ordre et le type des paramètres de la méthode à obtenir.

- ou -

Tableau vide d'objets Type (tels que le champ EmptyTypes les fournit) pour obtenir une méthode qui ne prend aucun paramètre.

Retours

MethodInfo

Objet représentant la méthode publique dont les paramètres correspondent au nombre d’arguments génériques et aux types d'arguments spécifiés, si elle est trouvée ; sinon, null.

Exceptions

ArgumentNullException

name a la valeur null.

-ou-

types a la valeur null.

- ou -

Un des éléments dans le tableau types est null.

ArgumentException

genericParameterCount est un nombre négatif.

GetMethod(String, Type[])

Source:

Type.cs

Recherche la méthode publique spécifiée dont les paramètres correspondent aux types d'arguments spécifiés.

C#

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

Paramètres

name

String

Chaîne contenant le nom de la méthode publique à obtenir.

types

Type[]

Tableau d'objets Type représentant le nombre, l'ordre et le type des paramètres de la méthode à obtenir.

- ou -

Tableau vide d'objets Type (tels que le champ EmptyTypes les fournit) pour obtenir une méthode qui ne prend aucun paramètre.

Retours

MethodInfo

Objet représentant la méthode publique dont les paramètres correspondent aux types d'arguments spécifiés, si elle est trouvée ; sinon, null.

Exceptions

AmbiguousMatchException

Plusieurs méthodes ont été trouvées avec le nom et les paramètres spécifiés.

ArgumentNullException

name a la valeur null.

-ou-

types a la valeur null.

- ou -

Un des éléments de types est null.

ArgumentException

types est multidimensionnel.

Exemples

L’exemple suivant recherche des surcharges spécifiques de MethodA, en spécifiant divers types d’arguments.

Notes

L’exemple Visual C# 2005 nécessite l’option du /unsafe compilateur.

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);
  }
}

L’exemple suivant récupère des MethodInfo objets qui représentent les Add méthodes d’un type non générique (la ArrayList classe), d’un type générique ouvert (la List<T> classe) et d’un type générique fermé (le List(Of String) type).

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)

L’exemple définit une GetAddMethod méthode qui récupère l’objet approprié MethodInfo . Pour fournir l’argument types d’un type générique ouvert, il appelle la Type.GetGenericArguments méthode . Pour fournir l’argument types d’un type générique fermé, il récupère la valeur de la Type.GenericTypeArguments propriété.

Remarques

La recherche respecte name la casse. La recherche inclut des méthodes de instance publiques et statiques publiques.

Notes

Vous ne pouvez pas omettre des paramètres lors de la recherche de constructeurs et de méthodes. Vous pouvez uniquement omettre des paramètres lors de l’appel.

Si le courant Type représente un type générique construit, cette méthode retourne le MethodInfo avec les paramètres de type remplacés par les arguments de type appropriés.

Si le actuel Type représente un paramètre de type dans la définition d’un type générique ou d’une méthode générique, cette méthode recherche les méthodes de la contrainte de classe ou les méthodes de s’il n’existe aucune contrainte de Object classe.

Notes

Le name paramètre ne peut pas inclure d’arguments de type. Par exemple, le code GetMethod("MyGenericMethod<int>") C# recherche une méthode avec le nom de texte «MyGenericMethod<int> », plutôt qu’une méthode nommée MyGenericMethod qui a un argument générique de type int. Utilisez plutôt GetMethod("MyGenericMethod") avec le paramètre approprié dans le types tableau.

Voir aussi

• MethodInfo
• DefaultBinder
• GetMethodImpl(String, BindingFlags, Binder, CallingConventions, Type[], ParameterModifier[])
• GetMethods()

GetMethod(String)

Source:

Type.cs

Recherche la méthode publique avec le nom spécifié.

C#

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

Paramètres

name

String

Chaîne contenant le nom de la méthode publique à obtenir.

Retours

MethodInfo

Objet qui représente la méthode publique avec le nom spécifié, si elle est trouvée ; sinon, null.

Exceptions

AmbiguousMatchException

Plusieurs méthodes ont été trouvées avec le nom spécifié.

ArgumentNullException

name a la valeur null.

Exemples

L’exemple suivant obtient une méthode nommée MethodA.

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);
    }
}

Remarques

La recherche respecte name la casse. La recherche inclut des méthodes de instance publiques et statiques publiques.

Si une méthode est surchargée et comporte plusieurs méthodes publiques, la GetMethod(String) méthode lève une AmbiguousMatchException exception. Dans l’exemple suivant, une exception est levée parce qu’il existe plusieurs surcharges publiques de la Int32.ToString méthode. D’autre part, étant donné que la Person.ToString méthode remplace Object.ToString et n’est donc pas surchargée, la GetMethod(String) méthode peut récupérer l’objet MethodInfo .

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.

Vous pouvez effectuer l’une des opérations suivantes pour récupérer une méthode spécifique :

• Appelez la GetMethod(String, BindingFlags) méthode et spécifiez un bindingAttr argument qui identifie la méthode de manière unique. Par exemple, si l’exception est levée parce qu’un type a une surcharge statique et une surcharge instance, vous pouvez spécifier un bindingAttr argument de BindingFlags.InstanceOrBindingFlags.Instance.

• Appelez une surcharge de la GetMethod méthode qui inclut un types paramètre qui définit les types des paramètres de la méthode.

• Appelez la GetMethods() méthode pour récupérer un tableau contenant toutes les méthodes publiques appartenant à un type. Vous pouvez ensuite l’itérer pour identifier les méthodes dupliquées nommées name.

Si le courant Type représente un type générique construit, cette méthode retourne le MethodInfo avec les paramètres de type remplacés par les arguments de type appropriés.

Si le actuel Type représente un paramètre de type dans la définition d’un type générique ou d’une méthode générique, cette méthode recherche les méthodes de la contrainte de classe ou les méthodes de s’il n’existe aucune contrainte de Object classe.

Notes

Pour les méthodes génériques, n’incluez pas les arguments de type dans name. Par exemple, le code GetMember("MyMethod<int>") C# recherche un membre avec le nom de texte «MyMethod<int> », plutôt qu’une méthode nommée MyMethod qui a un argument générique de type int.

Voir aussi

• MethodInfo
• String
• DefaultBinder
• GetMethodImpl(String, BindingFlags, Binder, CallingConventions, Type[], ParameterModifier[])
• GetMethods()

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

Source:

Type.cs

Recherche la méthode publique spécifiée dont les paramètres correspondent aux types d’arguments et modificateurs spécifiés.

C#

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

Paramètres

name

String

Chaîne contenant le nom de la méthode publique à obtenir.

types

Type[]

Tableau d'objets Type représentant le nombre, l'ordre et le type des paramètres de la méthode à obtenir.

- ou -

Tableau vide d'objets Type (tels que le champ EmptyTypes les fournit) pour obtenir une méthode qui ne prend aucun paramètre.

modifiers

ParameterModifier[]

Tableau d'objets ParameterModifier représentant les attributs associés à l'élément correspondant dans le tableau types. À utiliser uniquement au moment d'un appel via COM Interop ; de plus, seuls sont gérés les paramètres passés par référence. Le binder par défaut ne traite pas ce paramètre.

Retours

MethodInfo

Objet qui représente la méthode publique correspondant aux exigences spécifiées, si elle est trouvée ; sinon, null.

Exceptions

AmbiguousMatchException

Plusieurs méthodes ont été trouvées avec le nom et les paramètres spécifiés.

ArgumentNullException

name a la valeur null.

-ou-

types a la valeur null.

- ou -

Un des éléments de types est null.

ArgumentException

types est multidimensionnel.

- ou -

modifiers est multidimensionnel.

Remarques

Bien que le classeur par défaut ne traite ParameterModifier pas (le modifiers paramètre), vous pouvez utiliser la classe abstraite System.Reflection.Binder pour écrire un classeur personnalisé qui traite modifiers. ParameterModifier est utilisé uniquement lors de l’appel via l’interopérabilité COM, et seuls les paramètres passés par référence sont gérés.

La recherche respecte name la casse. La recherche inclut des méthodes de instance publiques et statiques publiques.

Notes

Vous ne pouvez pas omettre des paramètres lors de la recherche de constructeurs et de méthodes. Vous pouvez uniquement omettre des paramètres lors de l’appel.

Si le courant Type représente un type générique construit, cette méthode retourne le MethodInfo avec les paramètres de type remplacés par les arguments de type appropriés.

Si le actuel Type représente un paramètre de type dans la définition d’un type générique ou d’une méthode générique, cette méthode recherche les méthodes de la contrainte de classe ou les méthodes de s’il n’existe aucune contrainte de Object classe.

Notes

Pour les méthodes génériques, n’incluez pas les arguments de type dans name. Par exemple, le code GetMethod("MyMethod<int>") C# recherche un membre avec le nom de texte «MyMethod<int> », plutôt qu’une méthode nommée MyMethod qui a un argument générique de type int. Utilisez plutôt GetMethod("MyMethod") avec le paramètre approprié dans le types tableau.

Voir aussi

• MethodInfo
• String
• DefaultBinder
• ParameterModifier
• GetMethodImpl(String, BindingFlags, Binder, CallingConventions, Type[], ParameterModifier[])
• GetMethods()