Type.GetProperty Type.GetProperty Type.GetProperty Type.GetProperty Method

Definición

Obtiene una propiedad específica del objeto Type actual.Gets a specific property of the current Type.

Sobrecargas

GetProperty(String) GetProperty(String) GetProperty(String) GetProperty(String)

Busca la propiedad pública con el nombre especificado.Searches for the public property with the specified name.

GetProperty(String, BindingFlags) GetProperty(String, BindingFlags) GetProperty(String, BindingFlags) GetProperty(String, BindingFlags)

Busca la propiedad especificada, mediante las restricciones de enlace especificadas.Searches for the specified property, using the specified binding constraints.

GetProperty(String, Type) GetProperty(String, Type) GetProperty(String, Type) GetProperty(String, Type)

Busca la propiedad pública con el nombre especificado y el tipo de valor devuelto.Searches for the public property with the specified name and return type.

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

Busca la propiedad pública especificada cuyos parámetros coincidan con los tipos de argumentos especificados.Searches for the specified public property whose parameters match the specified argument types.

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

Busca la propiedad pública especificada cuyos parámetros coincidan con los tipos de argumentos especificados.Searches for the specified public property whose parameters match the specified argument types.

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

Busca la propiedad pública especificada cuyos parámetros coincidan con los tipos y modificadores de los argumentos especificados.Searches for the specified public property whose parameters match the specified argument types and modifiers.

GetProperty(String, BindingFlags, Binder, Type, Type[], ParameterModifier[]) GetProperty(String, BindingFlags, Binder, Type, Type[], ParameterModifier[]) 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.Searches for the specified property whose parameters match the specified argument types and modifiers, using the specified binding constraints.

GetProperty(String) GetProperty(String) GetProperty(String) GetProperty(String)

Busca la propiedad pública con el nombre especificado.Searches for the public property with the specified name.

public:
 virtual System::Reflection::PropertyInfo ^ GetProperty(System::String ^ name);
public System.Reflection.PropertyInfo GetProperty (string name);
abstract member GetProperty : string -> System.Reflection.PropertyInfo
override this.GetProperty : string -> System.Reflection.PropertyInfo
Public Function GetProperty (name As String) As PropertyInfo

Parámetros

name
String String String String

Cadena que contiene el nombre de la propiedad pública que se va a obtener.The string containing the name of the public property to get.

Devoluciones

Objeto que representa la propiedad pública con el nombre especificado, si se encuentra; en caso contrario, null.An object representing the public property with the specified name, if found; otherwise, null.

Implementaciones

Excepciones

Se encontró más de una propiedad con el nombre especificado.More than one property is found with the specified name.

Ejemplos

En el ejemplo siguiente se recupera Type el objeto de una clase definida por el usuario, se recupera una propiedad de esa clase y se muestra el nombre de la propiedad.The following example retrieves the Type object of a user-defined class, retrieves a property of that class, and displays the property name.

using namespace System;
using namespace System::Reflection;
ref class MyClass
{
private:
   int myProperty;

public:

   property int MyProperty 
   {
      // Declare MyProperty.
      int get()
      {
         return myProperty;
      }

      void set( int value )
      {
         myProperty = value;
      }
   }
};

int main()
{
   try
   {
      // Get the Type object corresponding to MyClass.
      Type^ myType = MyClass::typeid;
      
      // 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 MyClass.", myPropInfo->Name );
   }
   catch ( NullReferenceException^ e ) 
   {
      Console::WriteLine( "The property does not exist in MyClass. {0}", e->Message );
   }
}

using System;
using System.Reflection;

class MyClass
{
    private int myProperty;
    // Declare MyProperty.
    public int MyProperty
    {
        get
        {
            return myProperty;
        }
        set
        {
            myProperty=value;
        }
    }
}
public class MyTypeClass
{
    public static void Main(string[] args)
    {
        try
        {
            // Get the Type object corresponding to MyClass.
            Type myType=typeof(MyClass);       
            // 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 MyClass.", myPropInfo.Name);
        }
        catch(NullReferenceException e)
        {
            Console.WriteLine("The property does not exist in MyClass." + e.Message);
        }
    }
}
Imports System.Reflection
Class MyClass1
    Private myProperty1 As Integer
    ' Declare MyProperty.

    Public Property MyProperty() As Integer
        Get
            Return myProperty1
        End Get
        Set(ByVal Value As Integer)
            myProperty1 = Value
        End Set
    End Property
End Class 'MyClass1

Public Class MyTypeClass
    Public Shared Sub Main(ByVal args() As String)
        Try
            ' Get Type Object corresponding to MyClass.
            Dim myType As Type = GetType(MyClass1)
            ' Get PropertyInfo object by passing property name.
            Dim myPropInfo As PropertyInfo = myType.GetProperty("MyProperty")
            ' Display Name propety to console.
            Console.WriteLine("The {0} property exists in MyClass.", myPropInfo.Name)
        Catch e As NullReferenceException
            Console.WriteLine("The property does not exist in MyClass.", e.Message.ToString())
        End Try
    End Sub
End Class 'MyTypeClass 

Internamente, se hace referencia a esta propiedad en los metadatos por el nombre "Item".Internally, this property is referred to in the metadata by the name "Item." Cualquier intento de obtener PropertyInfo el uso de la reflexión debe especificar este nombre interno para devolver correctamente PropertyInfo la propiedad.Any attempt to get PropertyInfo using reflection must specify this internal name in order to correctly return the PropertyInfo property.

Comentarios

La búsqueda de name distingue entre mayúsculas y minúsculas.The search for name is case-sensitive. La búsqueda incluye propiedades públicas estáticas y de instancia pública.The search includes public static and public instance properties.

Una propiedad se considera pública para la reflexión si tiene al menos un descriptor de acceso que sea público.A property is considered public to reflection if it has at least one accessor that is public. De lo contrario, la propiedad se considera privada y debe BindingFlags.NonPublic usar | BindingFlags.Instance | BindingFlags.Static (en Visual Basic, combinar los valores Ormediante) para obtenerlo.Otherwise the property is considered private, and you must use BindingFlags.NonPublic | BindingFlags.Instance | BindingFlags.Static (in Visual Basic, combine the values using Or) to get it.

Si el actual Type representa un tipo genérico construido, este método PropertyInfo devuelve con los parámetros de tipo reemplazados por los argumentos de tipo adecuados.If the current Type represents a constructed generic type, this method returns the PropertyInfo with the type parameters replaced by the appropriate type arguments.

Si el actual Type representa un parámetro de tipo en la definición de un tipo genérico o de un método genérico, este método busca en las propiedades de la restricción de clase.If the current Type represents a type parameter in the definition of a generic type or generic method, this method searches the properties of the class constraint.

Entre las situaciones AmbiguousMatchException en las que se produce se incluyen las siguientes:Situations in which AmbiguousMatchException occurs include the following:

  • Un tipo contiene dos propiedades indizadas que tienen el mismo nombre pero distintos números de parámetros.A type contains two indexed properties that have the same name but different numbers of parameters. Para resolver la ambigüedad, utilice una sobrecarga del método que GetProperty especifica los tipos de parámetro.To resolve the ambiguity, use an overload of the GetProperty method that specifies parameter types.

  • Un tipo derivado declara una propiedad que oculta una propiedad heredada con el mismo nombre, mediante el new modificador (Shadows en Visual Basic).A derived type declares a property that hides an inherited property with the same name, by using the new modifier (Shadows in Visual Basic). Para resolver la ambigüedad, use la GetProperty(String, BindingFlags) sobrecarga del método y agregue la BindingFlags.DeclaredOnly marca para restringir la búsqueda a los miembros que no se heredan.To resolve the ambiguity, use the GetProperty(String, BindingFlags) method overload and add the BindingFlags.DeclaredOnly flag to restrict the search to members that are not inherited.

Indexadores y propiedades predeterminadasIndexers and Default Properties

Visual Basic 2005Visual Basic 2005, Visual C# 2005Visual C# 2005 yVisual C++ 2005Visual C++ 2005 tienen una sintaxis simplificada para tener acceso a las propiedades indizadas y permitir que una propiedad indizada sea un valor predeterminado para su tipo., Visual C# 2005Visual C# 2005, and Visual C++ 2005Visual C++ 2005 have simplified syntax for accessing indexed properties and allow one indexed property to be a default for its type. Por ejemplo, si la variable myList hace referencia ArrayLista, la sintaxis myList[3] (myList(3) en Visual Basic) recupera el elemento con el índice 3.For example, if the variable myList refers to an ArrayList, the syntax myList[3] (myList(3) in Visual Basic) retrieves the element with the index of 3. Puede sobrecargar la propiedad.You can overload the property.

En C#, esta característica se denomina indexador y no se puede hacer referencia a ella por su nombre.In C#, this feature is called an indexer and cannot be referred to by name. De forma predeterminada, C# un indexador aparece en los metadatos como una propiedad indizada denominada "Item".By default, a C# indexer appears in metadata as an indexed property named "Item". Sin embargo, un desarrollador de bibliotecas de clases IndexerNameAttribute puede usar el atributo para cambiar el nombre del indizador en los metadatos.However, a class library developer can use the IndexerNameAttribute attribute to change the name of the indexer in the metadata. Por ejemplo, la String clase tiene un indizador denominado Chars[Int32].For example, the String class has an indexer named Chars[Int32]. Las propiedades indexadas creadas con lenguajes C# distintos de también pueden tener nombres distintos de Item.Indexed properties created using languages other than C# can have names other than Item, as well.

Para determinar si un tipo tiene una propiedad predeterminada, utilice el GetCustomAttributes(Type, Boolean) método para probar el DefaultMemberAttribute atributo.To determine whether a type has a default property, use the GetCustomAttributes(Type, Boolean) method to test for the DefaultMemberAttribute attribute. Si el tipo tiene DefaultMemberAttribute, la MemberName propiedad devuelve el nombre de la propiedad predeterminada.If the type has DefaultMemberAttribute, the MemberName property returns the name of the default property.

Consulte también:

GetProperty(String, BindingFlags) GetProperty(String, BindingFlags) GetProperty(String, BindingFlags) GetProperty(String, BindingFlags)

Busca la propiedad especificada, mediante las restricciones de enlace especificadas.Searches for the specified property, using the specified binding constraints.

public:
 virtual System::Reflection::PropertyInfo ^ GetProperty(System::String ^ name, System::Reflection::BindingFlags bindingAttr);
public System.Reflection.PropertyInfo GetProperty (string name, System.Reflection.BindingFlags bindingAttr);
abstract member GetProperty : string * System.Reflection.BindingFlags -> System.Reflection.PropertyInfo
override this.GetProperty : string * System.Reflection.BindingFlags -> System.Reflection.PropertyInfo
Public Function GetProperty (name As String, bindingAttr As BindingFlags) As PropertyInfo

Parámetros

name
String String String String

Cadena que contiene el nombre de la propiedad que se va a obtener.The string containing the name of the property to get.

bindingAttr
BindingFlags BindingFlags BindingFlags BindingFlags

Combinación bit a bit de los valores de enumeración que especifican cómo se realiza la búsqueda.A bitwise combination of the enumeration values that specify how the search is conducted.

o bien-or- Default para devolver null.Default to return null.

Devoluciones

Objeto que representa la propiedad que cumple los requisitos especificados, si se encuentra; en caso contrario, es null.An object representing the property that matches the specified requirements, if found; otherwise, null.

Implementaciones

Excepciones

Se encontró más de una propiedad con el nombre especificado y que coincide con las restricciones de enlace especificadas.More than one property is found with the specified name and matching the specified binding constraints.

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 la propiedad de acuerdo con las restricciones de enlace especificadas.The following example retrieves the type of a user-defined class, retrieves a property of that class and displays the property name in accordance with the specified binding constraints.

using namespace System;
using namespace System::Reflection;
ref class MyClass
{
private:
   int myProperty;

public:

   property int MyProperty 
   {
      // Declare MyProperty.
      int get()
      {
         return myProperty;
      }

      void set( int value )
      {
         myProperty = value;
      }
   }
};

int main()
{
   try
   {
      // Get Type object of MyClass.
      Type^ myType = MyClass::typeid;
      
      // Get the PropertyInfo by passing the property name and specifying the BindingFlags.
      PropertyInfo^ myPropInfo = myType->GetProperty( "MyProperty", static_cast<BindingFlags>(BindingFlags::Public | BindingFlags::Instance) );
      
      // Display Name propety to console.
      Console::WriteLine( "{0} is a property of MyClass.", myPropInfo->Name );
   }
   catch ( NullReferenceException^ e ) 
   {
      Console::WriteLine( "MyProperty does not exist in MyClass. {0}", e->Message );
   }
}

using System;
using System.Reflection;
class MyClass
{
    private int myProperty;
    // Declare MyProperty.
    public int MyProperty
    {
        get
        {
            return myProperty;
        }
        set
        {
            myProperty=value;
        }
    }
}
public class MyTypeClass
{
    public static void Main(string[] args)
    {
        try
        {
            // Get Type object of MyClass.
            Type myType=typeof(MyClass);       
            // Get the PropertyInfo by passing the property name and specifying the BindingFlags.
            PropertyInfo myPropInfo = myType.GetProperty("MyProperty", BindingFlags.Public | BindingFlags.Instance);
            // Display Name propety to console.
            Console.WriteLine("{0} is a property of MyClass.", myPropInfo.Name);
        }
        catch(NullReferenceException e)
        {
            Console.WriteLine("MyProperty does not exist in MyClass." +e.Message);
        }
    }
}

Imports System.Reflection
Module Module1
    Public Class MyClass1
        Private myProperty1 As Integer
        ' Declare MyProperty.
        Public Property MyProperty() As Integer
            Get
                Return myProperty1
            End Get
            Set(ByVal Value As Integer)
                myProperty1 = Value
            End Set
        End Property
        Public Shared Sub Main()
            Try
                ' Get a Type object corresponding to MyClass.
                Dim myType As Type = GetType(MyClass1)
                ' Get a PropertyInfo object by passing property name and specifying BindingFlags.
                Dim myPropInfo As PropertyInfo = myType.GetProperty("MyProperty", BindingFlags.Public Or BindingFlags.Instance)
                ' Display the Name property.
                Console.WriteLine("{0} is a property of MyClass.", myPropInfo.Name)
            Catch e As NullReferenceException
                Console.WriteLine("MyProperty does not exist in MyClass.", e.Message.ToString())
            End Try
        End Sub
    End Class 'MyClass1
End Module 'Module1

Comentarios

Una propiedad se considera pública para la reflexión si tiene al menos un descriptor de acceso que sea público.A property is considered public to reflection if it has at least one accessor that is public. De lo contrario, la propiedad se considera privada y debe BindingFlags.NonPublic usar | BindingFlags.Instance | BindingFlags.Static (en Visual Basic, combinar los valores Ormediante) para obtenerlo.Otherwise the property is considered private, and you must use BindingFlags.NonPublic | BindingFlags.Instance | BindingFlags.Static (in Visual Basic, combine the values using Or) to get it.

Se pueden BindingFlags usar las siguientes marcas de filtro para definir las propiedades que se van a incluir en la búsqueda:The following BindingFlags filter flags can be used to define which properties to include in the search:

  • Debe especificar BindingFlags.Instance o BindingFlags.Static para obtener un valor devuelto.You must specify either BindingFlags.Instance or BindingFlags.Static in order to get a return.

  • Especifique BindingFlags.Public que se incluyan las propiedades públicas en la búsqueda.Specify BindingFlags.Public to include public properties in the search.

  • Especifique BindingFlags.NonPublic que se incluyan propiedades no públicas (es decir, propiedades privadas, internas y protegidas) en la búsqueda.Specify BindingFlags.NonPublic to include non-public properties (that is, private, internal, and protected properties) in the search.

  • Especifica BindingFlags.FlattenHierarchy que se public van protected a incluir y miembros estáticos en la jerarquía. private no se incluyen los miembros estáticos de las clases heredadas.Specify BindingFlags.FlattenHierarchy to include public and protected static members up the hierarchy; private static members in inherited classes are not included.

Se pueden BindingFlags usar las siguientes marcas de modificador para cambiar el funcionamiento de la búsqueda:The following BindingFlags modifier flags can be used to change how the search works:

  • BindingFlags.IgnoreCasepara omitir el caso namede.BindingFlags.IgnoreCase to ignore the case of name.

  • BindingFlags.DeclaredOnlypara buscar solo las propiedades declaradas Typeen, no las propiedades que se han heredado simplemente.BindingFlags.DeclaredOnly to search only the properties declared on the Type, not properties that were simply inherited.

Vea System.Reflection.BindingFlags para obtener más información.See System.Reflection.BindingFlags for more information.

Si el actual Type representa un tipo genérico construido, este método PropertyInfo devuelve con los parámetros de tipo reemplazados por los argumentos de tipo adecuados.If the current Type represents a constructed generic type, this method returns the PropertyInfo with the type parameters replaced by the appropriate type arguments.

Si el actual Type representa un parámetro de tipo en la definición de un tipo genérico o de un método genérico, este método busca en las propiedades de la restricción de clase.If the current Type represents a type parameter in the definition of a generic type or generic method, this method searches the properties of the class constraint.

Entre las situaciones AmbiguousMatchException en las que se produce se incluyen las siguientes:Situations in which AmbiguousMatchException occurs include the following:

  • Un tipo contiene dos propiedades indizadas que tienen el mismo nombre pero distintos números de parámetros.A type contains two indexed properties that have the same name but different numbers of parameters. Para resolver la ambigüedad, utilice una sobrecarga del método que GetProperty especifica los tipos de parámetro.To resolve the ambiguity, use an overload of the GetProperty method that specifies parameter types.

  • Un tipo derivado declara una propiedad que oculta una propiedad heredada con el mismo nombre, mediante el new modificador (Shadows en Visual Basic).A derived type declares a property that hides an inherited property with the same name, using the new modifier (Shadows in Visual Basic). Para resolver la ambigüedad, incluya BindingFlags.DeclaredOnly para restringir la búsqueda a los miembros que no se heredan.To resolve the ambiguity, include BindingFlags.DeclaredOnly to restrict the search to members that are not inherited.

Indexadores y propiedades predeterminadasIndexers and Default Properties

Visual Basic 2005Visual Basic 2005, Visual C# 2005Visual C# 2005 yVisual C++ 2005Visual C++ 2005 tienen una sintaxis simplificada para tener acceso a las propiedades indizadas y permitir que una propiedad indizada sea un valor predeterminado para su tipo., Visual C# 2005Visual C# 2005, and Visual C++ 2005Visual C++ 2005 have simplified syntax for accessing indexed properties and allow one indexed property to be a default for its type. Por ejemplo, si la variable myList hace referencia ArrayLista, la sintaxis myList[3] (myList(3) en Visual Basic) recupera el elemento con el índice 3.For example, if the variable myList refers to an ArrayList, the syntax myList[3] (myList(3) in Visual Basic) retrieves the element with the index of 3. Puede sobrecargar la propiedad.You can overload the property.

En C#, esta característica se denomina indexador y no se puede hacer referencia a ella por su nombre.In C#, this feature is called an indexer and cannot be referred to by name. De forma predeterminada, C# un indexador aparece en los metadatos como una propiedad indizada denominada "Item".By default, a C# indexer appears in metadata as an indexed property named "Item". Sin embargo, un desarrollador de bibliotecas de clases IndexerNameAttribute puede usar el atributo para cambiar el nombre del indizador en los metadatos.However, a class library developer can use the IndexerNameAttribute attribute to change the name of the indexer in the metadata. Por ejemplo, la String clase tiene un indizador denominado Chars[Int32].For example, the String class has an indexer named Chars[Int32]. Las propiedades indexadas creadas con lenguajes C# distintos de también pueden tener nombres distintos de Item.Indexed properties created using languages other than C# can have names other than Item, as well.

Para determinar si un tipo tiene una propiedad predeterminada, utilice el GetCustomAttributes(Type, Boolean) método para probar el DefaultMemberAttribute atributo.To determine whether a type has a default property, use the GetCustomAttributes(Type, Boolean) method to test for the DefaultMemberAttribute attribute. Si el tipo tiene DefaultMemberAttribute, la MemberName propiedad devuelve el nombre de la propiedad predeterminada.If the type has DefaultMemberAttribute, the MemberName property returns the name of the default property.

Consulte también:

GetProperty(String, Type) GetProperty(String, Type) GetProperty(String, Type) GetProperty(String, Type)

Busca la propiedad pública con el nombre especificado y el tipo de valor devuelto.Searches for the public property with the specified name and return type.

public:
 virtual System::Reflection::PropertyInfo ^ GetProperty(System::String ^ name, Type ^ returnType);
public System.Reflection.PropertyInfo GetProperty (string name, Type returnType);
abstract member GetProperty : string * Type -> System.Reflection.PropertyInfo
override this.GetProperty : string * Type -> System.Reflection.PropertyInfo
Public Function GetProperty (name As String, returnType As Type) As PropertyInfo

Parámetros

name
String String String String

Cadena que contiene el nombre de la propiedad pública que se va a obtener.The string containing the name of the public property to get.

returnType
Type Type Type Type

Tipo de valor devuelto de la propiedad.The return type of the property.

Devoluciones

Objeto que representa la propiedad pública con el nombre especificado, si se encuentra; en caso contrario, null.An object representing the public property with the specified name, if found; otherwise, null.

Implementaciones

Excepciones

Se encontró más de una propiedad con el nombre especificado.More than one property is found with the specified name.

name es null o returnType es null.name is null, or returnType is null.

Ejemplos

En el ejemplo siguiente se define una clase con una propiedad y se recupera el nombre y el tipo de la propiedad.The following example defines a class with one property and retrieves the name and type of the property.

using namespace System;
using namespace System::Reflection;
ref class MyClass1
{
private:
   String^ myMessage;

public:

   property String^ MyProperty1 
   {
      String^ get()
      {
         return myMessage;
      }

      void set( String^ value )
      {
         myMessage = value;
      }
   }
};

int main()
{
   try
   {
      Type^ myType = MyClass1::typeid;
      
      // Get the PropertyInfo Object* representing MyProperty1.
      PropertyInfo^ myStringProperties1 = myType->GetProperty( "MyProperty1", String::typeid );
      Console::WriteLine( "The name of the first property of MyClass1 is {0}.", myStringProperties1->Name );
      Console::WriteLine( "The type of the first property of MyClass1 is {0}.", myStringProperties1->PropertyType );
   }
   catch ( ArgumentNullException^ e ) 
   {
      Console::WriteLine( "ArgumentNullException : {0}", e->Message );
   }
   catch ( AmbiguousMatchException^ e ) 
   {
      Console::WriteLine( "AmbiguousMatchException : {0}", 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 MyClass1 is MyProperty1.
   //The type of the first property of MyClass1 is System.String.

}

using System;
using System.Reflection;

class MyClass1
{
    String myMessage="Hello World.";
    public string MyProperty1
    {
        get
        {			
            return myMessage;
        }
        set
        {
            myMessage =value;
        }			
    }
}
class TestClass
{
    static void Main()
    {
        try
        {	
            Type myType = typeof(MyClass1);
            // Get the PropertyInfo object representing MyProperty1. 
            PropertyInfo myStringProperties1 = myType.GetProperty("MyProperty1",
                typeof(string));
            Console.WriteLine("The name of the first property of MyClass1 is {0}.", myStringProperties1.Name);
            Console.WriteLine("The type of the first property of MyClass1 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 MyClass1 is MyProperty1.
	//The type of the first property of MyClass1 is System.String.
    }
}
Imports System.Reflection
Class MyClass1
    Private myMessage As [String] = "Hello World."
    Public Property MyProperty1() As String
        Get
            Return myMessage
        End Get
        Set(ByVal Value As String)
            myMessage = Value
        End Set
    End Property
End Class 'MyClass1

Class TestClass
    Shared Sub Main()
        Try
            Dim myType As Type = GetType(MyClass1)
            ' Get the PropertyInfo object representing MyProperty1. 
            Dim myStringProperties1 As PropertyInfo = myType.GetProperty("MyProperty1", GetType(String))
            Console.WriteLine("The name of the first property of MyClass1 is {0}.", myStringProperties1.Name)
            Console.WriteLine("The type of the first property of MyClass1 is {0}.", myStringProperties1.PropertyType.ToString())
        Catch e As ArgumentNullException
            Console.WriteLine("ArgumentNullException :" + e.Message.ToString())
        Catch e As AmbiguousMatchException
            Console.WriteLine("AmbiguousMatchException :" + e.Message.ToString())
        Catch e As NullReferenceException
            Console.WriteLine("Source : {0}", e.Source.ToString())
            Console.WriteLine("Message : {0}", e.Message.ToString())
        End Try
	'Output:
	'The name of the first property of MyClass1 is MyProperty1.
	'The type of the first property of MyClass1 is System.String.

    End Sub
End Class 'TestClass

Comentarios

Una propiedad se considera pública para la reflexión si tiene al menos un descriptor de acceso que sea público.A property is considered public to reflection if it has at least one accessor that is public. De lo contrario, la propiedad se considera privada y debe BindingFlags.NonPublic usar | BindingFlags.Instance | BindingFlags.Static (en Visual Basic, combinar los valores Ormediante) para obtenerlo.Otherwise the property is considered private, and you must use BindingFlags.NonPublic | BindingFlags.Instance | BindingFlags.Static (in Visual Basic, combine the values using Or) to get it.

La búsqueda de name distingue entre mayúsculas y minúsculas.The search for name is case-sensitive. La búsqueda incluye propiedades públicas estáticas y de instancia pública.The search includes public static and public instance properties.

Si el actual Type representa un tipo genérico construido, este método PropertyInfo devuelve con los parámetros de tipo reemplazados por los argumentos de tipo adecuados.If the current Type represents a constructed generic type, this method returns the PropertyInfo with the type parameters replaced by the appropriate type arguments.

Si el actual Type representa un parámetro de tipo en la definición de un tipo genérico o de un método genérico, este método busca en las propiedades de la restricción de clase.If the current Type represents a type parameter in the definition of a generic type or generic method, this method searches the properties of the class constraint.

Indexadores y propiedades predeterminadasIndexers and Default Properties

Visual Basic 2005Visual Basic 2005, Visual C# 2005Visual C# 2005 yVisual C++ 2005Visual C++ 2005 tienen una sintaxis simplificada para tener acceso a las propiedades indizadas y permitir que una propiedad indizada sea un valor predeterminado para su tipo., Visual C# 2005Visual C# 2005, and Visual C++ 2005Visual C++ 2005 have simplified syntax for accessing indexed properties and allow one indexed property to be a default for its type. Por ejemplo, si la variable myList hace referencia ArrayLista, la sintaxis myList[3] (myList(3) en Visual Basic) recupera el elemento con el índice 3.For example, if the variable myList refers to an ArrayList, the syntax myList[3] (myList(3) in Visual Basic) retrieves the element with the index of 3. Puede sobrecargar la propiedad.You can overload the property.

En C#, esta característica se denomina indexador y no se puede hacer referencia a ella por su nombre.In C#, this feature is called an indexer and cannot be referred to by name. De forma predeterminada, C# un indexador aparece en los metadatos como una propiedad indizada denominada "Item".By default, a C# indexer appears in metadata as an indexed property named "Item". Sin embargo, un desarrollador de bibliotecas de clases IndexerNameAttribute puede usar el atributo para cambiar el nombre del indizador en los metadatos.However, a class library developer can use the IndexerNameAttribute attribute to change the name of the indexer in the metadata. Por ejemplo, la String clase tiene un indizador denominado Chars[Int32].For example, the String class has an indexer named Chars[Int32]. Las propiedades indexadas creadas con lenguajes C# distintos de también pueden tener nombres distintos de Item.Indexed properties created using languages other than C# can have names other than Item, as well.

Para determinar si un tipo tiene una propiedad predeterminada, utilice el GetCustomAttributes(Type, Boolean) método para probar el DefaultMemberAttribute atributo.To determine whether a type has a default property, use the GetCustomAttributes(Type, Boolean) method to test for the DefaultMemberAttribute attribute. Si el tipo tiene DefaultMemberAttribute, la MemberName propiedad devuelve el nombre de la propiedad predeterminada.If the type has DefaultMemberAttribute, the MemberName property returns the name of the default property.

Consulte también:

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

Busca la propiedad pública especificada cuyos parámetros coincidan con los tipos de argumentos especificados.Searches for the specified public property whose parameters match the specified argument types.

public:
 virtual System::Reflection::PropertyInfo ^ GetProperty(System::String ^ name, cli::array <Type ^> ^ types);
public System.Reflection.PropertyInfo GetProperty (string name, Type[] types);
abstract member GetProperty : string * Type[] -> System.Reflection.PropertyInfo
override this.GetProperty : string * Type[] -> System.Reflection.PropertyInfo
Public Function GetProperty (name As String, types As Type()) As PropertyInfo

Parámetros

name
String String String String

Cadena que contiene el nombre de la propiedad pública que se va a obtener.The string containing the name of the public property to get.

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.An array of Type objects representing the number, order, and type of the parameters for the indexed property to get.

o bien-or- Matriz vacía del tipo Type (es decir, Type[] types = new Type[0]) para obtener una propiedad que no esté indizada.An empty array of the type Type (that is, Type[] types = new Type[0]) to get a property that is not indexed.

Devoluciones

Objeto que representa la propiedad pública cuyos parámetros coinciden con los tipos de argumentos especificados, si se encuentra; en caso contrario, null.An object representing the public property whose parameters match the specified argument types, if found; otherwise, null.

Implementaciones

Excepciones

Se encontró más de una propiedad con el nombre especificado y que coincide con los tipos de argumento especificados.More than one property is found with the specified name and matching the specified argument types.

name es null.name is null.

O bien-or- types es null.types is null.

types es multidimensional.types is multidimensional.

Un elemento de types es null.An element of types is null.

Ejemplos

En el ejemplo siguiente se recupera Type el objeto de una clase definida por el usuario, se recupera la propiedad de esa clase y se muestra el nombre de la propiedad y el tipo de la propiedad, tal GetPropertyy como se especifica en los argumentos pasados a.The following example retrieves the Type object of a user-defined class, retrieves the property of that class, and displays the property name and type of the property as specified by the arguments passed to GetProperty.

using namespace System;
using namespace System::Reflection;
ref class MyClass1
{
private:
   array<int, 2>^myArray;

public:

   property int Item [int, int]
   {

      // Declare an indexer.
      int get( int i, int j )
      {
         return myArray[ i,j ];
      }

      void set( int i, int j, int value )
      {
         myArray[ i,j ] = value;
      }

   }

};

int main()
{
   try
   {
      
      // Get the Type object.
      Type^ myType = MyClass1::typeid;
      array<Type^>^myTypeArr = gcnew array<Type^>(2);
      
      // Create an instance of a Type array.
      myTypeArr->SetValue( int::typeid, 0 );
      myTypeArr->SetValue( int::typeid, 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 MyClass1.", myPropInfo );
   }
   catch ( NullReferenceException^ e ) 
   {
      Console::WriteLine( "An exception occurred." );
      Console::WriteLine( "Source : {0}", e->Source );
      Console::WriteLine( "Message : {0}", e->Message );
   }

}


using System;
using System.Reflection;
class MyClass1
{         
    private 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 MyTypeClass
{
    public static void Main(string[] args)
    {
        try
        { 
            // Get the Type object.
            Type myType=typeof(MyClass1);       
            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 MyClass1.", myPropInfo.ToString());
        }           
        catch(NullReferenceException e)
        {
            Console.WriteLine("An exception occurred.");
            Console.WriteLine("Source : {0}" , e.Source);
            Console.WriteLine("Message : {0}" , e.Message);
        }
    }
}
Imports System.Reflection

Module Module1
    Class MyClass1
        Private myArray As Integer(,) = {{1, 2}, {3, 4}}
        ' Declare an indexer.
        Default Public Property Item(ByVal i As Integer, ByVal j As Integer) As Integer
            Get
                Return myArray(i, j)
            End Get
            Set(ByVal Value As Integer)

                myArray(i, j) = Value
            End Set
        End Property
    End Class 'MyClass1

    Public Class MyTypeClass
        Public Shared Sub Main()
            Try
                ' Get the Type Object.
                Dim myType As Type = GetType(MyClass1)
                Dim myTypeArr(1) As Type
                ' Create an instance of a Type array.
                myTypeArr.SetValue(GetType(Integer), 0)
                myTypeArr.SetValue(GetType(Integer), 1)
                ' Get the PropertyInfo object for the indexed property Item, which has two integer parameters. 
                Dim myPropInfo As PropertyInfo = myType.GetProperty("Item", myTypeArr)
                ' Display the property.
                Console.WriteLine("The {0} property exists in MyClass1.", myPropInfo.ToString())
            Catch e As NullReferenceException
                Console.WriteLine("An exception occurred.")
                Console.WriteLine("Source : {0}", e.Source.ToString())
                Console.WriteLine("Message : {0}", e.Message.ToString())
            End Try
        End Sub
    End Class 'MyTypeClass
End Module 'Module1

Comentarios

Una propiedad se considera pública para la reflexión si tiene al menos un descriptor de acceso que sea público.A property is considered public to reflection if it has at least one accessor that is public. De lo contrario, la propiedad se considera privada y debe BindingFlags.NonPublic usar | BindingFlags.Instance | BindingFlags.Static (en Visual Basic, combinar los valores Ormediante) para obtenerlo.Otherwise the property is considered private, and you must use BindingFlags.NonPublic | BindingFlags.Instance | BindingFlags.Static (in Visual Basic, combine the values using Or) to get it.

La búsqueda de name distingue entre mayúsculas y minúsculas.The search for name is case-sensitive. La búsqueda incluye propiedades públicas estáticas y de instancia pública.The search includes public static and public instance properties.

Si el actual Type representa un tipo genérico construido, este método PropertyInfo devuelve con los parámetros de tipo reemplazados por los argumentos de tipo adecuados.If the current Type represents a constructed generic type, this method returns the PropertyInfo with the type parameters replaced by the appropriate type arguments.

Si el actual Type representa un parámetro de tipo en la definición de un tipo genérico o de un método genérico, este método busca en las propiedades de la restricción de clase.If the current Type represents a type parameter in the definition of a generic type or generic method, this method searches the properties of the class constraint.

Indexadores y propiedades predeterminadasIndexers and Default Properties

Visual Basic 2005Visual Basic 2005, Visual C# 2005Visual C# 2005 yVisual C++ 2005Visual C++ 2005 tienen una sintaxis simplificada para tener acceso a las propiedades indizadas y permitir que una propiedad indizada sea un valor predeterminado para su tipo., Visual C# 2005Visual C# 2005, and Visual C++ 2005Visual C++ 2005 have simplified syntax for accessing indexed properties and allow one indexed property to be a default for its type. Por ejemplo, si la variable myList hace referencia ArrayLista, la sintaxis myList[3] (myList(3) en Visual Basic) recupera el elemento con el índice 3.For example, if the variable myList refers to an ArrayList, the syntax myList[3] (myList(3) in Visual Basic) retrieves the element with the index of 3. Puede sobrecargar la propiedad.You can overload the property.

En C#, esta característica se denomina indexador y no se puede hacer referencia a ella por su nombre.In C#, this feature is called an indexer and cannot be referred to by name. De forma predeterminada, C# un indexador aparece en los metadatos como una propiedad indizada denominada "Item".By default, a C# indexer appears in metadata as an indexed property named "Item". Sin embargo, un desarrollador de bibliotecas de clases IndexerNameAttribute puede usar el atributo para cambiar el nombre del indizador en los metadatos.However, a class library developer can use the IndexerNameAttribute attribute to change the name of the indexer in the metadata. Por ejemplo, la String clase tiene un indizador denominado Chars[Int32].For example, the String class has an indexer named Chars[Int32]. Las propiedades indexadas creadas con lenguajes C# distintos de también pueden tener nombres distintos de Item.Indexed properties created using languages other than C# can have names other than Item, as well.

Para determinar si un tipo tiene una propiedad predeterminada, utilice el GetCustomAttributes(Type, Boolean) método para probar el DefaultMemberAttribute atributo.To determine whether a type has a default property, use the GetCustomAttributes(Type, Boolean) method to test for the DefaultMemberAttribute attribute. Si el tipo tiene DefaultMemberAttribute, la MemberName propiedad devuelve el nombre de la propiedad predeterminada.If the type has DefaultMemberAttribute, the MemberName property returns the name of the default property.

Consulte también:

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

Busca la propiedad pública especificada cuyos parámetros coincidan con los tipos de argumentos especificados.Searches for the specified public property whose parameters match the specified argument types.

public:
 virtual System::Reflection::PropertyInfo ^ GetProperty(System::String ^ name, Type ^ returnType, cli::array <Type ^> ^ types);
public System.Reflection.PropertyInfo GetProperty (string name, Type returnType, Type[] types);
abstract member GetProperty : string * Type * Type[] -> System.Reflection.PropertyInfo
override this.GetProperty : string * Type * Type[] -> System.Reflection.PropertyInfo
Public Function GetProperty (name As String, returnType As Type, types As Type()) As PropertyInfo

Parámetros

name
String String String String

Cadena que contiene el nombre de la propiedad pública que se va a obtener.The string containing the name of the public property to get.

returnType
Type Type Type Type

Tipo de valor devuelto de la propiedad.The return type of the property.

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.An array of Type objects representing the number, order, and type of the parameters for the indexed property to get.

O bien-or- Matriz vacía del tipo Type (es decir, Type[] types = new Type[0]) para obtener una propiedad que no esté indizada.An empty array of the type Type (that is, Type[] types = new Type[0]) to get a property that is not indexed.

Devoluciones

Objeto que representa la propiedad pública cuyos parámetros coinciden con los tipos de argumentos especificados, si se encuentra; en caso contrario, null.An object representing the public property whose parameters match the specified argument types, if found; otherwise, null.

Implementaciones

Excepciones

Se encontró más de una propiedad con el nombre especificado y que coincide con los tipos de argumento especificados.More than one property is found with the specified name and matching the specified argument types.

name es null.name is null.

O bien-or- types es null.types is null.

types es multidimensional.types is multidimensional.

Un elemento de types es null.An element of types is null.

Comentarios

Una propiedad se considera pública para la reflexión si tiene al menos un descriptor de acceso que sea público.A property is considered public to reflection if it has at least one accessor that is public. De lo contrario, la propiedad se considera privada y debe BindingFlags.NonPublic usar | BindingFlags.Instance | BindingFlags.Static (en Visual Basic, combinar los valores Ormediante) para obtenerlo.Otherwise the property is considered private, and you must use BindingFlags.NonPublic | BindingFlags.Instance | BindingFlags.Static (in Visual Basic, combine the values using Or) to get it.

La búsqueda de name distingue entre mayúsculas y minúsculas.The search for name is case-sensitive. La búsqueda incluye propiedades públicas estáticas y de instancia pública.The search includes public static and public instance properties.

Si el actual Type representa un tipo genérico construido, este método PropertyInfo devuelve con los parámetros de tipo reemplazados por los argumentos de tipo adecuados.If the current Type represents a constructed generic type, this method returns the PropertyInfo with the type parameters replaced by the appropriate type arguments.

Si el actual Type representa un parámetro de tipo en la definición de un tipo genérico o de un método genérico, este método busca en las propiedades de la restricción de clase.If the current Type represents a type parameter in the definition of a generic type or generic method, this method searches the properties of the class constraint.

Indexadores y propiedades predeterminadasIndexers and Default Properties

Visual Basic 2005Visual Basic 2005, Visual C# 2005Visual C# 2005 yVisual C++ 2005Visual C++ 2005 tienen una sintaxis simplificada para tener acceso a las propiedades indizadas y permitir que una propiedad indizada sea un valor predeterminado para su tipo., Visual C# 2005Visual C# 2005, and Visual C++ 2005Visual C++ 2005 have simplified syntax for accessing indexed properties and allow one indexed property to be a default for its type. Por ejemplo, si la variable myList hace referencia ArrayLista, la sintaxis myList[3] (myList(3) en Visual Basic) recupera el elemento con el índice 3.For example, if the variable myList refers to an ArrayList, the syntax myList[3] (myList(3) in Visual Basic) retrieves the element with the index of 3. Puede sobrecargar la propiedad.You can overload the property.

En C#, esta característica se denomina indexador y no se puede hacer referencia a ella por su nombre.In C#, this feature is called an indexer and cannot be referred to by name. De forma predeterminada, C# un indexador aparece en los metadatos como una propiedad indizada denominada "Item".By default, a C# indexer appears in metadata as an indexed property named "Item". Sin embargo, un desarrollador de bibliotecas de clases IndexerNameAttribute puede usar el atributo para cambiar el nombre del indizador en los metadatos.However, a class library developer can use the IndexerNameAttribute attribute to change the name of the indexer in the metadata. Por ejemplo, la String clase tiene un indizador denominado Chars[Int32].For example, the String class has an indexer named Chars[Int32]. Las propiedades indexadas creadas con lenguajes C# distintos de también pueden tener nombres distintos de Item.Indexed properties created using languages other than C# can have names other than Item, as well.

Para determinar si un tipo tiene una propiedad predeterminada, utilice el GetCustomAttributes(Type, Boolean) método para probar el DefaultMemberAttribute atributo.To determine whether a type has a default property, use the GetCustomAttributes(Type, Boolean) method to test for the DefaultMemberAttribute attribute. Si el tipo tiene DefaultMemberAttribute, la MemberName propiedad devuelve el nombre de la propiedad predeterminada.If the type has DefaultMemberAttribute, the MemberName property returns the name of the default property.

Consulte también:

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

Busca la propiedad pública especificada cuyos parámetros coincidan con los tipos y modificadores de los argumentos especificados.Searches for the specified public property whose parameters match the specified argument types and modifiers.

public:
 virtual System::Reflection::PropertyInfo ^ GetProperty(System::String ^ name, Type ^ returnType, cli::array <Type ^> ^ types, cli::array <System::Reflection::ParameterModifier> ^ modifiers);
public System.Reflection.PropertyInfo GetProperty (string name, Type returnType, Type[] types, System.Reflection.ParameterModifier[] modifiers);
abstract member GetProperty : string * Type * Type[] * System.Reflection.ParameterModifier[] -> System.Reflection.PropertyInfo
override this.GetProperty : string * Type * Type[] * System.Reflection.ParameterModifier[] -> System.Reflection.PropertyInfo
Public Function GetProperty (name As String, returnType As Type, types As Type(), modifiers As ParameterModifier()) As PropertyInfo

Parámetros

name
String String String String

Cadena que contiene el nombre de la propiedad pública que se va a obtener.The string containing the name of the public property to get.

returnType
Type Type Type Type

Tipo de valor devuelto de la propiedad.The return type of the property.

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.An array of Type objects representing the number, order, and type of the parameters for the indexed property to get.

o bien-or- Matriz vacía del tipo Type (es decir, Type[] types = new Type[0]) para obtener una propiedad que no esté indizada.An empty array of the type Type (that is, Type[] types = new Type[0]) to get a property that is not indexed.

modifiers
ParameterModifier[]

Matriz de objetos ParameterModifier que representan los atributos asociados al elemento correspondiente de la matriz types.An array of ParameterModifier objects representing the attributes associated with the corresponding element in the types array. El enlazador predeterminado no procesa este parámetro.The default binder does not process this parameter.

Devoluciones

Objeto que representa la propiedad pública que cumple los requisitos especificados, si se encuentra; en caso contrario, es null.An object representing the public property that matches the specified requirements, if found; otherwise, null.

Implementaciones

Excepciones

Existe más de una propiedad con el nombre especificado que coincide con los modificadores y tipos de argumentos especificados.More than one property is found with the specified name and matching the specified argument types and modifiers.

name es null.name is null.

o bien-or- types es null.types is null.

types es multidimensional.types is multidimensional.

o bien-or- modifiers es multidimensional.modifiers is multidimensional.

o bien-or- types y modifiers no tienen la misma longitud.types and modifiers do not have the same length.

Un elemento de types es null.An element of types is null.

Ejemplos

En el ejemplo siguiente se obtiene Type un objeto que MyPropertyClassse corresponde con y la propiedad indizada de esta clase se recupera utilizando GetProperty los argumentos pasados al método.The following example obtains a Type object corresponding to MyPropertyClass, and the indexed property of this class is retrieved using the arguments passed to the GetProperty method.

using namespace System;
using namespace System::Reflection;
public ref class MyPropertyClass
{
private:
   array<int, 2>^ myPropertyArray;

public:

   property int Item [int, int]
   {
      // Declare an indexer.
      int get( int i, int j )
      {
         return myPropertyArray[ i,j ];
      }

      void set( int i, int j, int value )
      {
         myPropertyArray[ i,j ] = value;
      }

   }

};

int main()
{
   try
   {
      Type^ myType = MyPropertyClass::typeid;
      array<Type^>^myTypeArray = gcnew array<Type^>(2);
      
      // Create an instance of the Type array representing the number, order
      // and type of the parameters for the property.
      myTypeArray->SetValue( int::typeid, 0 );
      myTypeArray->SetValue( int::typeid, 1 );
      
      // Search for the indexed property whose parameters match the
      // specified argument types and modifiers.
      PropertyInfo^ myPropertyInfo = myType->GetProperty( "Item", int::typeid, myTypeArray, nullptr );
      Console::WriteLine( "{0}.{1} has a property type of {2}", myType->FullName, myPropertyInfo->Name, myPropertyInfo->PropertyType );
   }
   catch ( Exception^ ex ) 
   {
      Console::WriteLine( "An exception occurred {0}", ex->Message );
   }

}

using System;
using System.Reflection;
public class MyPropertyClass
{
    private 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);
        }
    }
}
Imports System.Reflection

Public Class MyPropertyClass
    Private myPropertyArray(9, 9) As Integer
    ' Declare an indexer.
    Default Public Property Item(ByVal i As Integer, ByVal j As Integer) As Integer
        Get
            Return myPropertyArray(i, j)
        End Get
        Set(ByVal Value As Integer)
            myPropertyArray(i, j) = Value
        End Set
    End Property
End Class 'MyPropertyClass

Public Class MyTypeClass
    Public Shared Sub Main()
        Try
            Dim myType As Type = GetType(MyPropertyClass)
            Dim myTypeArray(1) As Type
            ' Create an instance of a Type array representing the number, order 
            ' and type of the parameters for the property.
            myTypeArray.SetValue(GetType(Integer), 0)
            myTypeArray.SetValue(GetType(Integer), 1)
            ' Search for the indexed property whose parameters match the
            ' specified argument types and modifiers.
            Dim myPropertyInfo As PropertyInfo = myType.GetProperty("Item", _
                  GetType(Integer), myTypeArray, Nothing)
            Console.WriteLine(myType.FullName + "." + myPropertyInfo.Name + _
                  " has a property  type of " + myPropertyInfo.PropertyType.ToString())
        Catch ex As Exception
            Console.WriteLine("An exception occurred " + ex.Message.ToString())
        End Try
    End Sub
End Class 'MyTypeClass

Comentarios

Una propiedad se considera pública para la reflexión si tiene al menos un descriptor de acceso que sea público.A property is considered public to reflection if it has at least one accessor that is public. De lo contrario, la propiedad se considera privada y debe BindingFlags.NonPublic usar | BindingFlags.Instance | BindingFlags.Static (en Visual Basic, combinar los valores Ormediante) para obtenerlo.Otherwise the property is considered private, and you must use BindingFlags.NonPublic | BindingFlags.Instance | BindingFlags.Static (in Visual Basic, combine the values using Or) to get it.

Aunque ParameterModifier el enlazador predeterminado no procesa (el modifiers parámetro), puede usar la clase abstracta System.Reflection.Binder para escribir un enlazador personalizado que realice el proceso modifiers.Although the default binder does not process ParameterModifier (the modifiers parameter), you can use the abstract System.Reflection.Binder class to write a custom binder that does process modifiers. ParameterModifiersolo se usa cuando se llama a través de la interoperabilidad COM y solo se controlan los parámetros que se pasan por referencia.ParameterModifier is only used when calling through COM interop, and only parameters that are passed by reference are handled.

La búsqueda de name distingue entre mayúsculas y minúsculas.The search for name is case-sensitive. La búsqueda incluye propiedades públicas estáticas y de instancia pública.The search includes public static and public instance properties.

Si el actual Type representa un tipo genérico construido, este método PropertyInfo devuelve con los parámetros de tipo reemplazados por los argumentos de tipo adecuados.If the current Type represents a constructed generic type, this method returns the PropertyInfo with the type parameters replaced by the appropriate type arguments.

Si el actual Type representa un parámetro de tipo en la definición de un tipo genérico o de un método genérico, este método busca en las propiedades de la restricción de clase.If the current Type represents a type parameter in the definition of a generic type or generic method, this method searches the properties of the class constraint.

Indexadores y propiedades predeterminadasIndexers and Default Properties

Visual Basic 2005Visual Basic 2005, Visual C# 2005Visual C# 2005 yVisual C++ 2005Visual C++ 2005 tienen una sintaxis simplificada para tener acceso a las propiedades indizadas y permitir que una propiedad indizada sea un valor predeterminado para su tipo., Visual C# 2005Visual C# 2005, and Visual C++ 2005Visual C++ 2005 have simplified syntax for accessing indexed properties and allow one indexed property to be a default for its type. Por ejemplo, si la variable myList hace referencia ArrayLista, la sintaxis myList[3] (myList(3) en Visual Basic) recupera el elemento con el índice 3.For example, if the variable myList refers to an ArrayList, the syntax myList[3] (myList(3) in Visual Basic) retrieves the element with the index of 3. Puede sobrecargar la propiedad.You can overload the property.

En C#, esta característica se denomina indexador y no se puede hacer referencia a ella por su nombre.In C#, this feature is called an indexer and cannot be referred to by name. De forma predeterminada, C# un indexador aparece en los metadatos como una propiedad indizada denominada "Item".By default, a C# indexer appears in metadata as an indexed property named "Item". Sin embargo, un desarrollador de bibliotecas de clases IndexerNameAttribute puede usar el atributo para cambiar el nombre del indizador en los metadatos.However, a class library developer can use the IndexerNameAttribute attribute to change the name of the indexer in the metadata. Por ejemplo, la String clase tiene un indizador denominado Chars[Int32].For example, the String class has an indexer named Chars[Int32]. Las propiedades indexadas creadas con lenguajes C# distintos de también pueden tener nombres distintos de Item.Indexed properties created using languages other than C# can have names other than Item, as well.

Para determinar si un tipo tiene una propiedad predeterminada, utilice el GetCustomAttributes(Type, Boolean) método para probar el DefaultMemberAttribute atributo.To determine whether a type has a default property, use the GetCustomAttributes(Type, Boolean) method to test for the DefaultMemberAttribute attribute. Si el tipo tiene DefaultMemberAttribute, la MemberName propiedad devuelve el nombre de la propiedad predeterminada.If the type has DefaultMemberAttribute, the MemberName property returns the name of the default property.

Consulte también:

GetProperty(String, BindingFlags, Binder, Type, Type[], ParameterModifier[]) GetProperty(String, BindingFlags, Binder, Type, Type[], ParameterModifier[]) 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.Searches for the specified property whose parameters match the specified argument types and modifiers, using the specified binding constraints.

public:
 virtual System::Reflection::PropertyInfo ^ GetProperty(System::String ^ name, System::Reflection::BindingFlags bindingAttr, System::Reflection::Binder ^ binder, Type ^ returnType, cli::array <Type ^> ^ types, cli::array <System::Reflection::ParameterModifier> ^ modifiers);
public System.Reflection.PropertyInfo GetProperty (string name, System.Reflection.BindingFlags bindingAttr, System.Reflection.Binder binder, Type returnType, Type[] types, System.Reflection.ParameterModifier[] modifiers);
abstract member GetProperty : string * System.Reflection.BindingFlags * System.Reflection.Binder * Type * Type[] * System.Reflection.ParameterModifier[] -> System.Reflection.PropertyInfo
override this.GetProperty : string * System.Reflection.BindingFlags * System.Reflection.Binder * Type * Type[] * System.Reflection.ParameterModifier[] -> System.Reflection.PropertyInfo

Parámetros

name
String String String String

Cadena que contiene el nombre de la propiedad que se va a obtener.The string containing the name of the property to get.

bindingAttr
BindingFlags BindingFlags BindingFlags BindingFlags

Combinación bit a bit de los valores de enumeración que especifican cómo se realiza la búsqueda.A bitwise combination of the enumeration values that specify how the search is conducted.

O bien-or- Default para devolver null.Default to return null.

binder
Binder Binder 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.An object that defines a set of properties and enables binding, which can involve selection of an overloaded method, coercion of argument types, and invocation of a member through reflection.

O bien-or- Referencia nula (Nothing en Visual Basic) para usar la propiedad DefaultBinder.A null reference (Nothing in Visual Basic), to use the DefaultBinder.

returnType
Type Type Type Type

Tipo de valor devuelto de la propiedad.The return type of the property.

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.An array of Type objects representing the number, order, and type of the parameters for the indexed property to get.

O bien-or- Matriz vacía del tipo Type (es decir, Type[] types = new Type[0]) para obtener una propiedad que no esté indizada.An empty array of the type Type (that is, Type[] types = new Type[0]) to get a property that is not indexed.

modifiers
ParameterModifier[]

Matriz de objetos ParameterModifier que representan los atributos asociados al elemento correspondiente de la matriz types.An array of ParameterModifier objects representing the attributes associated with the corresponding element in the types array. El enlazador predeterminado no procesa este parámetro.The default binder does not process this parameter.

Devoluciones

Objeto que representa la propiedad que cumple los requisitos especificados, si se encuentra; en caso contrario, es null.An object representing the property that matches the specified requirements, if found; otherwise, null.

Implementaciones

Excepciones

Se encontró más de una propiedad con el nombre especificado y que coincide con las restricciones de enlace especificadas.More than one property is found with the specified name and matching the specified binding constraints.

name es null.name is null.

o bien-or- types es null.types is null.

types es multidimensional.types is multidimensional.

o bien-or- modifiers es multidimensional.modifiers is multidimensional.

O bien-or- types y modifiers no tienen la misma longitud.types and modifiers do not have the same length.

Un elemento de types es null.An element of types is null.

Comentarios

Una propiedad se considera pública para la reflexión si tiene al menos un descriptor de acceso que sea público.A property is considered public to reflection if it has at least one accessor that is public. De lo contrario, la propiedad se considera privada y debe BindingFlags.NonPublic usar | BindingFlags.Instance | BindingFlags.Static (en Visual Basic, combinar los valores Ormediante) para obtenerlo.Otherwise the property is considered private, and you must use BindingFlags.NonPublic | BindingFlags.Instance | BindingFlags.Static (in Visual Basic, combine the values using Or) to get it.

Aunque ParameterModifier el enlazador predeterminado no procesa (el modifiers parámetro), puede usar la clase abstracta System.Reflection.Binder para escribir un enlazador personalizado que realice el proceso modifiers.Although the default binder does not process ParameterModifier (the modifiers parameter), you can use the abstract System.Reflection.Binder class to write a custom binder that does process modifiers. ParameterModifiersolo se usa cuando se llama a través de la interoperabilidad COM y solo se controlan los parámetros que se pasan por referencia.ParameterModifier is only used when calling through COM interop, and only parameters that are passed by reference are handled.

En la tabla siguiente se muestra qué miembros de una clase base son devueltos por los Get métodos cuando se reflejan en un tipo.The following table shows what members of a base class are returned by the Get methods when reflecting on a type.

Tipo de miembroMember Type EstáticoStatic No estáticaNon-Static
ConstructorConstructor NoNo NoNo
CampoField NoNo Sí.Yes. Un campo siempre se oculta por nombre y firma.A field is always hide-by-name-and-signature.
eventoEvent No es aplicableNot applicable La regla del sistema de tipos comunes es que la herencia es la misma que la de los métodos que implementan la propiedad.The common type system rule is that the inheritance is the same as that of the methods that implement the property. La reflexión trata las propiedades como ocultas por nombre y firma.Reflection treats properties as hide-by-name-and-signature. Vea la nota 2 a continuación.See note 2 below.
MétodoMethod NoNo Sí.Yes. Un método (tanto virtual como no virtual) se puede ocultar por nombre u ocultar por nombre y por firma.A method (both virtual and non-virtual) can be hide-by-name or hide-by-name-and-signature.
Tipo anidadoNested Type NoNo NoNo
Propiedad.Property No es aplicableNot applicable La regla del sistema de tipos comunes es que la herencia es la misma que la de los métodos que implementan la propiedad.The common type system rule is that the inheritance is the same as that of the methods that implement the property. La reflexión trata las propiedades como ocultas por nombre y firma.Reflection treats properties as hide-by-name-and-signature. Vea la nota 2 a continuación.See note 2 below.
  1. Ocultar por nombre y firma tiene en cuenta todas las partes de la firma, incluidos los modificadores personalizados, los tipos de valor devuelto, los tipos de parámetros, los Sentinel y las convenciones de llamada no administradas.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. Esta es una comparación binaria.This is a binary comparison.

  2. En la reflexión, las propiedades y los eventos son Hide-by-Name y Signature.For reflection, properties and events are hide-by-name-and-signature. Si tiene una propiedad con un descriptor de acceso get y set en la clase base, pero la clase derivada solo tiene un descriptor de acceso get, la propiedad de la clase derivada oculta la propiedad de clase base y no podrá tener acceso al establecedor en la clase 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. Los atributos personalizados no forman parte del sistema de tipos comunes.Custom attributes are not part of the common type system.

Se pueden BindingFlags usar las siguientes marcas de filtro para definir las propiedades que se van a incluir en la búsqueda:The following BindingFlags filter flags can be used to define which properties to include in the search:

  • Debe especificar BindingFlags.Instance o BindingFlags.Static para obtener un valor devuelto.You must specify either BindingFlags.Instance or BindingFlags.Static in order to get a return.

  • Especifique BindingFlags.Public que se incluyan las propiedades públicas en la búsqueda.Specify BindingFlags.Public to include public properties in the search.

  • Especifique BindingFlags.NonPublic que se incluyan propiedades no públicas (es decir, propiedades privadas, internas y protegidas) en la búsqueda.Specify BindingFlags.NonPublic to include non-public properties (that is, private, internal, and protected properties) in the search.

  • Especifica BindingFlags.FlattenHierarchy que se public van protected a incluir y miembros estáticos en la jerarquía. private no se incluyen los miembros estáticos de las clases heredadas.Specify BindingFlags.FlattenHierarchy to include public and protected static members up the hierarchy; private static members in inherited classes are not included.

Se pueden BindingFlags usar las siguientes marcas de modificador para cambiar el funcionamiento de la búsqueda:The following BindingFlags modifier flags can be used to change how the search works:

  • BindingFlags.IgnoreCasepara omitir el caso namede.BindingFlags.IgnoreCase to ignore the case of name.

  • BindingFlags.DeclaredOnlypara buscar solo las propiedades declaradas Typeen, no las propiedades que se han heredado simplemente.BindingFlags.DeclaredOnly to search only the properties declared on the Type, not properties that were simply inherited.

Vea System.Reflection.BindingFlags para obtener más información.See System.Reflection.BindingFlags for more information.

Si el actual Type representa un tipo genérico construido, este método PropertyInfo devuelve con los parámetros de tipo reemplazados por los argumentos de tipo adecuados.If the current Type represents a constructed generic type, this method returns the PropertyInfo with the type parameters replaced by the appropriate type arguments.

Si el actual Type representa un parámetro de tipo en la definición de un tipo genérico o de un método genérico, este método busca en las propiedades de la restricción de clase.If the current Type represents a type parameter in the definition of a generic type or generic method, this method searches the properties of the class constraint.

Indexadores y propiedades predeterminadasIndexers and Default Properties

Visual Basic 2005Visual Basic 2005, Visual C# 2005Visual C# 2005 yVisual C++ 2005Visual C++ 2005 tienen una sintaxis simplificada para tener acceso a las propiedades indizadas y permitir que una propiedad indizada sea un valor predeterminado para su tipo., Visual C# 2005Visual C# 2005, and Visual C++ 2005Visual C++ 2005 have simplified syntax for accessing indexed properties and allow one indexed property to be a default for its type. Por ejemplo, si la variable myList hace referencia ArrayLista, la sintaxis myList[3] (myList(3) en Visual Basic) recupera el elemento con el índice 3.For example, if the variable myList refers to an ArrayList, the syntax myList[3] (myList(3) in Visual Basic) retrieves the element with the index of 3. Puede sobrecargar la propiedad.You can overload the property.

En C#, esta característica se denomina indexador y no se puede hacer referencia a ella por su nombre.In C#, this feature is called an indexer and cannot be referred to by name. De forma predeterminada, C# un indexador aparece en los metadatos como una propiedad indizada denominada "Item".By default, a C# indexer appears in metadata as an indexed property named "Item". Sin embargo, un desarrollador de bibliotecas de clases IndexerNameAttribute puede usar el atributo para cambiar el nombre del indizador en los metadatos.However, a class library developer can use the IndexerNameAttribute attribute to change the name of the indexer in the metadata. Por ejemplo, la String clase tiene un indizador denominado Chars[Int32].For example, the String class has an indexer named Chars[Int32]. Las propiedades indexadas creadas con lenguajes C# distintos de también pueden tener nombres distintos de Item.Indexed properties created using languages other than C# can have names other than Item, as well.

Para determinar si un tipo tiene una propiedad predeterminada, utilice el GetCustomAttributes(Type, Boolean) método para probar el DefaultMemberAttribute atributo.To determine whether a type has a default property, use the GetCustomAttributes(Type, Boolean) method to test for the DefaultMemberAttribute attribute. Si el tipo tiene DefaultMemberAttribute, la MemberName propiedad devuelve el nombre de la propiedad predeterminada.If the type has DefaultMemberAttribute, the MemberName property returns the name of the default property.

Consulte también:

Se aplica a