Type.GetFields Método

Definição

Namespace:

System

Assembly:

System.Runtime.dll

Assembly:

netstandard.dll

Assembly:

mscorlib.dll

Obtém os campos do Type atual.

Sobrecargas

GetFields()	Retorna todos os campos públicos do Type atual.
GetFields(BindingFlags)	Quando é substituído em uma classe derivada, pesquisa os campos definidos para o Type atual usando as restrições de associação especificadas.

GetFields()

Retorna todos os campos públicos do Type atual.

public:
 cli::array <System::Reflection::FieldInfo ^> ^ GetFields();

public:
 virtual cli::array <System::Reflection::FieldInfo ^> ^ GetFields();

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

member this.GetFields : unit -> System.Reflection.FieldInfo[]

abstract member GetFields : unit -> System.Reflection.FieldInfo[]
override this.GetFields : unit -> System.Reflection.FieldInfo[]

Public Function GetFields () As FieldInfo()

Retornos

FieldInfo[]

Uma matriz de objetos FieldInfo que representa todos os campos públicos definidos para o Type atual.

• ou - Uma matriz vazia do tipo FieldInfo se nenhum campo público for definido para o Type atual.

Implementações

GetFields()

Exemplos

O exemplo a seguir mostra um uso do GetFields() método.

#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

Comentários

O GetFields método não retorna campos em uma ordem específica, como ordem alfabética ou declaração. Seu código não deve depender da ordem na qual os campos são retornados, pois essa ordem varia.

A tabela a seguir mostra quais membros de uma classe base são retornados pelos métodos Get durante a reflexão em um tipo.

Tipo do membro	Estático	Não estático
Construtor	Não	Não
Campo	Não	Sim. Um campo permanece sempre oculto por nome e assinatura.
Evento	Não aplicável	A regra de sistema do tipo comum é que a herança é a mesma dos métodos que implementam a propriedade. Reflexão trata propriedades como ocultas por nome e assinatura. Consulte a observação 2 abaixo.
Método	Não	Sim. Um método (virtual e não virtual) pode permanecer oculto por nome ou por nome e assinatura.
Tipo aninhado	Não	Não
Propriedade	Não aplicável	A regra de sistema do tipo comum é que a herança é a mesma dos métodos que implementam a propriedade. Reflexão trata propriedades como ocultas por nome e assinatura. Consulte a observação 2 abaixo.

1. Oculto por nome e assinatura considera todas as partes da assinatura, inclusive modificadores personalizados, tipos de retorno, tipos de parâmetro, sentinelas e convenções de chamada não gerenciadas. Esta é uma comparação binária.

2. Para reflexão, propriedades e eventos permanecem ocultos por nome e assinatura. Se você tiver uma propriedade com um acessador get e set na classe base, mas a classe derivada tiver apenas um acessador get, a propriedade de classe derivada ocultará a propriedade da classe base e você não poderá acessar o setter na classe base.

3. Atributos personalizados não fazem parte do sistema de tipo comum.

Se o atual Type representar um tipo genérico construído, esse método retornará os FieldInfo objetos com os parâmetros de tipo substituídos pelos argumentos de tipo apropriados.

Se o atual Type representar um parâmetro de tipo na definição de um tipo genérico ou um método genérico, esse método pesquisará os campos públicos da restrição de classe.

Confira também

• FieldInfo
• GetField(String, BindingFlags)

GetFields(BindingFlags)

Quando é substituído em uma classe derivada, pesquisa os campos definidos para o Type atual usando as restrições de associação especificadas.

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

Parâmetros

bindingAttr

BindingFlags

Uma combinação bit a bit dos valores de enumeração que especificam como a pesquisa é realizada.

• ou -

Default para retornar uma matriz vazia.

Retornos

FieldInfo[]

Uma matriz de objetos FieldInfo que representa todos os campos definidos para o Type atual que corresponde às restrições de associação especificadas.

• ou - Uma matriz vazia do tipo FieldInfo se nenhum campo estiver definido para o Type atual ou se nenhum dos campos definidos corresponderem às restrições de associação.

Implementações

GetFields(BindingFlags) GetFields(BindingFlags)

Exemplos

O exemplo a seguir mostra um uso do GetFields(BindingFlags) método.

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 = (int)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

Comentários

Para que a GetFields(BindingFlags) sobrecarga recupere com êxito as informações de propriedade, o bindingAttr argumento deve incluir pelo menos um de BindingFlags.Instance e BindingFlags.Static , juntamente com pelo menos um de BindingFlags.NonPublic e BindingFlags.Public .

Os seguintes BindingFlags sinalizadores de filtro podem ser usados para definir quais campos incluir na pesquisa:

• Especifique BindingFlags.Instance para incluir os métodos de instância.

• Especifique BindingFlags.Static para incluir métodos estáticos.

• Especifique BindingFlags.Public para incluir campos públicos na pesquisa.

• Especifique BindingFlags.NonPublic para incluir campos não públicos (ou seja, campos privados, internos e protegidos) na pesquisa. Somente os campos protegidos e internos em classes base são retornados; campos particulares em classes base não são retornados.

• Especifique BindingFlags.FlattenHierarchy para incluir os membros estáticos public e protected acima na hierarquia; os membros estáticos private em classes herdadas não são incluídos.

• Especifique BindingFlags.Default sozinho para retornar uma PropertyInfo matriz vazia.

Os seguintes sinalizadores de modificador BindingFlags podem ser usados para alterar como a pesquisa funciona:

• BindingFlags.DeclaredOnly para pesquisar somente os campos declarados nos Type campos que são simplesmente herdados.

Consulte System.Reflection.BindingFlags para obter mais informações.

O GetFields método não retorna campos em uma ordem específica, como ordem alfabética ou declaração. Seu código não deve depender da ordem na qual os campos são retornados, pois essa ordem varia.

Se o atual Type representar um tipo genérico construído, esse método retornará os FieldInfo objetos com os parâmetros de tipo substituídos pelos argumentos de tipo apropriados.

Se o atual Type representar um parâmetro de tipo na definição de um tipo genérico ou um método genérico, esse método pesquisará os campos públicos da restrição de classe.

Confira também

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