Type.GetFields Type.GetFields Type.GetFields Type.GetFields Method

Définition

Obtient les champs du Type actuel.Gets the fields of the current Type.

Surcharges

GetFields() GetFields() GetFields() GetFields()

Retourne tous les champs publics du Type actuel.Returns all the public fields of the current Type.

GetFields(BindingFlags) GetFields(BindingFlags) GetFields(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.When overridden in a derived class, searches for the fields defined for the current Type, using the specified binding constraints.

GetFields() GetFields() GetFields() GetFields()

Retourne tous les champs publics du Type actuel.Returns all the public fields of the current Type.

public:
 virtual cli::array <System::Reflection::FieldInfo ^> ^ GetFields();
public System.Reflection.FieldInfo[] GetFields ();
abstract member GetFields : unit -> System.Reflection.FieldInfo[]
override this.GetFields : unit -> System.Reflection.FieldInfo[]
Public Function GetFields () As FieldInfo()

Retours

Tableau d'objets FieldInfo représentant tous les champs publics définis pour le Type actuel.An array of FieldInfo objects representing all the public fields defined for the current Type.

- ou --or- Tableau vide du type FieldInfo si aucun champ public n'est défini pour le Type actuel.An empty array of type FieldInfo, if no public fields are defined for the current Type.

Implémente

Exemples

L’exemple suivant illustre une utilisation de la GetFields() méthode.The following example shows a use of the GetFields() method.

#using <system.dll>

using namespace System;
using namespace System::Reflection;
using namespace System::ComponentModel::Design;

int main()
{
   try
   {
      // Get the type handle of a specified class.
      Type^ myType = ViewTechnology::typeid;

      // Get the fields of the specified class.
      array<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 );
   }
}
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);
        }
    }
}
Imports System.Reflection
Imports System.ComponentModel.Design

Class FieldInfo_IsSpecialName

    Public Shared Sub Main()
        Try
            ' Get the type handle of a specified class.
            Dim myType As Type = GetType(ViewTechnology)

            ' Get the fields of a specified class.
            Dim myField As FieldInfo() = myType.GetFields()

            Console.WriteLine(ControlChars.Cr + "Displaying fields that have SpecialName attributes:" + ControlChars.Cr)
            Dim i As Integer
            For i = 0 To myField.Length - 1
                ' Determine whether or not each field is a special name.
                If myField(i).IsSpecialName Then
                    Console.WriteLine("The field {0} has a SpecialName attribute.", myField(i).Name)
                End If
            Next i
        Catch e As Exception
            Console.WriteLine("Exception : {0} ", e.Message.ToString())
        End Try
    End Sub
End Class 'FieldInfo_IsSpecialName

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.The GetFields method does not return fields in a particular order, such as alphabetical or declaration order. Votre code ne doit pas dépendre de l’ordre dans lequel les champs sont retournés, car cet ordre varie.Your code must not depend on the order in which fields are returned, because that order varies.

Le tableau suivant indique les membres d’une classe de base qui sont retournés par les méthodes lors de la Get réflexion sur un type.The following table shows what members of a base class are returned by the Get methods when reflecting on a type.

Type de membreMember Type StatiqueStatic Non statiqueNon-Static
ConstructeurConstructor NonNo NonNo
ChampField NonNo Oui.Yes. Un champ est toujours masqué par nom-et-signature.A field is always hide-by-name-and-signature.
événementEvent Non applicableNot 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é.The common type system rule is that the inheritance is the same as that of the methods that implement the property. La réflexion traite les propriétés comme étant masquées-par-nom-et-signature.Reflection treats properties as hide-by-name-and-signature. Voir la remarque 2 ci-dessous.See note 2 below.
MéthodeMethod NonNo Oui.Yes. Une méthode (à la fois virtuelles et non virtuelles) peut être masquée ou masquée-par-nom-et-signature.A method (both virtual and non-virtual) can be hide-by-name or hide-by-name-and-signature.
Type imbriquéNested Type NonNo NonNo
PropertyProperty Non applicableNot 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é.The common type system rule is that the inheritance is the same as that of the methods that implement the property. La réflexion traite les propriétés comme étant masquées-par-nom-et-signature.Reflection treats properties as hide-by-name-and-signature. Voir la remarque 2 ci-dessous.See note 2 below.
  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.Hide-by-name-and-signature considers all of the parts of the signature, including custom modifiers, return types, parameter types, sentinels, and unmanaged calling conventions. Il s’agit d’une comparaison binaire.This is a binary comparison.

  2. Pour la réflexion, les propriétés et les événements sont masqués par nom et signature.For reflection, properties and events are hide-by-name-and-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.If you have a property with both a get and a set accessor in the base class, but the derived class has only a get accessor, the derived class property hides the base class property, and you will not be able to access the setter on the base class.

  3. Les attributs personnalisés ne font pas partie du système de type commun.Custom attributes are not part of the common type system.

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.If the current Type represents a constructed generic type, this method returns the FieldInfo objects with the type parameters replaced by the appropriate type arguments.

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.If the current Type represents a type parameter in the definition of a generic type or generic method, this method searches the public fields of the class constraint.

Voir aussi

GetFields(BindingFlags) GetFields(BindingFlags) GetFields(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.When overridden in a derived class, searches for the fields defined for the current Type, using the specified binding constraints.

public:
 abstract cli::array <System::Reflection::FieldInfo ^> ^ GetFields(System::Reflection::BindingFlags bindingAttr);
public abstract System.Reflection.FieldInfo[] GetFields (System.Reflection.BindingFlags bindingAttr);
abstract member GetFields : System.Reflection.BindingFlags -> System.Reflection.FieldInfo[]
Public MustOverride Function GetFields (bindingAttr As BindingFlags) As FieldInfo()

Paramètres

bindingAttr
BindingFlags BindingFlags BindingFlags BindingFlags

Combinaison de bits de valeurs d’énumération qui spécifie la façon dont est effectuée la recherche.A bitwise combination of the enumeration values that specify how the search is conducted.

- ou --or-

Default pour retourner un tableau vide.Default to return an empty array.

Retours

Tableau d'objets FieldInfo représentant tous les champs définis pour le Type actuel qui correspondent aux contraintes de liaison spécifiées.An array of FieldInfo objects representing all fields defined for the current Type that match the specified binding constraints.

ou-or- 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.An empty array of type FieldInfo, if no fields are defined for the current Type, or if none of the defined fields match the binding constraints.

Implémente

Exemples

L’exemple suivant illustre une utilisation de la GetFields(BindingFlags) méthode.The following example shows a use of the GetFields(BindingFlags) method.

using namespace System;
using namespace System::Reflection;
using namespace System::Runtime::InteropServices;
public ref class AttributesSample
{
public:
   void Mymethod( int int1m, [Out]interior_ptr<String^> str2m, interior_ptr<String^> str3m )
   {
       *str2m = "in Mymethod";
   }
};

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

   array<FieldInfo^>^fields = attribType->GetFields( static_cast<BindingFlags>(BindingFlags::Public | BindingFlags::Static) );
   for ( int i = 0; i < fields->Length; i++ )
   {
      int fieldvalue = safe_cast<Int32>(fields[ i ]->GetValue( nullptr ));
      if ( (fieldvalue & iAttribValue) == fieldvalue )
      {
         Console::WriteLine( fields[ i ]->Name );
      }
   }
}

int main()
{
   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 = {0}", Mymethodbase );

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

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

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 = (Int32)fields[i].GetValue(null);
            if ((fieldvalue & iAttribValue) == fieldvalue)
            {
                Console.WriteLine(fields[i].Name);
            }
        }
    }
}
Imports System.Reflection

Class AttributesSample

    Public Sub Mymethod(ByVal int1m As Integer, ByRef str2m As String, ByRef str3m As String)
        str2m = "in Mymethod"
    End Sub

    Public Shared Function Main(ByVal args() As String) As Integer
        Console.WriteLine("Reflection.MethodBase.Attributes Sample")

        ' Get the type.
        Dim MyType As Type = Type.GetType("AttributesSample")

        ' Get the method Mymethod on the type.
        Dim Mymethodbase As MethodBase = MyType.GetMethod("Mymethod")

        ' Display the method name.
        Console.WriteLine("Mymethodbase = {0}.", Mymethodbase)

        ' Get the MethodAttribute enumerated value.
        Dim Myattributes As MethodAttributes = Mymethodbase.Attributes

        ' Display the flags that are set.
        PrintAttributes(GetType(System.Reflection.MethodAttributes), CInt(Myattributes))
        Return 0
    End Function 'Main

    Public Shared Sub PrintAttributes(ByVal attribType As Type, ByVal iAttribValue As Integer)
        If Not attribType.IsEnum Then
            Console.WriteLine("This type is not an enum.")
            Return
        End If
        Dim fields As FieldInfo() = attribType.GetFields((BindingFlags.Public Or BindingFlags.Static))
        Dim i As Integer
        For i = 0 To fields.Length - 1
            Dim fieldvalue As Integer = CType(fields(i).GetValue(Nothing), Int32)
            If (fieldvalue And iAttribValue) = fieldvalue Then
                Console.WriteLine(fields(i).Name)
            End If
        Next i
    End Sub
End Class 'AttributesSample

Remarques

Pour que GetFields(BindingFlags) la surcharge récupère correctement les informations de propriété bindingAttr , l’argument doit inclure au moins BindingFlags.Instance un BindingFlags.Staticde et, ainsi qu’au moins BindingFlags.NonPublic un BindingFlags.Publicde et.For the GetFields(BindingFlags) overload to successfully retrieve property information, the bindingAttr argument must include at least one of BindingFlags.Instance and BindingFlags.Static, along with at least one of BindingFlags.NonPublic and BindingFlags.Public.

Les indicateurs BindingFlags de filtre suivants peuvent être utilisés pour définir les champs à inclure dans la recherche :The following BindingFlags filter flags can be used to define which fields to include in the search:

  • Spécifiez BindingFlags.Instance pour inclure des méthodes d’instance.Specify BindingFlags.Instance to include instance methods.

  • Spécifiez BindingFlags.Static pour inclure des méthodes statiques.Specify BindingFlags.Static to include static methods.

  • Spécifiez BindingFlags.Public pour inclure les champs publics dans la recherche.Specify BindingFlags.Public to include public fields in the search.

  • 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.Specify BindingFlags.NonPublic to include non-public fields (that is, private, internal, and protected fields) in the search. 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.Only protected and internal fields on base classes are returned; private fields on base classes are not returned.

  • Spécifiez BindingFlags.FlattenHierarchy pour public inclure protected et ajouter des membres statiques dans la hiérarchie. private les membres statiques dans les classes héritées ne sont pas inclus.Specify BindingFlags.FlattenHierarchy to include public and protected static members up the hierarchy; private static members in inherited classes are not included.

  • Spécifiez BindingFlags.Default seul pour retourner un PropertyInfo tableau vide.Specify BindingFlags.Default alone to return an empty PropertyInfo array.

Vous pouvez BindingFlags utiliser les indicateurs de modificateur suivants pour modifier le fonctionnement de la recherche :The following BindingFlags modifier flags can be used to change how the search works:

  • BindingFlags.DeclaredOnlypour rechercher uniquement les champs déclarés sur Typele, et non ceux qui ont simplement été hérités.BindingFlags.DeclaredOnly to search only the fields declared on the Type, not fields that were simply inherited.

Pour plus d'informations, voir System.Reflection.BindingFlags.See System.Reflection.BindingFlags for more information.

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.The GetFields method does not return fields in a particular order, such as alphabetical or declaration order. Votre code ne doit pas dépendre de l’ordre dans lequel les champs sont retournés, car cet ordre varie.Your code must not depend on the order in which fields are returned, because that order varies.

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.If the current Type represents a constructed generic type, this method returns the FieldInfo objects with the type parameters replaced by the appropriate type arguments.

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.If the current Type represents a type parameter in the definition of a generic type or generic method, this method searches the public fields of the class constraint.

Voir aussi

S’applique à