Type.GetProperties Método

Definição

Namespace:

System

Assemblies:

netstandard.dll, System.Runtime.dll

Obtém as propriedades do Type atual.

Sobrecargas

GetProperties()	Retorna todas as propriedades públicas do Type atual.
GetProperties(BindingFlags)	Quando é substituído em uma classe derivada, pesquisa as propriedades do atual Type, usando as restrições de associação especificadas.

GetProperties()

Origem:

Type.cs

Retorna todas as propriedades públicas do Type atual.

C#

public System.Reflection.PropertyInfo[] GetProperties();

Retornos

PropertyInfo[]

Uma matriz de objetos PropertyInfo que representa todas as propriedades públicas do Type atual.

- ou -

Uma matriz vazia do tipo PropertyInfo, se o Type atual não tiver propriedades públicas.

Exemplos

O exemplo a seguir demonstra o uso do método GetProperties.

C#

PropertyInfo[] myPropertyInfo;
// Get the properties of 'Type' class object.
myPropertyInfo = Type.GetType("System.Type").GetProperties();
Console.WriteLine("Properties of System.Type are:");
for (int i = 0; i < myPropertyInfo.Length; i++)
{
    Console.WriteLine(myPropertyInfo[i].ToString());
}

Comentários

Chamar essa sobrecarga é equivalente a chamar a GetProperties(BindingFlags) sobrecarga com um bindingAttr argumento igual a BindingFlags.Instance | BindingFlags.Static | BindingFlags.Public em C# e BindingFlags.Instance Or BindingFlags.Static Or BindingFlags.Public no Visual Basic. Ele retorna todas as propriedades estáticas e de instância pública, ambas definidas pelo tipo representado pelo objeto atual Type , bem como aquelas herdadas de seus tipos base.

Uma propriedade é considerada pública para reflexão caso tenha pelo menos um acessador público. Caso contrário, a propriedade é considerada privada e você deve usar BindingFlags.NonPublic | | BindingFlags.InstanceBindingFlags.Static (no Visual Basic, combinar os valores usando Or) para obtê-la.

No .NET 6 e em versões anteriores, o GetProperties método não retorna propriedades em uma ordem específica, como ordem alfabética ou de declaração. Seu código não deve depender da ordem na qual as propriedades são retornadas, pois essa ordem varia. No entanto, a partir do .NET 7, a ordenação é determinística com base na ordenação de metadados no assembly.

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 PropertyInfo objetos com os parâmetros de tipo substituídos pelos argumentos de tipo apropriados.

Caso o Type atual represente um parâmetro de tipo na definição de um tipo genérico ou método genérico, este método pesquisa as propriedades da restrição de classe.

Confira também

• PropertyInfo
• GetProperty(String, BindingFlags, Binder, Type, Type[], ParameterModifier[])

GetProperties(BindingFlags)

Origem:

Type.cs

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

C#

public abstract System.Reflection.PropertyInfo[] GetProperties(System.Reflection.BindingFlags bindingAttr);

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

PropertyInfo[]

Uma matriz de objetos que representa todas as propriedades do Type atual que correspondem às restrições de associação especificadas.

- ou -

Uma matriz vazia do tipo PropertyInfo, se o Type atual não tiver propriedades, ou se nenhuma das propriedades corresponderem às restrições de associação.

Implementações

GetProperties(BindingFlags)

Exemplos

O exemplo a seguir define uma classe chamada PropertyClass que inclui seis propriedades: duas são públicas, uma é privada, uma é protegida, outra interna (Friend no Visual Basic) e outra interna protegida (Protected Friend no Visual Basic). Em seguida, ele exibe algumas informações básicas de propriedade (o nome e o tipo da propriedade, seja leitura/gravação e a visibilidade de seus get acessadores e set ) para as propriedades que correspondem às restrições de associação especificadas.

C#

using System;
using System.Reflection;

// Create a class having six properties.
public class PropertyClass
{
    public String Property1
    {
        get { return "hello"; }
    }

    public String Property2
    {
        get { return "hello"; }
    }

    protected String Property3
    {
        get { return "hello"; }
    }

    private Int32 Property4
    {
        get { return 32; }
    }

    internal String Property5
    {
       get { return "value"; }
    }

    protected internal String Property6
    {
       get { return "value"; }
    }
}

public class Example
{
    public static void Main()
    {
        Type t = typeof(PropertyClass);
        // Get the public properties.
        PropertyInfo[] propInfos = t.GetProperties(BindingFlags.Public|BindingFlags.Instance);
        Console.WriteLine("The number of public properties: {0}.\n",
                          propInfos.Length);
        // Display the public properties.
        DisplayPropertyInfo(propInfos);

        // Get the nonpublic properties.
        PropertyInfo[] propInfos1 = t.GetProperties(BindingFlags.NonPublic|BindingFlags.Instance);
        Console.WriteLine("The number of non-public properties: {0}.\n",
                          propInfos1.Length);
        // Display all the nonpublic properties.
        DisplayPropertyInfo(propInfos1);
    }

    public static void DisplayPropertyInfo(PropertyInfo[] propInfos)
    {
        // Display information for all properties.
        foreach (var propInfo in propInfos) {
            bool readable = propInfo.CanRead;
            bool writable = propInfo.CanWrite;

            Console.WriteLine("   Property name: {0}", propInfo.Name);
            Console.WriteLine("   Property type: {0}", propInfo.PropertyType);
            Console.WriteLine("   Read-Write:    {0}", readable & writable);
            if (readable) {
               MethodInfo getAccessor = propInfo.GetMethod;
               Console.WriteLine("   Visibility:    {0}",
                                 GetVisibility(getAccessor));
            }
            if (writable) {
               MethodInfo setAccessor = propInfo.SetMethod;
               Console.WriteLine("   Visibility:    {0}",
                                 GetVisibility(setAccessor));
            }
            Console.WriteLine();
        }
    }

    public static String GetVisibility(MethodInfo accessor)
    {
       if (accessor.IsPublic)
          return "Public";
       else if (accessor.IsPrivate)
          return "Private";
       else if (accessor.IsFamily)
          return "Protected";
       else if (accessor.IsAssembly)
          return "Internal/Friend";
       else
          return "Protected Internal/Friend";
    }
}
// The example displays the following output:
//       The number of public properties: 2.
//
//          Property name: Property1
//          Property type: System.String
//          Read-Write:    False
//          Visibility:    Public
//
//          Property name: Property2
//          Property type: System.String
//          Read-Write:    False
//          Visibility:    Public
//
//       The number of non-public properties: 4.
//
//          Property name: Property3
//          Property type: System.String
//          Read-Write:    False
//          Visibility:    Protected
//
//          Property name: Property4
//          Property type: System.Int32
//          Read-Write:    False
//          Visibility:    Private
//
//          Property name: Property5
//          Property type: System.String
//          Read-Write:    False
//          Visibility:    Internal/Friend
//
//          Property name: Property6
//          Property type: System.String
//          Read-Write:    False
//          Visibility:    Protected Internal/Friend

Comentários

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

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

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

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

• Especifique BindingFlags.Public para incluir propriedades públicas na pesquisa. Uma propriedade é considerada pública para reflexão caso tenha pelo menos um acessador público.

• Especifique BindingFlags.NonPublic para incluir propriedades não públicas (ou seja, propriedades particulares, internas e protegidas) na pesquisa. Somente as propriedades protegidas e internas nas classes base são retornadas; as propriedades privadas nas classes base não são retornadas.

• 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 matriz vazia PropertyInfo .

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

• BindingFlags.DeclaredOnly para pesquisar apenas as propriedades declaradas no Type, e não as propriedades que foram simplesmente herdadas.

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

No .NET 6 e em versões anteriores, o GetProperties método não retorna propriedades em uma ordem específica, como ordem alfabética ou de declaração. Seu código não deve depender da ordem na qual as propriedades são retornadas, pois essa ordem varia. No entanto, a partir do .NET 7, a ordenação é determinística com base na ordenação de metadados no assembly.

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

Caso o Type atual represente um parâmetro de tipo na definição de um tipo genérico ou método genérico, este método pesquisa as propriedades da restrição de classe.

Confira também

• PropertyInfo
• BindingFlags
• DefaultBinder
• GetProperty(String, BindingFlags, Binder, Type, Type[], ParameterModifier[])