Type.GetProperties Método

Definición

Espacio de nombres:

System

Ensamblados:

netstandard.dll, System.Runtime.dll

Obtiene las propiedades del objeto Type actual.

Sobrecargas

GetProperties()	Devuelve todas las propiedades públicas del objeto Type actual.
GetProperties(BindingFlags)	Cuando se invalida en una clase derivada, busca las propiedades del objeto Type actual y aplica las restricciones de enlace especificadas.

GetProperties()

Source:

Type.cs

Devuelve todas las propiedades públicas del objeto Type actual.

C#

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

Devoluciones

PropertyInfo[]

Matriz de objetos PropertyInfo que representa todas las propiedades públicas del objeto Type actual.

O bien

Matriz vacía de tipo PropertyInfo si el objeto Type actual no tiene propiedades públicas.

Ejemplos

En el siguiente ejemplo se muestra el uso del 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());
}

Comentarios

Llamar a esta sobrecarga equivale a llamar a la GetProperties(BindingFlags) sobrecarga con un bindingAttr argumento igual a BindingFlags.Instance | BindingFlags.Static | BindingFlags.Public en C# y BindingFlags.Instance Or BindingFlags.Static Or BindingFlags.Public en Visual Basic. Devuelve todas las propiedades estáticas y de instancia pública, tanto las definidas por el tipo representado por el objeto actual Type como las heredadas de sus tipos base.

Una propiedad se considera pública para la reflexión si tiene al menos un descriptor de acceso público. De lo contrario, la propiedad se considera privada y debe usar BindingFlags.NonPublic | | BindingFlags.InstanceBindingFlags.Static (en Visual Basic, combinar los valores mediante Or) para obtenerla.

En .NET 6 y versiones anteriores, el GetProperties método no devuelve propiedades en un orden determinado, como orden alfabético o de declaración. El código no debe depender del orden en el que se devuelven las propiedades, ya que ese orden varía. Sin embargo, a partir de .NET 7, el orden es determinista en función del orden de metadatos del ensamblado.

En la tabla siguiente se muestra qué miembros de una clase base devuelven los Get métodos al reflejar en un tipo.

Tipo de miembro	Estático	No estático
Constructor	No	No
Campo	No	Sí. Un campo siempre se oculta por nombre y firma.
evento	No es aplicable	La regla del sistema de tipos común es que la herencia es la misma que la de los métodos que implementan la propiedad . La reflexión trata las propiedades como hide-by-name-and-signature. Consulte la nota 2 a continuación.
Método	No	Sí. Un método (tanto virtual como no virtual) puede ser hide-by-name u hide-by-name-and-signature.
Tipo anidado	No	No
Propiedad.	No es aplicable	La regla del sistema de tipos común es que la herencia es la misma que la de los métodos que implementan la propiedad . La reflexión trata las propiedades como hide-by-name-and-signature. Consulte la nota 2 a continuación.

1. Hide-by-name-and-signature tiene en cuenta todas las partes de la firma, incluidos modificadores personalizados, tipos de valor devuelto, tipos de parámetros, sentinels y convenciones de llamada no administradas. Se trata de una comparación binaria.

2. Para la reflexión, las propiedades y los eventos son hide-by-name-and-signature. Si tiene una propiedad con un descriptor de acceso get y un set en la clase base, pero la clase derivada solo tiene un descriptor de acceso get, la propiedad de clase derivada oculta la propiedad de clase base y no podrá tener acceso al establecedor en la clase base.

3. Los atributos personalizados no forman parte del sistema de tipos común.

Si el objeto actual Type representa un tipo genérico construido, este método devuelve los objetos con los PropertyInfo parámetros de tipo reemplazados por los argumentos de tipo adecuados.

Si el objeto actual Type representa un parámetro de tipo en la definición de un tipo genérico o un método genérico, este método busca en las propiedades de la restricción de clase.

Consulte también

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

GetProperties(BindingFlags)

Source:

Type.cs

Cuando se invalida en una clase derivada, busca las propiedades del objeto Type actual y aplica las restricciones de enlace especificadas.

C#

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

Parámetros

bindingAttr

BindingFlags

Combinación bit a bit de los valores de enumeración que especifican cómo se realiza la búsqueda.

O bien

Default para que se devuelva una matriz vacía.

Devoluciones

PropertyInfo[]

Matriz de objetos que representa todas las propiedades del objeto Type actual que coinciden con las restricciones de enlace especificadas.

O bien

Matriz vacía de tipo PropertyInfo si el objeto Type actual no tiene propiedades o si ninguna de las propiedades coincide con las restricciones de enlace.

Implementaciones

GetProperties(BindingFlags)

Ejemplos

En el ejemplo siguiente se define una clase denominada PropertyClass que incluye seis propiedades: dos son públicas, una es privada, otra está protegida, otra interna (Friend en Visual Basic) y otra está protegida interna (Protected Friend en Visual Basic). A continuación, muestra información básica de propiedades (el nombre y el tipo de propiedad, si es de lectura y escritura y la visibilidad de sus get descriptores de acceso y set ) para las propiedades que coinciden con las restricciones de enlace 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

Comentarios

Para que la sobrecarga recupere correctamente la GetProperties(BindingFlags) información de propiedad, el bindingAttr argumento debe incluir al menos uno de BindingFlags.Instance y BindingFlags.Static, junto con al menos uno de BindingFlags.NonPublic y BindingFlags.Public.

Se pueden usar las siguientes BindingFlags marcas de filtro para definir qué propiedades se van a incluir en la búsqueda:

• Especifique BindingFlags.Instance para incluir métodos de instancia.

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

• Especifique BindingFlags.Public para incluir propiedades públicas en la búsqueda. Una propiedad se considera pública para la reflexión si tiene al menos un descriptor de acceso público.

• Especifique BindingFlags.NonPublic para incluir propiedades no públicas (es decir, propiedades privadas, internas y protegidas) en la búsqueda. Solo se devuelven las propiedades protegidas y internas de las clases base; No se devuelven las propiedades privadas de las clases base.

• Especifique BindingFlags.FlattenHierarchy para incluir public y protected miembros estáticos en la jerarquía; private no se incluyen los miembros estáticos de las clases heredadas.

• Especifique BindingFlags.Default solo para devolver una matriz vacía PropertyInfo .

Se pueden usar las marcas modificadores siguientes BindingFlags para cambiar el funcionamiento de la búsqueda:

• BindingFlags.DeclaredOnly para buscar solo las propiedades declaradas en Type, no las propiedades que simplemente se heredaron.

Vea System.Reflection.BindingFlags para obtener más información.

En .NET 6 y versiones anteriores, el GetProperties método no devuelve propiedades en un orden determinado, como orden alfabético o de declaración. El código no debe depender del orden en el que se devuelven las propiedades, ya que ese orden varía. Sin embargo, a partir de .NET 7, el orden es determinista en función del orden de metadatos del ensamblado.

Si el objeto actual Type representa un tipo genérico construido, este método devuelve los objetos con los PropertyInfo parámetros de tipo reemplazados por los argumentos de tipo adecuados.

Si el objeto actual Type representa un parámetro de tipo en la definición de un tipo genérico o un método genérico, este método busca en las propiedades de la restricción de clase.

Consulte también

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