Lire en anglais

Partager via


Type.FindMembers(MemberTypes, BindingFlags, MemberFilter, Object) Méthode

Définition

Retourne un tableau filtré d'objets MemberInfo du type du membre spécifié.

C#
public virtual System.Reflection.MemberInfo[] FindMembers(System.Reflection.MemberTypes memberType, System.Reflection.BindingFlags bindingAttr, System.Reflection.MemberFilter? filter, object? filterCriteria);
C#
public virtual System.Reflection.MemberInfo[] FindMembers(System.Reflection.MemberTypes memberType, System.Reflection.BindingFlags bindingAttr, System.Reflection.MemberFilter filter, object filterCriteria);

Paramètres

memberType
MemberTypes

Combinaison de bits de valeurs d’énumération qui indique le type de membre à rechercher.

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.

filter
MemberFilter

Délégué qui effectue les comparaisons, retournant true si le membre en cours d'inspection correspond à filterCriteria et false dans le cas contraire.

filterCriteria
Object

Critère de recherche qui détermine si un membre est retourné dans le tableau d'objets MemberInfo.

Les champs de FieldAttributes, MethodAttributes et MethodImplAttributes peuvent être utilisés conjointement au délégué FilterAttribute fourni par cette classe.

Retours

Tableau filtré d'objets MemberInfo du type du membre spécifié.

- ou -

Tableau vide si le Type actuel n’a pas de membres de type memberType qui correspondent aux critères de filtre.

Implémente

Exceptions

filter a la valeur null.

Exemples

L’exemple suivant recherche tous les membres d’une classe qui correspondent aux critères de recherche spécifiés, puis affiche les membres correspondants.

C#
using System;
using System.Reflection;

class MyFindMembersClass
{
    public static void Main()
    {
        Object objTest = new Object();
        Type objType = objTest.GetType ();
        MemberInfo[] arrayMemberInfo;
        try
        {
            //Find all static or public methods in the Object class that match the specified name.
            arrayMemberInfo = objType.FindMembers(MemberTypes.Method,
                BindingFlags.Public | BindingFlags.Static| BindingFlags.Instance,
                new MemberFilter(DelegateToSearchCriteria),
                "ReferenceEquals");

            for(int index=0;index < arrayMemberInfo.Length ;index++)
                Console.WriteLine ("Result of FindMembers -\t"+ arrayMemberInfo[index].ToString() +"\n");
        }
        catch (Exception e)
        {
            Console.WriteLine ("Exception : " + e.ToString() );
        }
    }
    public static bool DelegateToSearchCriteria(MemberInfo objMemberInfo, Object objSearch)
    {
        // Compare the name of the member function with the filter criteria.
        if(objMemberInfo.Name.ToString() == objSearch.ToString())
            return true;
        else
            return false;
    }
}
/* The example produces the following output:

Result of FindMembers - Boolean ReferenceEquals(System.Object, System.Object)
*/

Remarques

Cette méthode peut être remplacée par une classe dérivée.

Les membres incluent des propriétés, des méthodes, des champs, des événements, etc.

Pour que la FindMembers méthode récupère correctement les informations de membre, l’argument bindingAttr doit inclure au moins l’un des BindingFlags.Instance et , BindingFlags.Staticainsi qu’au moins l’un des BindingFlags.NonPublic et BindingFlags.Public.

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

  • Spécifiez BindingFlags.Instance pour inclure instance membres dans la recherche.

  • Spécifiez BindingFlags.Static pour inclure des membres statiques dans la recherche.

  • Spécifiez BindingFlags.Public pour inclure des membres publics dans la recherche.

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

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

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

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

Pour obtenir l’initialiseur de classe (constructeur statique) à l’aide de cette méthode, vous devez spécifier BindingFlags.Static | BindingFlags.NonPublic (BindingFlags.StaticOrBindingFlags.NonPublic en Visual Basic). Vous pouvez également obtenir l’initialiseur de classe à l’aide de la TypeInitializer propriété .

Si le current Type représente un paramètre de type d’un type générique ou d’une méthode générique, FindMembers traite tous les membres déclarés par la contrainte de classe et les contraintes d’interface du paramètre de type.

L’argument filter peut être un délégué personnalisé de type MemberFilter, ou il peut s’agir de l’un des délégués prédéfinis suivants :

S’applique à

Produit Versions
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10
.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

Voir aussi