Type.GetProperty Método

Definición

Espacio de nombres:

System

Ensamblado:

System.Runtime.dll

Obtiene una propiedad específica del objeto Type actual.

Sobrecargas

GetProperty(String, BindingFlags, Binder, Type, Type[], ParameterModifier[])	Busca la propiedad especificada cuyos parámetros coincidan con los tipos y modificadores de argumentos especificados, mediante las restricciones de enlace indicadas.
GetProperty(String, Type, Type[], ParameterModifier[])	Busca la propiedad pública especificada cuyos parámetros coincidan con los tipos y modificadores de los argumentos especificados.
GetProperty(String, Type[])	Busca la propiedad pública especificada cuyos parámetros coincidan con los tipos de argumentos especificados.
GetProperty(String, Type, Type[])	Busca la propiedad pública especificada cuyos parámetros coincidan con los tipos de argumentos especificados.
GetProperty(String, BindingFlags)	Busca la propiedad especificada, mediante las restricciones de enlace especificadas.
GetProperty(String)	Busca la propiedad pública con el nombre especificado.
GetProperty(String, Type)	Busca la propiedad pública con el nombre especificado y el tipo de valor devuelto.

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

Source:

Type.cs

Busca la propiedad especificada cuyos parámetros coincidan con los tipos y modificadores de argumentos especificados, mediante las restricciones de enlace indicadas.

C#

public System.Reflection.PropertyInfo? GetProperty (string name, System.Reflection.BindingFlags bindingAttr, System.Reflection.Binder? binder, Type? returnType, Type[] types, System.Reflection.ParameterModifier[]? modifiers);

Parámetros

name

String

Cadena que contiene el nombre de la propiedad que se va a obtener.

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 devolver null.

binder

Binder

Objeto que define un conjunto de propiedades y permite realizar operaciones de enlace, que pueden incluir la selección de un método sobrecargado, la coerción de tipos de argumentos y la invocación de un miembro mediante reflexión.

O bien

Referencia nula (Nothing en Visual Basic) para usar la propiedad DefaultBinder.

returnType

Type

Tipo de valor devuelto de la propiedad.

types

Type[]

Matriz de objetos Type que representa el número, el orden y el tipo de parámetros que la propiedad indizada debe obtener.

O bien

Matriz vacía del tipo Type (es decir, Type[] types = new Type[0]) para obtener una propiedad que no esté indizada.

modifiers

ParameterModifier[]

Matriz de objetos ParameterModifier que representan los atributos asociados al elemento correspondiente de la matriz types. El enlazador predeterminado no procesa este parámetro.

Devoluciones

PropertyInfo

Objeto que representa la propiedad que cumple los requisitos especificados, si se encuentra; en caso contrario, es null.

Implementaciones

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

Excepciones

AmbiguousMatchException

Se encontró más de una propiedad con el nombre especificado y que coincide con las restricciones de enlace especificadas.

ArgumentNullException

name es null.

O bien

types es null.

ArgumentException

types es multidimensional.

O bien

modifiers es multidimensional.

O bien

types y modifiers no tienen la misma longitud.

NullReferenceException

Un elemento de types es null.

Comentarios

Para obtener más información sobre esta API, consulte Comentarios complementarios de la API para Type.GetProperty.

Consulte también

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

GetProperty(String, Type, Type[], ParameterModifier[])

Source:

Type.cs

Busca la propiedad pública especificada cuyos parámetros coincidan con los tipos y modificadores de los argumentos especificados.

C#

public System.Reflection.PropertyInfo? GetProperty (string name, Type? returnType, Type[] types, System.Reflection.ParameterModifier[]? modifiers);

Parámetros

name

String

Cadena que contiene el nombre de la propiedad pública que se va a obtener.

returnType

Type

Tipo de valor devuelto de la propiedad.

types

Type[]

Matriz de objetos Type que representa el número, el orden y el tipo de parámetros que la propiedad indizada debe obtener.

O bien

Matriz vacía del tipo Type (es decir, Type[] types = new Type[0]) para obtener una propiedad que no esté indizada.

modifiers

ParameterModifier[]

Matriz de objetos ParameterModifier que representan los atributos asociados al elemento correspondiente de la matriz types. El enlazador predeterminado no procesa este parámetro.

Devoluciones

PropertyInfo

Objeto que representa la propiedad pública que cumple los requisitos especificados, si se encuentra; en caso contrario, es null.

Excepciones

AmbiguousMatchException

Existe más de una propiedad con el nombre especificado que coincide con los modificadores y tipos de argumentos especificados.

ArgumentNullException

name es null.

O bien

types es null.

ArgumentException

types es multidimensional.

O bien

modifiers es multidimensional.

O bien

types y modifiers no tienen la misma longitud.

NullReferenceException

Un elemento de types es null.

Ejemplos

En el ejemplo siguiente se obtiene un Type objeto correspondiente a MyPropertyClassy la propiedad indizada de esta clase se recupera mediante los argumentos pasados al GetProperty método .

C#

using System;
using System.Reflection;

public class MyPropertyClass
{
    private readonly int [,] _myPropertyArray = new int[10,10];
    // Declare an indexer.
    public int this [int i,int j]
    {
        get
        {
            return _myPropertyArray[i,j];
        }
        set
        {
            _myPropertyArray[i,j] = value;
        }
    }
}

public class MyTypeClass
{
    public static void Main()
    {
        try
        {
            Type myType=typeof(MyPropertyClass);
            Type[] myTypeArray = new Type[2];

            // Create an instance of the Type array representing the number, order
            // and type of the parameters for the property.
            myTypeArray.SetValue(typeof(int),0);
            myTypeArray.SetValue(typeof(int),1);

            // Search for the indexed property whose parameters match the
            // specified argument types and modifiers.
            PropertyInfo myPropertyInfo = myType.GetProperty("Item",
                typeof(int),myTypeArray,null);
            Console.WriteLine(myType.FullName + "." + myPropertyInfo.Name +
                " has a property type of " + myPropertyInfo.PropertyType);
         }
        catch(Exception ex)
        {
            Console.WriteLine("An exception occurred " + ex.Message);
        }
    }
}

Comentarios

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.

Aunque el enlazador predeterminado no procesa ParameterModifier (el modifiers parámetro ), puede usar la clase abstracta System.Reflection.Binder para escribir un enlazador personalizado que procesa modifiers. ParameterModifier solo se usa al llamar a través de la interoperabilidad COM y solo se controlan los parámetros que se pasan por referencia.

La búsqueda name distingue mayúsculas de minúsculas. La búsqueda incluye propiedades públicas estáticas y de instancia pública.

Si el objeto actual Type representa un tipo genérico construido, este método devuelve con PropertyInfo los 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
• String
• DefaultBinder
• ParameterModifier
• GetPropertyImpl(String, BindingFlags, Binder, Type, Type[], ParameterModifier[])
• GetProperties(BindingFlags)

GetProperty(String, Type[])

Source:

Type.cs

Busca la propiedad pública especificada cuyos parámetros coincidan con los tipos de argumentos especificados.

C#

public System.Reflection.PropertyInfo? GetProperty (string name, Type[] types);

Parámetros

name

String

Cadena que contiene el nombre de la propiedad pública que se va a obtener.

types

Type[]

Matriz de objetos Type que representa el número, el orden y el tipo de parámetros que la propiedad indizada debe obtener.

O bien

Matriz vacía del tipo Type (es decir, Type[] types = new Type[0]) para obtener una propiedad que no esté indizada.

Devoluciones

PropertyInfo

Objeto que representa la propiedad pública cuyos parámetros coinciden con los tipos de argumentos especificados, si se encuentra; en caso contrario, null.

Excepciones

AmbiguousMatchException

Se encontró más de una propiedad con el nombre especificado y que coincide con los tipos de argumento especificados.

ArgumentNullException

name es null.

O bien

types es null.

ArgumentException

types es multidimensional.

NullReferenceException

Un elemento de types es null.

Ejemplos

En el ejemplo siguiente se recupera el objeto de una clase definida por el Type usuario, se recupera la propiedad de esa clase y se muestra el nombre de propiedad y el tipo de la propiedad tal y como especifican los argumentos pasados a GetProperty.

C#

using System;
using System.Reflection;

class MyClass3
{
    private readonly int[,] _myArray = { { 1, 2 }, { 3, 4 } };
    // Declare an indexer.
    public int this[int i, int j]
    {
        get
        {
            return _myArray[i, j];
        }
        set
        {
            _myArray[i, j] = value;
        }
    }
}

public class MyTypeClass3
{
    public static void Main(string[] args)
    {
        try
        {
            // Get the Type object.
            Type myType = typeof(MyClass3);
            Type[] myTypeArr = new Type[2];

            // Create an instance of a Type array.
            myTypeArr.SetValue(typeof(int), 0);
            myTypeArr.SetValue(typeof(int), 1);

            // Get the PropertyInfo object for the indexed property Item, which has two integer parameters.
            PropertyInfo myPropInfo = myType.GetProperty("Item", myTypeArr);

            // Display the property.
            Console.WriteLine("The {0} property exists in MyClass3.",
                myPropInfo.ToString());
        }
        catch (NullReferenceException e)
        {
            Console.WriteLine("An exception occurred.");
            Console.WriteLine("Source : {0}", e.Source);
            Console.WriteLine("Message : {0}", e.Message);
        }
    }
}

Comentarios

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.

La búsqueda name distingue mayúsculas de minúsculas. La búsqueda incluye propiedades públicas estáticas y de instancia pública.

Si el objeto actual Type representa un tipo genérico construido, este método devuelve con PropertyInfo los 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
• String
• DefaultBinder
• GetPropertyImpl(String, BindingFlags, Binder, Type, Type[], ParameterModifier[])
• GetProperties(BindingFlags)

GetProperty(String, Type, Type[])

Source:

Type.cs

Busca la propiedad pública especificada cuyos parámetros coincidan con los tipos de argumentos especificados.

C#

public System.Reflection.PropertyInfo? GetProperty (string name, Type? returnType, Type[] types);

Parámetros

name

String

Cadena que contiene el nombre de la propiedad pública que se va a obtener.

returnType

Type

Tipo de valor devuelto de la propiedad.

types

Type[]

Matriz de objetos Type que representa el número, el orden y el tipo de parámetros que la propiedad indizada debe obtener.

O bien

Matriz vacía del tipo Type (es decir, Type[] types = new Type[0]) para obtener una propiedad que no esté indizada.

Devoluciones

PropertyInfo

Objeto que representa la propiedad pública cuyos parámetros coinciden con los tipos de argumentos especificados, si se encuentra; en caso contrario, null.

Excepciones

AmbiguousMatchException

Se encontró más de una propiedad con el nombre especificado y que coincide con los tipos de argumento especificados.

ArgumentNullException

name es null.

O bien

types es null.

ArgumentException

types es multidimensional.

NullReferenceException

Un elemento de types es null.

Comentarios

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.

La búsqueda distingue name mayúsculas de minúsculas. La búsqueda incluye propiedades de instancia pública estática y pública.

Si el objeto actual Type representa un tipo genérico construido, este método devuelve con PropertyInfo los 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
• String
• DefaultBinder
• GetPropertyImpl(String, BindingFlags, Binder, Type, Type[], ParameterModifier[])
• GetProperties(BindingFlags)

GetProperty(String, BindingFlags)

Source:

Type.cs

Busca la propiedad especificada, mediante las restricciones de enlace especificadas.

C#

public System.Reflection.PropertyInfo? GetProperty (string name, System.Reflection.BindingFlags bindingAttr);

Parámetros

name

String

Cadena que contiene el nombre de la propiedad que se va a obtener.

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 devolver null.

Devoluciones

PropertyInfo

Objeto que representa la propiedad que cumple los requisitos especificados, si se encuentra; en caso contrario, es null.

Implementaciones

GetProperty(String, BindingFlags)

Excepciones

AmbiguousMatchException

Se encontró más de una propiedad con el nombre especificado y que coincide con las restricciones de enlace especificadas.

ArgumentNullException

name es null.

Ejemplos

En el ejemplo siguiente se recupera el tipo de una clase definida por el usuario, se recupera una propiedad de esa clase y se muestra el nombre de propiedad de acuerdo con las restricciones de enlace especificadas.

C#

using System;
using System.Reflection;

class MyClass2
{
    // Declare MyProperty.
    public int MyProperty { get; set; }
}

public class MyTypeClass2
{
    public static void Main(string[] args)
    {
        try
        {
            // Get Type object of MyClass2.
            Type myType = typeof(MyClass2);

            // Get the PropertyInfo by passing the property name and specifying the BindingFlags.
            PropertyInfo myPropInfo = myType.GetProperty(
                "MyProperty",
                BindingFlags.Public | BindingFlags.Instance
                );

            // Display Name property to console.
            Console.WriteLine("{0} is a property of MyClass2.", myPropInfo.Name);
        }
        catch (NullReferenceException e)
        {
            Console.WriteLine("MyProperty does not exist in MyClass2." + e.Message);
        }
    }
}

Consulte también

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

GetProperty(String)

Source:

Type.cs

Busca la propiedad pública con el nombre especificado.

C#

public System.Reflection.PropertyInfo? GetProperty (string name);

Parámetros

name

String

Cadena que contiene el nombre de la propiedad pública que se va a obtener.

Devoluciones

PropertyInfo

Objeto que representa la propiedad pública con el nombre especificado, si se encuentra; en caso contrario, null.

Excepciones

AmbiguousMatchException

Se encontró más de una propiedad con el nombre especificado.

ArgumentNullException

name es null.

Ejemplos

En el ejemplo siguiente se recupera el objeto de una clase definida por el Type usuario, se recupera una propiedad de esa clase y se muestra el nombre de la propiedad.

C#

using System;
using System.Reflection;

class MyClass1
{
    // Declare MyProperty.
    public int MyProperty { get; set; }
}

public class MyTypeClass1
{
    public static void Main(string[] args)
    {
        try
        {
            // Get the Type object corresponding to MyClass1.
            Type myType = typeof(MyClass1);

            // Get the PropertyInfo object by passing the property name.
            PropertyInfo myPropInfo = myType.GetProperty("MyProperty");

            // Display the property name.
            Console.WriteLine("The {0} property exists in MyClass1.", myPropInfo.Name);
        }
        catch (NullReferenceException e)
        {
            Console.WriteLine("The property does not exist in MyClass1." + e.Message);
        }
    }
}

Comentarios

Para obtener más información sobre esta API, consulte Comentarios complementarios de api para Type.GetProperty.

Consulte también

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

GetProperty(String, Type)

Source:

Type.cs

Busca la propiedad pública con el nombre especificado y el tipo de valor devuelto.

C#

public System.Reflection.PropertyInfo? GetProperty (string name, Type? returnType);

Parámetros

name

String

Cadena que contiene el nombre de la propiedad pública que se va a obtener.

returnType

Type

Tipo de valor devuelto de la propiedad.

Devoluciones

PropertyInfo

Objeto que representa la propiedad pública con el nombre especificado, si se encuentra; en caso contrario, null.

Excepciones

AmbiguousMatchException

Se encontró más de una propiedad con el nombre especificado.

ArgumentNullException

name es null o returnType es null.

Ejemplos

En el ejemplo siguiente se define una clase con una propiedad y se recupera el nombre y el tipo de la propiedad.

C#

using System;
using System.Reflection;

class MyPropertyTypeClass
{
    public string MyProperty1 { get; set; } = "Hello World.";
}

class TestClass
{
    static void Main()
    {
        try
        {
            Type myType = typeof(MyPropertyTypeClass);

            // Get the PropertyInfo object representing MyProperty1.
            PropertyInfo myStringProperties1 = myType.GetProperty("MyProperty1", typeof(string));

            Console.WriteLine("The name of the first property of MyPropertyTypeClass is {0}.",
                myStringProperties1.Name);
            Console.WriteLine("The type of the first property of MyPropertyTypeClass is {0}.",
                myStringProperties1.PropertyType);
        }
        catch (ArgumentNullException e)
        {
            Console.WriteLine("ArgumentNullException :" + e.Message);
        }
        catch (AmbiguousMatchException e)
        {
            Console.WriteLine("AmbiguousMatchException :" + e.Message);
        }
        catch (NullReferenceException e)
        {
            Console.WriteLine("Source : {0}", e.Source);
            Console.WriteLine("Message : {0}", e.Message);
        }
        //Output:
        //The name of the first property of MyPropertyTypeClass is MyProperty1.
        //The type of the first property of MyPropertyTypeClass is System.String.
    }
}

Comentarios

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.

La búsqueda distingue name mayúsculas de minúsculas. La búsqueda incluye propiedades de instancia pública estática y pública.

Si el objeto actual Type representa un tipo genérico construido, este método devuelve con PropertyInfo los 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
• String
• DefaultBinder
• GetPropertyImpl(String, BindingFlags, Binder, Type, Type[], ParameterModifier[])
• GetProperties(BindingFlags)