Cet article a fait l'objet d'une traduction manuelle. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. |
Traduction
Source
|
Type.GetMethod, méthode (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.
Assembly : mscorlib (dans mscorlib.dll)
public MethodInfo GetMethod( string name, BindingFlags bindingAttr, Binder binder, Type[] types, ParameterModifier[] modifiers )
Paramètres
- name
- Type : System.String
Chaîne contenant le nom de la méthode à obtenir.
- bindingAttr
- Type : System.Reflection.BindingFlags
Masque de bits constitué d'un ou de plusieurs BindingFlags spécifiant le mode d'exécution de la recherche.
ou
Zéro, pour retourner null.
- binder
- Type : System.Reflection.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 : System.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
- Type : System.Reflection.ParameterModifier[]
Tableau d'objets ParameterModifier représentant les attributs associés à l'élément correspondant dans le tableau types. À utiliser uniquement lors 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.
Valeur de retour
Type : System.Reflection.MethodInfoObjet qui représente la méthode correspondant aux critères spécifiés, si elle est trouvée ; sinon, null.
Implémentations
_Type.GetMethod(String, BindingFlags, Binder, Type[], ParameterModifier[])IReflect.GetMethod(String, BindingFlags, Binder, Type[], ParameterModifier[])
| Exception | Condition |
|---|---|
| AmbiguousMatchException |
Il existe plusieurs méthodes portant le nom spécifié et correspondant aux contraintes de liaison spécifiées. |
| ArgumentNullException |
name est null. ou types est null. ou Un des éléments dans types est null. |
| ArgumentException |
types est multidimensionnel. ou modifiers est multidimensionnel. |
Bien que le binder par défaut ne traite pas ParameterModifier (le paramètre modifiers), vous pouvez utiliser la classe abstraite System.Reflection.Binder pour écrire un binder personnalisé qui traite modifiers. ParameterModifier est utilisé uniquement lors d'un appel via COM Interop ; de plus, seuls sont gérés les paramètres passés par référence.
Les indicateurs de filtre BindingFlags suivants peuvent être utilisés pour définir les méthodes à inclure dans la recherche :
-
Vous devez spécifier soit BindingFlags.Instance, soit BindingFlags.Static pour obtenir un retour.
-
Spécifiez BindingFlags.Public pour inclure les 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 les membres statiques public et protected en haut de la hiérarchie ; les membres statiques private dans les classes héritées ne sont pas inclus.
Les indicateurs de modificateur BindingFlags suivants peuvent être utilisés pour modifier le fonctionnement de la recherche :
-
BindingFlags.IgnoreCase pour ignorer la casse de name.
-
BindingFlags.DeclaredOnly pour limiter la recherche aux méthodes déclarées dans Type et exclure celles qui ont été simplement héritées.
Consultez System.Reflection.BindingFlags pour plus d'informations.
Remarque
|
|---|
|
Vous ne pouvez pas omettre de paramètres lorsque vous cherchez les constructeurs et méthodes. Vous pouvez uniquement omettre les paramètres lors de l'appel. |
Si le T:System.Type actuel représente un type générique construit, cette méthode retourne MethodInfo où les paramètres de type sont remplacés par les arguments de type appropriés.
Si le Type actuel représente un paramètre de type dans la définition d'un type 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 Object, s'il n'existe aucune contrainte de classe.
Remarque
|
|---|
|
Pour les méthodes génériques, n'incluez pas les arguments de type dans name. Par exemple, le code C# GetMember("MyMethod<int>") recherche un membre portant le nom textuel "MyMethod<int>" plutôt qu'une méthode nommée MyMethod qui possède un argument générique de type int. |
L'exemple suivant trouve des surcharges spécifiques de MethodA, en spécifiant des contraintes de liaison et divers types d'arguments.
Remarque
|
|---|
|
L'exemple Visual C# 2005 requiert l'option du compilateur /unsafe. |
using System; using System.Reflection; class Program { // 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); } }
Windows 7, Windows Vista SP1 ou ultérieur, Windows XP SP3, Windows XP SP2 Édition x64, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2
Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.
Remarque