Type.GetProperty Método

Definição

Obtém uma propriedade específica do Type atual.Gets a specific property of the current Type.

Sobrecargas

GetProperty(String)

Pesquisa a propriedade pública com o nome especificado.Searches for the public property with the specified name.

GetProperty(String, BindingFlags)

Pesquisa a propriedade especificada usando as restrições de associação especificadas.Searches for the specified property, using the specified binding constraints.

GetProperty(String, Type)

Pesquisa a propriedade pública com o nome e tipo retornado especificados.Searches for the public property with the specified name and return type.

GetProperty(String, Type[])

Pesquisa a propriedade pública especificada cujos parâmetros correspondem aos tipos de argumento especificados.Searches for the specified public property whose parameters match the specified argument types.

GetProperty(String, Type, Type[])

Pesquisa a propriedade pública especificada cujos parâmetros correspondem aos tipos de argumento especificados.Searches for the specified public property whose parameters match the specified argument types.

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

Pesquisa a propriedade pública especificada cujos parâmetros correspondem aos tipos de argumento e modificadores especificados.Searches for the specified public property whose parameters match the specified argument types and modifiers.

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

Pesquisa a propriedade especificada cujos parâmetros correspondem aos modificadores e tipos de argumento especificados, usando as restrições de associação especificadas.Searches for the specified property whose parameters match the specified argument types and modifiers, using the specified binding constraints.

GetProperty(String)

Pesquisa a propriedade pública com o nome 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

A cadeia de caracteres que contém o nome da propriedade pública a ser obtida.The string containing the name of the public property to get.

Retornos

Um objeto que representa a propriedade pública com o nome especificado, se encontrado; caso contrário, null.An object representing the public property with the specified name, if found; otherwise, null.

Implementações

Exceções

Foi encontrada mais de uma propriedade com o nome especificado.More than one property is found with the specified name.

name é null.name is null.

Exemplos

O exemplo a seguir recupera o objeto Type de uma classe definida pelo usuário, recupera uma propriedade dessa classe e exibe o nome da propriedade.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

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

Internamente, essa propriedade é referenciada nos metadados pelo nome "item".Internally, this property is referred to in the metadata by the name "Item." Qualquer tentativa de obter PropertyInfo usando reflexão deve especificar esse nome interno para retornar corretamente a propriedade PropertyInfo.Any attempt to get PropertyInfo using reflection must specify this internal name in order to correctly return the PropertyInfo property.

Comentários

A pesquisa de name diferencia maiúsculas de minúsculas.The search for name is case-sensitive. A pesquisa inclui propriedades de instância estática pública e pública.The search includes public static and public instance properties.

Uma propriedade é considerada pública para reflexão caso tenha pelo menos um acessador público.A property is considered public to reflection if it has at least one accessor that is public. Caso contrário, a propriedade será considerada privada e você deverá usar | BindingFlags.NonPublic | BindingFlags.Instance BindingFlags.Static (em Visual Basic, combine os valores usando Or) para obtê-lo.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.

Caso o Type atual represente um tipo genérico construído, este método retorna o PropertyInfo com os parâmetros de tipo substituídos pelos argumentos de tipo apropriados.If the current Type represents a constructed generic type, this method returns the PropertyInfo with the type parameters replaced by the appropriate type arguments.

Caso o Type atual represente um parâmetro de tipo na definição de um tipo genérico ou método genérico, este método pesquisa as propriedades da restrição de classe.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.

As situações em que AmbiguousMatchException ocorre incluem o seguinte:Situations in which AmbiguousMatchException occurs include the following:

  • Um tipo contém duas propriedades indexadas que têm o mesmo nome, mas diferentes números de parâmetros.A type contains two indexed properties that have the same name but different numbers of parameters. Para resolver a ambiguidade, use uma sobrecarga do método GetProperty que especifica tipos de parâmetro.To resolve the ambiguity, use an overload of the GetProperty method that specifies parameter types.

  • Um tipo derivado declara uma propriedade que oculta uma propriedade herdada com o mesmo nome, usando o modificador de new (Shadows em 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 a ambiguidade, use a sobrecarga do método GetProperty(String, BindingFlags) e adicione o sinalizador BindingFlags.DeclaredOnly para restringir a pesquisa a membros que não são herdados.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 e propriedades padrãoIndexers and Default Properties

Visual Basic 2005Visual Basic 2005, Visual C# 2005Visual C# 2005e Visual C++ 2005Visual C++ 2005 ter uma sintaxe simplificada para acessar propriedades indexadas e permitir que uma propriedade indexada seja um padrão para seu 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 exemplo, se a variável myList se referir a um ArrayList, a sintaxe myList[3] (myList(3) em Visual Basic) recuperará o elemento com o índice de 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. É possível sobrecarregar a propriedade.You can overload the property.

No C#, esse recurso é chamado de indexador e não pode ser referenciado pelo nome.In C#, this feature is called an indexer and cannot be referred to by name. Por padrão, um C# indexador aparece nos metadados como uma propriedade indexada chamada "item".By default, a C# indexer appears in metadata as an indexed property named "Item". No entanto, um desenvolvedor de biblioteca de classes pode usar o atributo IndexerNameAttribute para alterar o nome do indexador nos metadados.However, a class library developer can use the IndexerNameAttribute attribute to change the name of the indexer in the metadata. Por exemplo, a classe String tem um indexador chamado Chars[Int32].For example, the String class has an indexer named Chars[Int32]. As propriedades indexadas criadas usando-se linguagens diferentes do C# também podem ter nomes diferentes do item.Indexed properties created using languages other than C# can have names other than Item, as well.

Para determinar se um tipo tem uma propriedade padrão, use o método GetCustomAttributes(Type, Boolean) para testar o atributo DefaultMemberAttribute.To determine whether a type has a default property, use the GetCustomAttributes(Type, Boolean) method to test for the DefaultMemberAttribute attribute. Caso o tipo tenha DefaultMemberAttribute, a propriedade MemberName retorna o nome da propriedade padrão.If the type has DefaultMemberAttribute, the MemberName property returns the name of the default property.

Veja também

GetProperty(String, BindingFlags)

Pesquisa a propriedade especificada usando as restrições de associação 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

A cadeia de caracteres que contém o nome da propriedade a ser obtida.The string containing the name of the property to get.

bindingAttr
BindingFlags

Uma combinação bit a bit dos valores de enumeração que especificam como a pesquisa é realizada.A bitwise combination of the enumeration values that specify how the search is conducted.

- ou --or- Default para retornar null.Default to return null.

Retornos

Um objeto que representa a propriedade que corresponde aos requisitos especificados, se for encontrado; caso contrário, null.An object representing the property that matches the specified requirements, if found; otherwise, null.

Implementações

Exceções

É encontrada mais de uma propriedade com o nome especificado e que corresponde às restrições de associação especificadas.More than one property is found with the specified name and matching the specified binding constraints.

name é null.name is null.

Exemplos

O exemplo a seguir recupera o tipo de uma classe definida pelo usuário, recupera uma propriedade dessa classe e exibe o nome da propriedade de acordo com as restrições de associação 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
End Module 'Module1

Comentários

Uma propriedade é considerada pública para reflexão caso tenha pelo menos um acessador público.A property is considered public to reflection if it has at least one accessor that is public. Caso contrário, a propriedade será considerada privada e você deverá usar | BindingFlags.NonPublic | BindingFlags.Instance BindingFlags.Static (em Visual Basic, combine os valores usando Or) para obtê-lo.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.

Os sinalizadores de filtro de BindingFlags a seguir podem ser usados para definir quais propriedades serão incluídas na pesquisa:The following BindingFlags filter flags can be used to define which properties to include in the search:

  • Você deve especificar BindingFlags.Instance ou BindingFlags.Static para obter um retorno.You must specify either BindingFlags.Instance or BindingFlags.Static in order to get a return.

  • Especifique BindingFlags.Public para incluir propriedades públicas na pesquisa.Specify BindingFlags.Public to include public properties in the search.

  • Especifique BindingFlags.NonPublic para incluir propriedades não públicas (ou seja, propriedades particulares, internas e protegidas) na pesquisa.Specify BindingFlags.NonPublic to include non-public properties (that is, private, internal, and protected properties) in the search.

  • Especifique BindingFlags.FlattenHierarchy para incluir os membros estáticos public e protected acima na hierarquia; os membros estáticos private em classes herdadas não são incluídos.Specify BindingFlags.FlattenHierarchy to include public and protected static members up the hierarchy; private static members in inherited classes are not included.

Os seguintes sinalizadores de modificador BindingFlags podem ser usados para alterar como a pesquisa funciona:The following BindingFlags modifier flags can be used to change how the search works:

  • BindingFlags.IgnoreCase ignorar o caso de name.BindingFlags.IgnoreCase to ignore the case of name.

  • BindingFlags.DeclaredOnly Pesquisar somente as propriedades declaradas na Type, não propriedades que são simplesmente herdadas.BindingFlags.DeclaredOnly to search only the properties declared on the Type, not properties that were simply inherited.

Consulte System.Reflection.BindingFlags para obter mais informações.See System.Reflection.BindingFlags for more information.

Caso o Type atual represente um tipo genérico construído, este método retorna o PropertyInfo com os parâmetros de tipo substituídos pelos argumentos de tipo apropriados.If the current Type represents a constructed generic type, this method returns the PropertyInfo with the type parameters replaced by the appropriate type arguments.

Caso o Type atual represente um parâmetro de tipo na definição de um tipo genérico ou método genérico, este método pesquisa as propriedades da restrição de classe.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.

As situações em que AmbiguousMatchException ocorre incluem o seguinte:Situations in which AmbiguousMatchException occurs include the following:

  • Um tipo contém duas propriedades indexadas que têm o mesmo nome, mas diferentes números de parâmetros.A type contains two indexed properties that have the same name but different numbers of parameters. Para resolver a ambiguidade, use uma sobrecarga do método GetProperty que especifica tipos de parâmetro.To resolve the ambiguity, use an overload of the GetProperty method that specifies parameter types.

  • Um tipo derivado declara uma propriedade que oculta uma propriedade herdada com o mesmo nome, usando o modificador de new (Shadows em 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 a ambiguidade, inclua BindingFlags.DeclaredOnly para restringir a pesquisa a membros que não são herdados.To resolve the ambiguity, include BindingFlags.DeclaredOnly to restrict the search to members that are not inherited.

Indexadores e propriedades padrãoIndexers and Default Properties

Visual Basic 2005Visual Basic 2005, Visual C# 2005Visual C# 2005e Visual C++ 2005Visual C++ 2005 ter uma sintaxe simplificada para acessar propriedades indexadas e permitir que uma propriedade indexada seja um padrão para seu 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 exemplo, se a variável myList se referir a um ArrayList, a sintaxe myList[3] (myList(3) em Visual Basic) recuperará o elemento com o índice de 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. É possível sobrecarregar a propriedade.You can overload the property.

No C#, esse recurso é chamado de indexador e não pode ser referenciado pelo nome.In C#, this feature is called an indexer and cannot be referred to by name. Por padrão, um C# indexador aparece nos metadados como uma propriedade indexada chamada "item".By default, a C# indexer appears in metadata as an indexed property named "Item". No entanto, um desenvolvedor de biblioteca de classes pode usar o atributo IndexerNameAttribute para alterar o nome do indexador nos metadados.However, a class library developer can use the IndexerNameAttribute attribute to change the name of the indexer in the metadata. Por exemplo, a classe String tem um indexador chamado Chars[Int32].For example, the String class has an indexer named Chars[Int32]. As propriedades indexadas criadas usando-se linguagens diferentes do C# também podem ter nomes diferentes do item.Indexed properties created using languages other than C# can have names other than Item, as well.

Para determinar se um tipo tem uma propriedade padrão, use o método GetCustomAttributes(Type, Boolean) para testar o atributo DefaultMemberAttribute.To determine whether a type has a default property, use the GetCustomAttributes(Type, Boolean) method to test for the DefaultMemberAttribute attribute. Caso o tipo tenha DefaultMemberAttribute, a propriedade MemberName retorna o nome da propriedade padrão.If the type has DefaultMemberAttribute, the MemberName property returns the name of the default property.

Veja também

GetProperty(String, Type)

Pesquisa a propriedade pública com o nome e tipo retornado especificados.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

A cadeia de caracteres que contém o nome da propriedade pública a ser obtida.The string containing the name of the public property to get.

returnType
Type

O tipo de retorno da propriedade.The return type of the property.

Retornos

Um objeto que representa a propriedade pública com o nome especificado, se encontrado; caso contrário, null.An object representing the public property with the specified name, if found; otherwise, null.

Implementações

Exceções

Foi encontrada mais de uma propriedade com o nome especificado.More than one property is found with the specified name.

O name é null ou o returnType é null.name is null, or returnType is null.

Exemplos

O exemplo a seguir define uma classe com uma propriedade e recupera o nome e o tipo da propriedade.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

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

Comentários

Uma propriedade é considerada pública para reflexão caso tenha pelo menos um acessador público.A property is considered public to reflection if it has at least one accessor that is public. Caso contrário, a propriedade será considerada privada e você deverá usar | BindingFlags.NonPublic | BindingFlags.Instance BindingFlags.Static (em Visual Basic, combine os valores usando Or) para obtê-lo.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.

A pesquisa de name diferencia maiúsculas de minúsculas.The search for name is case-sensitive. A pesquisa inclui propriedades de instância estática pública e pública.The search includes public static and public instance properties.

Caso o Type atual represente um tipo genérico construído, este método retorna o PropertyInfo com os parâmetros de tipo substituídos pelos argumentos de tipo apropriados.If the current Type represents a constructed generic type, this method returns the PropertyInfo with the type parameters replaced by the appropriate type arguments.

Caso o Type atual represente um parâmetro de tipo na definição de um tipo genérico ou método genérico, este método pesquisa as propriedades da restrição de classe.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 e propriedades padrãoIndexers and Default Properties

Visual Basic 2005Visual Basic 2005, Visual C# 2005Visual C# 2005e Visual C++ 2005Visual C++ 2005 ter uma sintaxe simplificada para acessar propriedades indexadas e permitir que uma propriedade indexada seja um padrão para seu 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 exemplo, se a variável myList se referir a um ArrayList, a sintaxe myList[3] (myList(3) em Visual Basic) recuperará o elemento com o índice de 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. É possível sobrecarregar a propriedade.You can overload the property.

No C#, esse recurso é chamado de indexador e não pode ser referenciado pelo nome.In C#, this feature is called an indexer and cannot be referred to by name. Por padrão, um C# indexador aparece nos metadados como uma propriedade indexada chamada "item".By default, a C# indexer appears in metadata as an indexed property named "Item". No entanto, um desenvolvedor de biblioteca de classes pode usar o atributo IndexerNameAttribute para alterar o nome do indexador nos metadados.However, a class library developer can use the IndexerNameAttribute attribute to change the name of the indexer in the metadata. Por exemplo, a classe String tem um indexador chamado Chars[Int32].For example, the String class has an indexer named Chars[Int32]. As propriedades indexadas criadas usando-se linguagens diferentes do C# também podem ter nomes diferentes do item.Indexed properties created using languages other than C# can have names other than Item, as well.

Para determinar se um tipo tem uma propriedade padrão, use o método GetCustomAttributes(Type, Boolean) para testar o atributo DefaultMemberAttribute.To determine whether a type has a default property, use the GetCustomAttributes(Type, Boolean) method to test for the DefaultMemberAttribute attribute. Caso o tipo tenha DefaultMemberAttribute, a propriedade MemberName retorna o nome da propriedade padrão.If the type has DefaultMemberAttribute, the MemberName property returns the name of the default property.

Veja também

GetProperty(String, Type[])

Pesquisa a propriedade pública especificada cujos parâmetros correspondem aos tipos de argumento 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

A cadeia de caracteres que contém o nome da propriedade pública a ser obtida.The string containing the name of the public property to get.

types
Type[]

Uma matriz de objetos Type que representam o número, a ordem e o tipo de parâmetros para a propriedade indexada a ser obtida.An array of Type objects representing the number, order, and type of the parameters for the indexed property to get.

- ou --or- Uma matriz vazia do tipo Type (ou seja, tipos Type[] = novo Type[0]) para obter uma propriedade que não seja indexada.An empty array of the type Type (that is, Type[] types = new Type[0]) to get a property that is not indexed.

Retornos

Um objeto que representa a propriedade pública cujos parâmetros correspondem aos tipos de argumento especificados, se encontrado, caso contrário, null.An object representing the public property whose parameters match the specified argument types, if found; otherwise, null.

Implementações

Exceções

Foi encontrada mais de uma propriedade com o nome especificado e que corresponde aos tipos de argumento especificados.More than one property is found with the specified name and matching the specified argument types.

name é null.name is null.

- ou --or- types é null.types is null.

types é multidimensional.types is multidimensional.

Um elemento de types é null.An element of types is null.

Exemplos

O exemplo a seguir recupera o objeto Type de uma classe definida pelo usuário, recupera a propriedade dessa classe e exibe o nome da propriedade e o tipo da propriedade, conforme especificado pelos argumentos passados para GetProperty.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

    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
End Module 'Module1

Comentários

Uma propriedade é considerada pública para reflexão caso tenha pelo menos um acessador público.A property is considered public to reflection if it has at least one accessor that is public. Caso contrário, a propriedade será considerada privada e você deverá usar | BindingFlags.NonPublic | BindingFlags.Instance BindingFlags.Static (em Visual Basic, combine os valores usando Or) para obtê-lo.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.

A pesquisa de name diferencia maiúsculas de minúsculas.The search for name is case-sensitive. A pesquisa inclui propriedades de instância estática pública e pública.The search includes public static and public instance properties.

Caso o Type atual represente um tipo genérico construído, este método retorna o PropertyInfo com os parâmetros de tipo substituídos pelos argumentos de tipo apropriados.If the current Type represents a constructed generic type, this method returns the PropertyInfo with the type parameters replaced by the appropriate type arguments.

Caso o Type atual represente um parâmetro de tipo na definição de um tipo genérico ou método genérico, este método pesquisa as propriedades da restrição de classe.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 e propriedades padrãoIndexers and Default Properties

Visual Basic 2005Visual Basic 2005, Visual C# 2005Visual C# 2005e Visual C++ 2005Visual C++ 2005 ter uma sintaxe simplificada para acessar propriedades indexadas e permitir que uma propriedade indexada seja um padrão para seu 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 exemplo, se a variável myList se referir a um ArrayList, a sintaxe myList[3] (myList(3) em Visual Basic) recuperará o elemento com o índice de 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. É possível sobrecarregar a propriedade.You can overload the property.

No C#, esse recurso é chamado de indexador e não pode ser referenciado pelo nome.In C#, this feature is called an indexer and cannot be referred to by name. Por padrão, um C# indexador aparece nos metadados como uma propriedade indexada chamada "item".By default, a C# indexer appears in metadata as an indexed property named "Item". No entanto, um desenvolvedor de biblioteca de classes pode usar o atributo IndexerNameAttribute para alterar o nome do indexador nos metadados.However, a class library developer can use the IndexerNameAttribute attribute to change the name of the indexer in the metadata. Por exemplo, a classe String tem um indexador chamado Chars[Int32].For example, the String class has an indexer named Chars[Int32]. As propriedades indexadas criadas usando-se linguagens diferentes do C# também podem ter nomes diferentes do item.Indexed properties created using languages other than C# can have names other than Item, as well.

Para determinar se um tipo tem uma propriedade padrão, use o método GetCustomAttributes(Type, Boolean) para testar o atributo DefaultMemberAttribute.To determine whether a type has a default property, use the GetCustomAttributes(Type, Boolean) method to test for the DefaultMemberAttribute attribute. Caso o tipo tenha DefaultMemberAttribute, a propriedade MemberName retorna o nome da propriedade padrão.If the type has DefaultMemberAttribute, the MemberName property returns the name of the default property.

Veja também

GetProperty(String, Type, Type[])

Pesquisa a propriedade pública especificada cujos parâmetros correspondem aos tipos de argumento 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

A cadeia de caracteres que contém o nome da propriedade pública a ser obtida.The string containing the name of the public property to get.

returnType
Type

O tipo de retorno da propriedade.The return type of the property.

types
Type[]

Uma matriz de objetos Type que representam o número, a ordem e o tipo de parâmetros para a propriedade indexada a ser obtida.An array of Type objects representing the number, order, and type of the parameters for the indexed property to get.

- ou --or- Uma matriz vazia do tipo Type (ou seja, tipos Type[] = novo Type[0]) para obter uma propriedade que não seja indexada.An empty array of the type Type (that is, Type[] types = new Type[0]) to get a property that is not indexed.

Retornos

Um objeto que representa a propriedade pública cujos parâmetros correspondem aos tipos de argumento especificados, se encontrado, caso contrário, null.An object representing the public property whose parameters match the specified argument types, if found; otherwise, null.

Implementações

Exceções

Foi encontrada mais de uma propriedade com o nome especificado e que corresponde aos tipos de argumento especificados.More than one property is found with the specified name and matching the specified argument types.

name é null.name is null.

- ou --or- types é null.types is null.

types é multidimensional.types is multidimensional.

Um elemento de types é null.An element of types is null.

Comentários

Uma propriedade é considerada pública para reflexão caso tenha pelo menos um acessador público.A property is considered public to reflection if it has at least one accessor that is public. Caso contrário, a propriedade será considerada privada e você deverá usar | BindingFlags.NonPublic | BindingFlags.Instance BindingFlags.Static (em Visual Basic, combine os valores usando Or) para obtê-lo.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.

A pesquisa de name diferencia maiúsculas de minúsculas.The search for name is case-sensitive. A pesquisa inclui propriedades de instância estática pública e pública.The search includes public static and public instance properties.

Caso o Type atual represente um tipo genérico construído, este método retorna o PropertyInfo com os parâmetros de tipo substituídos pelos argumentos de tipo apropriados.If the current Type represents a constructed generic type, this method returns the PropertyInfo with the type parameters replaced by the appropriate type arguments.

Caso o Type atual represente um parâmetro de tipo na definição de um tipo genérico ou método genérico, este método pesquisa as propriedades da restrição de classe.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 e propriedades padrãoIndexers and Default Properties

Visual Basic 2005Visual Basic 2005, Visual C# 2005Visual C# 2005e Visual C++ 2005Visual C++ 2005 ter uma sintaxe simplificada para acessar propriedades indexadas e permitir que uma propriedade indexada seja um padrão para seu 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 exemplo, se a variável myList se referir a um ArrayList, a sintaxe myList[3] (myList(3) em Visual Basic) recuperará o elemento com o índice de 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. É possível sobrecarregar a propriedade.You can overload the property.

No C#, esse recurso é chamado de indexador e não pode ser referenciado pelo nome.In C#, this feature is called an indexer and cannot be referred to by name. Por padrão, um C# indexador aparece nos metadados como uma propriedade indexada chamada "item".By default, a C# indexer appears in metadata as an indexed property named "Item". No entanto, um desenvolvedor de biblioteca de classes pode usar o atributo IndexerNameAttribute para alterar o nome do indexador nos metadados.However, a class library developer can use the IndexerNameAttribute attribute to change the name of the indexer in the metadata. Por exemplo, a classe String tem um indexador chamado Chars[Int32].For example, the String class has an indexer named Chars[Int32]. As propriedades indexadas criadas usando-se linguagens diferentes do C# também podem ter nomes diferentes do item.Indexed properties created using languages other than C# can have names other than Item, as well.

Para determinar se um tipo tem uma propriedade padrão, use o método GetCustomAttributes(Type, Boolean) para testar o atributo DefaultMemberAttribute.To determine whether a type has a default property, use the GetCustomAttributes(Type, Boolean) method to test for the DefaultMemberAttribute attribute. Caso o tipo tenha DefaultMemberAttribute, a propriedade MemberName retorna o nome da propriedade padrão.If the type has DefaultMemberAttribute, the MemberName property returns the name of the default property.

Veja também

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

Pesquisa a propriedade pública especificada cujos parâmetros correspondem aos tipos de argumento e modificadores 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

A cadeia de caracteres que contém o nome da propriedade pública a ser obtida.The string containing the name of the public property to get.

returnType
Type

O tipo de retorno da propriedade.The return type of the property.

types
Type[]

Uma matriz de objetos Type que representam o número, a ordem e o tipo de parâmetros para a propriedade indexada a ser obtida.An array of Type objects representing the number, order, and type of the parameters for the indexed property to get.

- ou --or- Uma matriz vazia do tipo Type (ou seja, tipos Type[] = novo Type[0]) para obter uma propriedade que não seja indexada.An empty array of the type Type (that is, Type[] types = new Type[0]) to get a property that is not indexed.

modifiers
ParameterModifier[]

Uma matriz de objetos ParameterModifier que representam os atributos associados ao elemento correspondente na matriz types.An array of ParameterModifier objects representing the attributes associated with the corresponding element in the types array. O associador padrão não processa este parâmetro.The default binder does not process this parameter.

Retornos

Um objeto que representa a propriedade pública que corresponde aos requisitos especificados, se encontrado; caso contrário, null.An object representing the public property that matches the specified requirements, if found; otherwise, null.

Implementações

Exceções

Foi encontrada mais de uma propriedade com o nome especificado e que corresponde aos tipos de argumento e modificadores especificados.More than one property is found with the specified name and matching the specified argument types and modifiers.

name é null.name is null.

- ou --or- types é null.types is null.

types é multidimensional.types is multidimensional.

- ou --or- modifiers é multidimensional.modifiers is multidimensional.

- ou --or- types e modifiers não têm o mesmo tamanho.types and modifiers do not have the same length.

Um elemento de types é null.An element of types is null.

Exemplos

O exemplo a seguir obtém um objeto Type correspondente a MyPropertyClass, e a propriedade indexada dessa classe é recuperada usando os argumentos passados para o método GetProperty.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

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

Comentários

Uma propriedade é considerada pública para reflexão caso tenha pelo menos um acessador público.A property is considered public to reflection if it has at least one accessor that is public. Caso contrário, a propriedade será considerada privada e você deverá usar | BindingFlags.NonPublic | BindingFlags.Instance BindingFlags.Static (em Visual Basic, combine os valores usando Or) para obtê-lo.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.

Embora o associador padrão não processe ParameterModifier (o parâmetro modifiers ), é possível usar a classe abstrata System.Reflection.Binder para gravar um associador personalizado que processa 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. ParameterModifier é usado apenas ao chamar por meio de interoperabilidade COM e apenas parâmetros que são passados por referência são manipulados.ParameterModifier is only used when calling through COM interop, and only parameters that are passed by reference are handled.

A pesquisa de name diferencia maiúsculas de minúsculas.The search for name is case-sensitive. A pesquisa inclui propriedades de instância estática pública e pública.The search includes public static and public instance properties.

Caso o Type atual represente um tipo genérico construído, este método retorna o PropertyInfo com os parâmetros de tipo substituídos pelos argumentos de tipo apropriados.If the current Type represents a constructed generic type, this method returns the PropertyInfo with the type parameters replaced by the appropriate type arguments.

Caso o Type atual represente um parâmetro de tipo na definição de um tipo genérico ou método genérico, este método pesquisa as propriedades da restrição de classe.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 e propriedades padrãoIndexers and Default Properties

Visual Basic 2005Visual Basic 2005, Visual C# 2005Visual C# 2005e Visual C++ 2005Visual C++ 2005 ter uma sintaxe simplificada para acessar propriedades indexadas e permitir que uma propriedade indexada seja um padrão para seu 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 exemplo, se a variável myList se referir a um ArrayList, a sintaxe myList[3] (myList(3) em Visual Basic) recuperará o elemento com o índice de 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. É possível sobrecarregar a propriedade.You can overload the property.

No C#, esse recurso é chamado de indexador e não pode ser referenciado pelo nome.In C#, this feature is called an indexer and cannot be referred to by name. Por padrão, um C# indexador aparece nos metadados como uma propriedade indexada chamada "item".By default, a C# indexer appears in metadata as an indexed property named "Item". No entanto, um desenvolvedor de biblioteca de classes pode usar o atributo IndexerNameAttribute para alterar o nome do indexador nos metadados.However, a class library developer can use the IndexerNameAttribute attribute to change the name of the indexer in the metadata. Por exemplo, a classe String tem um indexador chamado Chars[Int32].For example, the String class has an indexer named Chars[Int32]. As propriedades indexadas criadas usando-se linguagens diferentes do C# também podem ter nomes diferentes do item.Indexed properties created using languages other than C# can have names other than Item, as well.

Para determinar se um tipo tem uma propriedade padrão, use o método GetCustomAttributes(Type, Boolean) para testar o atributo DefaultMemberAttribute.To determine whether a type has a default property, use the GetCustomAttributes(Type, Boolean) method to test for the DefaultMemberAttribute attribute. Caso o tipo tenha DefaultMemberAttribute, a propriedade MemberName retorna o nome da propriedade padrão.If the type has DefaultMemberAttribute, the MemberName property returns the name of the default property.

Veja também

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

Pesquisa a propriedade especificada cujos parâmetros correspondem aos modificadores e tipos de argumento especificados, usando as restrições de associação especificadas.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

A cadeia de caracteres que contém o nome da propriedade a ser obtida.The string containing the name of the property to get.

bindingAttr
BindingFlags

Uma combinação bit a bit dos valores de enumeração que especificam como a pesquisa é realizada.A bitwise combination of the enumeration values that specify how the search is conducted.

- ou --or- Default para retornar null.Default to return null.

binder
Binder

Um objeto que define um conjunto de propriedades e habilita a associação, que pode envolver seleção de um método sobrecarregado, coerção de tipos de argumento e invocação de um membro por meio da reflexão.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.

- ou --or- Uma referência nula (Nothing no Visual Basic), para usar o DefaultBinder.A null reference (Nothing in Visual Basic), to use the DefaultBinder.

returnType
Type

O tipo de retorno da propriedade.The return type of the property.

types
Type[]

Uma matriz de objetos Type que representam o número, a ordem e o tipo de parâmetros para a propriedade indexada a ser obtida.An array of Type objects representing the number, order, and type of the parameters for the indexed property to get.

- ou --or- Uma matriz vazia do tipo Type (ou seja, tipos Type[] = novo Type[0]) para obter uma propriedade que não seja indexada.An empty array of the type Type (that is, Type[] types = new Type[0]) to get a property that is not indexed.

modifiers
ParameterModifier[]

Uma matriz de objetos ParameterModifier que representam os atributos associados ao elemento correspondente na matriz types.An array of ParameterModifier objects representing the attributes associated with the corresponding element in the types array. O associador padrão não processa este parâmetro.The default binder does not process this parameter.

Retornos

Um objeto que representa a propriedade que corresponde aos requisitos especificados, se for encontrado; caso contrário, null.An object representing the property that matches the specified requirements, if found; otherwise, null.

Implementações

Exceções

É encontrada mais de uma propriedade com o nome especificado e que corresponde às restrições de associação especificadas.More than one property is found with the specified name and matching the specified binding constraints.

name é null.name is null.

- ou --or- types é null.types is null.

types é multidimensional.types is multidimensional.

- ou --or- modifiers é multidimensional.modifiers is multidimensional.

- ou --or- types e modifiers não têm o mesmo tamanho.types and modifiers do not have the same length.

Um elemento de types é null.An element of types is null.

Comentários

Uma propriedade é considerada pública para reflexão caso tenha pelo menos um acessador público.A property is considered public to reflection if it has at least one accessor that is public. Caso contrário, a propriedade será considerada privada e você deverá usar | BindingFlags.NonPublic | BindingFlags.Instance BindingFlags.Static (em Visual Basic, combine os valores usando Or) para obtê-lo.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.

Embora o associador padrão não processe ParameterModifier (o parâmetro modifiers ), é possível usar a classe abstrata System.Reflection.Binder para gravar um associador personalizado que processa 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. ParameterModifier é usado apenas ao chamar por meio de interoperabilidade COM e apenas parâmetros que são passados por referência são manipulados.ParameterModifier is only used when calling through COM interop, and only parameters that are passed by reference are handled.

A tabela a seguir mostra quais membros de uma classe base são retornados pelos métodos Get durante a reflexão em um tipo.The following table shows what members of a base class are returned by the Get methods when reflecting on a type.

Tipo do membroMember Type EstáticoStatic Não estáticoNon-Static
ConstrutorConstructor NãoNo NãoNo
CampoField NãoNo Sim.Yes. Um campo permanece sempre oculto por nome e assinatura.A field is always hide-by-name-and-signature.
eventoEvent Não aplicávelNot applicable A regra de sistema do tipo comum é que a herança é a mesma dos métodos que implementam a propriedade.The common type system rule is that the inheritance is the same as that of the methods that implement the property. Reflexão trata propriedades como ocultas por nome e assinatura.Reflection treats properties as hide-by-name-and-signature. Consulte a observação 2 abaixo.See note 2 below.
MétodoMethod NãoNo Sim.Yes. Um método (virtual e não virtual) pode permanecer oculto por nome ou por nome e assinatura.A method (both virtual and non-virtual) can be hide-by-name or hide-by-name-and-signature.
Tipo aninhadoNested Type NãoNo NãoNo
PropriedadeProperty Não aplicávelNot applicable A regra de sistema do tipo comum é que a herança é a mesma dos métodos que implementam a propriedade.The common type system rule is that the inheritance is the same as that of the methods that implement the property. Reflexão trata propriedades como ocultas por nome e assinatura.Reflection treats properties as hide-by-name-and-signature. Consulte a observação 2 abaixo.See note 2 below.
  1. Oculto por nome e assinatura considera todas as partes da assinatura, inclusive modificadores personalizados, tipos de retorno, tipos de parâmetro, sentinelas e convenções de chamada não gerenciadas.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 é uma comparação binária.This is a binary comparison.

  2. Para reflexão, propriedades e eventos permanecem ocultos por nome e assinatura.For reflection, properties and events are hide-by-name-and-signature. Se você tiver uma propriedade com um acessador get e set na classe base, mas a classe derivada tiver apenas um acessador get, a propriedade de classe derivada ocultará a propriedade da classe base e você não poderá acessar o setter na classe base.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. Atributos personalizados não fazem parte do sistema de tipo comum.Custom attributes are not part of the common type system.

Os sinalizadores de filtro de BindingFlags a seguir podem ser usados para definir quais propriedades serão incluídas na pesquisa:The following BindingFlags filter flags can be used to define which properties to include in the search:

  • Você deve especificar BindingFlags.Instance ou BindingFlags.Static para obter um retorno.You must specify either BindingFlags.Instance or BindingFlags.Static in order to get a return.

  • Especifique BindingFlags.Public para incluir propriedades públicas na pesquisa.Specify BindingFlags.Public to include public properties in the search.

  • Especifique BindingFlags.NonPublic para incluir propriedades não públicas (ou seja, propriedades particulares, internas e protegidas) na pesquisa.Specify BindingFlags.NonPublic to include non-public properties (that is, private, internal, and protected properties) in the search.

  • Especifique BindingFlags.FlattenHierarchy para incluir os membros estáticos public e protected acima na hierarquia; os membros estáticos private em classes herdadas não são incluídos.Specify BindingFlags.FlattenHierarchy to include public and protected static members up the hierarchy; private static members in inherited classes are not included.

Os seguintes sinalizadores de modificador BindingFlags podem ser usados para alterar como a pesquisa funciona:The following BindingFlags modifier flags can be used to change how the search works:

  • BindingFlags.IgnoreCase ignorar o caso de name.BindingFlags.IgnoreCase to ignore the case of name.

  • BindingFlags.DeclaredOnly Pesquisar somente as propriedades declaradas na Type, não propriedades que são simplesmente herdadas.BindingFlags.DeclaredOnly to search only the properties declared on the Type, not properties that were simply inherited.

Consulte System.Reflection.BindingFlags para obter mais informações.See System.Reflection.BindingFlags for more information.

Caso o Type atual represente um tipo genérico construído, este método retorna o PropertyInfo com os parâmetros de tipo substituídos pelos argumentos de tipo apropriados.If the current Type represents a constructed generic type, this method returns the PropertyInfo with the type parameters replaced by the appropriate type arguments.

Caso o Type atual represente um parâmetro de tipo na definição de um tipo genérico ou método genérico, este método pesquisa as propriedades da restrição de classe.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 e propriedades padrãoIndexers and Default Properties

Visual Basic 2005Visual Basic 2005, Visual C# 2005Visual C# 2005e Visual C++ 2005Visual C++ 2005 ter uma sintaxe simplificada para acessar propriedades indexadas e permitir que uma propriedade indexada seja um padrão para seu 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 exemplo, se a variável myList se referir a um ArrayList, a sintaxe myList[3] (myList(3) em Visual Basic) recuperará o elemento com o índice de 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. É possível sobrecarregar a propriedade.You can overload the property.

No C#, esse recurso é chamado de indexador e não pode ser referenciado pelo nome.In C#, this feature is called an indexer and cannot be referred to by name. Por padrão, um C# indexador aparece nos metadados como uma propriedade indexada chamada "item".By default, a C# indexer appears in metadata as an indexed property named "Item". No entanto, um desenvolvedor de biblioteca de classes pode usar o atributo IndexerNameAttribute para alterar o nome do indexador nos metadados.However, a class library developer can use the IndexerNameAttribute attribute to change the name of the indexer in the metadata. Por exemplo, a classe String tem um indexador chamado Chars[Int32].For example, the String class has an indexer named Chars[Int32]. As propriedades indexadas criadas usando-se linguagens diferentes do C# também podem ter nomes diferentes do item.Indexed properties created using languages other than C# can have names other than Item, as well.

Para determinar se um tipo tem uma propriedade padrão, use o método GetCustomAttributes(Type, Boolean) para testar o atributo DefaultMemberAttribute.To determine whether a type has a default property, use the GetCustomAttributes(Type, Boolean) method to test for the DefaultMemberAttribute attribute. Caso o tipo tenha DefaultMemberAttribute, a propriedade MemberName retorna o nome da propriedade padrão.If the type has DefaultMemberAttribute, the MemberName property returns the name of the default property.

Veja também

Aplica-se a