Type.GetFields Méthode

Définition

Espace de noms:

System

Assembly:

System.Runtime.dll

Assembly:

netstandard.dll

Assembly:

mscorlib.dll

Obtient les champs du Type actuel.

Surcharges

GetFields()	Retourne tous les champs publics du Type actuel.
GetFields(BindingFlags)	En cas de substitution dans une classe dérivée, recherche les champs définis pour le Type actuel, à l'aide des contraintes de liaison spécifiées.

GetFields()

Retourne tous les champs publics du Type actuel.

C#

public System.Reflection.FieldInfo[] GetFields ();

Retours

FieldInfo[]

Tableau d'objets FieldInfo représentant tous les champs publics définis pour le Type actuel.

• ou - Tableau vide du type FieldInfo si aucun champ public n'est défini pour le Type actuel.

Implémente

GetFields()

Exemples

L’exemple suivant illustre une utilisation de la GetFields() méthode.

C#

using System;
using System.Reflection;
using System.ComponentModel.Design;

class FieldInfo_IsSpecialName
{
    public static void Main()
    {
        try
        {
            // Get the type handle of a specified class.
            Type myType = typeof(ViewTechnology);

            // Get the fields of the specified class.
            FieldInfo[] myField = myType.GetFields();

            Console.WriteLine("\nDisplaying fields that have SpecialName attributes:\n");
            for(int i = 0; i < myField.Length; i++)
            {
                // Determine whether or not each field is a special name.
                if(myField[i].IsSpecialName)
                {
                    Console.WriteLine("The field {0} has a SpecialName attribute.",
                        myField[i].Name);
                }
            }
        }
        catch(Exception e)
        {
            Console.WriteLine("Exception : {0} " , e.Message);
        }
    }
}

Remarques

La GetFields méthode ne retourne pas de champs dans un ordre particulier, par exemple par ordre alphabétique ou par ordre de déclaration. Votre code ne doit pas dépendre de l’ordre dans lequel les champs sont retournés, car cet ordre varie.

Le tableau suivant indique les membres d’une classe de base qui sont retournés par les Get méthodes lors de la 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 de système de type commun est que l’héritage est le même que celui des méthodes qui implémentent la propriété. La réflexion traite les propriétés comme étant masquées-par-nom-et-signature. Voir la remarque 2 ci-dessous.
Méthode	Non	Oui. Une méthode (à la fois virtuelles et non virtuelles) peut être masquée ou masquée-par-nom-et-signature.
Type imbriqué	Non	Non
Propriété	Non applicable	La règle de système de type commun est que l’héritage est le même que celui des méthodes qui implémentent la propriété. La réflexion traite les propriétés comme étant masquées-par-nom-et-signature. Voir la remarque 2 ci-dessous.

1. Hide-by-Name-and-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 a uniquement un accesseur Get, la propriété de la classe dérivée masque la propriété de la classe de base, et vous ne pouvez pas accéder à la méthode setter sur la classe de base.

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

Si le actuel Type représente un type générique construit, cette méthode retourne les FieldInfo objets 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 champs publics de la contrainte de classe.

Voir aussi

• FieldInfo
• GetField(String, BindingFlags)

GetFields(BindingFlags)

En cas de substitution dans une classe dérivée, recherche les champs définis pour le Type actuel, à l'aide des contraintes de liaison spécifiées.

C#

public abstract System.Reflection.FieldInfo[] GetFields (System.Reflection.BindingFlags bindingAttr);

Paramètres

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 un tableau vide.

Retours

FieldInfo[]

Tableau d'objets FieldInfo représentant tous les champs définis pour le Type actuel qui correspondent aux contraintes de liaison spécifiées.

• ou - Tableau vide du type FieldInfo si aucun champ n'est défini pour le Type actuel ou si aucun des champs définis ne correspond aux contraintes de liaison.

Implémente

GetFields(BindingFlags) GetFields(BindingFlags)

Exemples

L’exemple suivant illustre une utilisation de la GetFields(BindingFlags) méthode.

C#

using System;
using System.Reflection;

class AttributesSample
{
    public void Mymethod (int int1m, out string str2m, ref string str3m)
    {
        str2m = "in Mymethod";
    }

    public static int Main(string[] args)
    {
        Console.WriteLine ("Reflection.MethodBase.Attributes Sample");

        // Get the type.
        Type MyType = Type.GetType("AttributesSample");

        // Get the method Mymethod on the type.
        MethodBase Mymethodbase = MyType.GetMethod("Mymethod");

        // Display the method name.
        Console.WriteLine("Mymethodbase = " + Mymethodbase);

        // Get the MethodAttribute enumerated value.
        MethodAttributes Myattributes = Mymethodbase.Attributes;

        // Display the flags that are set.
        PrintAttributes(typeof(System.Reflection.MethodAttributes), (int) Myattributes);
        return 0;
    }

    public static void PrintAttributes(Type attribType, int iAttribValue)
    {
        if (!attribType.IsEnum)
        {
            Console.WriteLine("This type is not an enum.");
            return;
        }

        FieldInfo[] fields = attribType.GetFields(BindingFlags.Public | BindingFlags.Static);
        for (int i = 0; i < fields.Length; i++)
        {
            int fieldvalue = (int)fields[i].GetValue(null);
            if ((fieldvalue & iAttribValue) == fieldvalue)
            {
                Console.WriteLine(fields[i].Name);
            }
        }
    }
}

Remarques

Pour que la GetFields(BindingFlags) surcharge récupère correctement les informations de propriété, l' bindingAttr argument doit inclure au moins un de BindingFlags.Instance et BindingFlags.Static , ainsi qu’au moins un de BindingFlags.NonPublic et BindingFlags.Public .

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

• Spécifiez BindingFlags.Instance pour inclure des méthodes d’instance.

• Spécifiez BindingFlags.Static pour inclure des méthodes statiques.

• Spécifiez BindingFlags.Public pour inclure les champs publics dans la recherche.

• Spécifiez BindingFlags.NonPublic pour inclure les champs non publics (c’est-à-dire les champs privés, internes et protégés) dans la recherche. Seuls les champs protected et Internal sur les classes de base sont retournés ; les champs privés sur les classes de base ne sont pas retournés.

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

• Spécifiez BindingFlags.Default seul pour retourner un PropertyInfo tableau vide.

BindingFlagsVous pouvez utiliser les indicateurs de modificateur suivants pour modifier le fonctionnement de la recherche :

• BindingFlags.DeclaredOnly pour rechercher uniquement les champs déclarés sur le Type , et non ceux qui ont simplement été hérités.

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

La GetFields méthode ne retourne pas de champs dans un ordre particulier, par exemple par ordre alphabétique ou par ordre de déclaration. Votre code ne doit pas dépendre de l’ordre dans lequel les champs sont retournés, car cet ordre varie.

Si le actuel Type représente un type générique construit, cette méthode retourne les FieldInfo objets 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 champs publics de la contrainte de classe.

Voir aussi

• FieldInfo
• BindingFlags
• DefaultBinder
• GetField(String, BindingFlags)