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

Definizione

Ottiene una proprietà specifica dell'oggetto Type corrente.Gets a specific property of the current Type.

Overload

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

Cerca la proprietà pubblica con il nome specificato.Searches for the public property with the specified name.

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

Cerca la proprietà specificata, usando i vincoli di binding specificati.Searches for the specified property, using the specified binding constraints.

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

Cerca la proprietà pubblica con il nome e il tipo restituito specificati.Searches for the public property with the specified name and return type.

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

Cerca la proprietà pubblica specificata i cui parametri corrispondono ai tipi di argomenti specificati.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[])

Cerca la proprietà pubblica specificata i cui parametri corrispondono ai tipi di argomenti specificati.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[])

Cerca la proprietà pubblica specificata i cui parametri corrispondono ai tipi di argomenti e ai modificatori specificati.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[])

Cerca la proprietà specificata i cui parametri corrispondono ai tipi di argomenti e ai modificatori specificati, usando i vincoli di binding specificati.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)

Cerca la proprietà pubblica con il nome specificato.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

Parametri

name
String String String String

Stringa che contiene il nome della proprietà pubblica da ottenere.The string containing the name of the public property to get.

Restituisce

Oggetto che rappresenta la proprietà pubblica con il nome specificato, se presente; in caso contrario, null.An object representing the public property with the specified name, if found; otherwise, null.

Implementazioni

Eccezioni

È stata trovata più di una proprietà con il nome specificato.More than one property is found with the specified name.

Esempi

Nell'esempio seguente viene recuperato Type l'oggetto di una classe definita dall'utente, viene recuperata una proprietà di tale classe e viene visualizzato il nome della proprietà.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 'Main
End Class 'MyTypeClass 

Internamente, questa proprietà viene definita nei metadati con il nome "Item".Internally, this property is referred to in the metadata by the name "Item." Qualsiasi tentativo di ottenere PropertyInfo utilizzando la reflection deve specificare questo nome interno per restituire correttamente la PropertyInfo proprietà.Any attempt to get PropertyInfo using reflection must specify this internal name in order to correctly return the PropertyInfo property.

Commenti

La ricerca di name fa distinzione tra maiuscole e minuscole.The search for name is case-sensitive. Nella ricerca sono incluse le proprietà pubbliche e pubbliche dell'istanza.The search includes public static and public instance properties.

Una proprietà viene considerata pubblica per la reflection se dispone di almeno una funzione di accesso pubblica.A property is considered public to reflection if it has at least one accessor that is public. In caso contrario, la proprietà viene considerata privata ed è BindingFlags.NonPublic necessario usare | BindingFlags.Instance | BindingFlags.Static (in Visual Basic combinare i valori Orusando) per ottenerla.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 l'oggetto Type corrente rappresenta un tipo generico costruito, questo metodo restituisce PropertyInfo l'oggetto con i parametri di tipo sostituiti dagli argomenti di tipo appropriati.If the current Type represents a constructed generic type, this method returns the PropertyInfo with the type parameters replaced by the appropriate type arguments.

Se l'oggetto Type corrente rappresenta un parametro di tipo nella definizione di un tipo o di un metodo generico, questo metodo esegue la ricerca delle proprietà del vincolo di 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.

Le situazioni in AmbiguousMatchException cui si verificano sono le seguenti:Situations in which AmbiguousMatchException occurs include the following:

  • Un tipo contiene due proprietà indicizzate che hanno lo stesso nome ma numeri diversi di parametri.A type contains two indexed properties that have the same name but different numbers of parameters. Per risolvere l'ambiguità, usare un overload del metodo GetProperty che specifica i tipi di parametro.To resolve the ambiguity, use an overload of the GetProperty method that specifies parameter types.

  • Un tipo derivato dichiara una proprietà che nasconde una proprietà ereditata con lo stesso nome, usando il new modificatore (Shadows in 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). Per risolvere l'ambiguità, usare l' GetProperty(String, BindingFlags) overload del metodo e aggiungere BindingFlags.DeclaredOnly il flag per limitare la ricerca ai membri che non sono ereditati.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.

Indicizzatori e proprietà predefiniteIndexers and Default Properties

Visual Basic 2005Visual Basic 2005, Visual C# 2005Visual C# 2005 eVisual C++ 2005Visual C++ 2005 hanno una sintassi semplificata per accedere alle proprietà indicizzate e consentire a una proprietà indicizzata di essere un valore predefinito per il relativo 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. Se, ad esempio, la myList variabile fa riferimento ArrayLista un oggetto myList[3] ,myList(3) la sintassi (in Visual Basic) recupera l'elemento con l'indice 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. È possibile eseguire l'overload della proprietà.You can overload the property.

In C#questa funzionalità è denominata indicizzatore e non è possibile farvi riferimento in base al nome.In C#, this feature is called an indexer and cannot be referred to by name. Per impostazione predefinita, C# un indicizzatore viene visualizzato nei metadati come proprietà indicizzata denominata "Item".By default, a C# indexer appears in metadata as an indexed property named "Item". Tuttavia, uno sviluppatore di librerie di classi può IndexerNameAttribute utilizzare l'attributo per modificare il nome dell'indicizzatore nei metadati.However, a class library developer can use the IndexerNameAttribute attribute to change the name of the indexer in the metadata. Ad esempio, la String classe ha un indicizzatore denominato Chars[Int32].For example, the String class has an indexer named Chars[Int32]. Anche le proprietà indicizzate create usando lingue C# diverse da possono avere nomi diversi dall'elemento.Indexed properties created using languages other than C# can have names other than Item, as well.

Per determinare se un tipo ha una proprietà predefinita, usare il GetCustomAttributes(Type, Boolean) metodo per verificare l' DefaultMemberAttribute attributo.To determine whether a type has a default property, use the GetCustomAttributes(Type, Boolean) method to test for the DefaultMemberAttribute attribute. Se il tipo è DefaultMemberAttribute, la MemberName proprietà restituisce il nome della proprietà predefinita.If the type has DefaultMemberAttribute, the MemberName property returns the name of the default property.

Vedi anche

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

Cerca la proprietà specificata, usando i vincoli di binding specificati.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

Parametri

name
String String String String

Stringa contenente il nome della proprietà da ottenere.The string containing the name of the property to get.

bindingAttr
BindingFlags BindingFlags BindingFlags BindingFlags

Combinazione bit per bit di valori di enumerazione che specifica il modo in cui viene eseguita la ricerca.A bitwise combination of the enumeration values that specify how the search is conducted.

In alternativa-or- Default per restituire null.Default to return null.

Restituisce

Oggetto che rappresenta la proprietà corrispondente ai requisiti specificati, se presente; in caso contrario, null.An object representing the property that matches the specified requirements, if found; otherwise, null.

Implementazioni

Eccezioni

È stata trovata più di una proprietà con il nome specificato e corrispondente ai vincoli di associazione specificati.More than one property is found with the specified name and matching the specified binding constraints.

Esempi

Nell'esempio seguente viene recuperato il tipo di una classe definita dall'utente, viene recuperata una proprietà di tale classe e viene visualizzato il nome della proprietà in base ai vincoli di binding specificati.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 'Main
    End Class 'MyClass1
End Module 'Module1

Commenti

Una proprietà viene considerata pubblica per la reflection se dispone di almeno una funzione di accesso pubblica.A property is considered public to reflection if it has at least one accessor that is public. In caso contrario, la proprietà viene considerata privata ed è BindingFlags.NonPublic necessario usare | BindingFlags.Instance | BindingFlags.Static (in Visual Basic combinare i valori Orusando) per ottenerla.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.

È possibile BindingFlags utilizzare i flag di filtro seguenti per definire le proprietà da includere nella ricerca:The following BindingFlags filter flags can be used to define which properties to include in the search:

  • È necessario specificare BindingFlags.Instance o BindingFlags.Static per ottenere un valore restituito.You must specify either BindingFlags.Instance or BindingFlags.Static in order to get a return.

  • Consente BindingFlags.Public di specificare di includere le proprietà pubbliche nella ricerca.Specify BindingFlags.Public to include public properties in the search.

  • Specificare BindingFlags.NonPublic per includere proprietà non pubbliche (proprietà private, interne e protette) nella ricerca.Specify BindingFlags.NonPublic to include non-public properties (that is, private, internal, and protected properties) in the search.

  • Consente BindingFlags.FlattenHierarchy di specificare public la protected gerarchia per includere i membri statici. private i membri statici nelle classi ereditate non sono inclusi.Specify BindingFlags.FlattenHierarchy to include public and protected static members up the hierarchy; private static members in inherited classes are not included.

I flag BindingFlags di modifica seguenti possono essere utilizzati per modificare il funzionamento della ricerca:The following BindingFlags modifier flags can be used to change how the search works:

  • BindingFlags.IgnoreCaseper ignorare la distinzione tra namemaiuscole e minuscole.BindingFlags.IgnoreCase to ignore the case of name.

  • BindingFlags.DeclaredOnlyper eseguire la ricerca solo delle proprietà dichiarate in Type, non delle proprietà ereditate semplicemente.BindingFlags.DeclaredOnly to search only the properties declared on the Type, not properties that were simply inherited.

Per altre informazioni, vedere System.Reflection.BindingFlags.See System.Reflection.BindingFlags for more information.

Se l'oggetto Type corrente rappresenta un tipo generico costruito, questo metodo restituisce PropertyInfo l'oggetto con i parametri di tipo sostituiti dagli argomenti di tipo appropriati.If the current Type represents a constructed generic type, this method returns the PropertyInfo with the type parameters replaced by the appropriate type arguments.

Se l'oggetto Type corrente rappresenta un parametro di tipo nella definizione di un tipo o di un metodo generico, questo metodo esegue la ricerca delle proprietà del vincolo di 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.

Le situazioni in AmbiguousMatchException cui si verificano sono le seguenti:Situations in which AmbiguousMatchException occurs include the following:

  • Un tipo contiene due proprietà indicizzate che hanno lo stesso nome ma numeri diversi di parametri.A type contains two indexed properties that have the same name but different numbers of parameters. Per risolvere l'ambiguità, usare un overload del metodo GetProperty che specifica i tipi di parametro.To resolve the ambiguity, use an overload of the GetProperty method that specifies parameter types.

  • Un tipo derivato dichiara una proprietà che nasconde una proprietà ereditata con lo stesso nome, usando il new modificatore (Shadows in 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). Per risolvere l'ambiguità, includere BindingFlags.DeclaredOnly per limitare la ricerca a membri che non sono ereditati.To resolve the ambiguity, include BindingFlags.DeclaredOnly to restrict the search to members that are not inherited.

Indicizzatori e proprietà predefiniteIndexers and Default Properties

Visual Basic 2005Visual Basic 2005, Visual C# 2005Visual C# 2005 eVisual C++ 2005Visual C++ 2005 hanno una sintassi semplificata per accedere alle proprietà indicizzate e consentire a una proprietà indicizzata di essere un valore predefinito per il relativo 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. Se, ad esempio, la myList variabile fa riferimento ArrayLista un oggetto myList[3] ,myList(3) la sintassi (in Visual Basic) recupera l'elemento con l'indice 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. È possibile eseguire l'overload della proprietà.You can overload the property.

In C#questa funzionalità è denominata indicizzatore e non è possibile farvi riferimento in base al nome.In C#, this feature is called an indexer and cannot be referred to by name. Per impostazione predefinita, C# un indicizzatore viene visualizzato nei metadati come proprietà indicizzata denominata "Item".By default, a C# indexer appears in metadata as an indexed property named "Item". Tuttavia, uno sviluppatore di librerie di classi può IndexerNameAttribute utilizzare l'attributo per modificare il nome dell'indicizzatore nei metadati.However, a class library developer can use the IndexerNameAttribute attribute to change the name of the indexer in the metadata. Ad esempio, la String classe ha un indicizzatore denominato Chars[Int32].For example, the String class has an indexer named Chars[Int32]. Anche le proprietà indicizzate create usando lingue C# diverse da possono avere nomi diversi dall'elemento.Indexed properties created using languages other than C# can have names other than Item, as well.

Per determinare se un tipo ha una proprietà predefinita, usare il GetCustomAttributes(Type, Boolean) metodo per verificare l' DefaultMemberAttribute attributo.To determine whether a type has a default property, use the GetCustomAttributes(Type, Boolean) method to test for the DefaultMemberAttribute attribute. Se il tipo è DefaultMemberAttribute, la MemberName proprietà restituisce il nome della proprietà predefinita.If the type has DefaultMemberAttribute, the MemberName property returns the name of the default property.

Vedi anche

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

Cerca la proprietà pubblica con il nome e il tipo restituito specificati.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

Parametri

name
String String String String

Stringa che contiene il nome della proprietà pubblica da ottenere.The string containing the name of the public property to get.

returnType
Type Type Type Type

Tipo restituito della proprietà.The return type of the property.

Restituisce

Oggetto che rappresenta la proprietà pubblica con il nome specificato, se presente; in caso contrario, null.An object representing the public property with the specified name, if found; otherwise, null.

Implementazioni

Eccezioni

È stata trovata più di una proprietà con il nome specificato.More than one property is found with the specified name.

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

Esempi

Nell'esempio seguente viene definita una classe con una proprietà e vengono recuperati il nome e il tipo della proprietà.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 'Main
End Class 'TestClass

Commenti

Una proprietà viene considerata pubblica per la reflection se dispone di almeno una funzione di accesso pubblica.A property is considered public to reflection if it has at least one accessor that is public. In caso contrario, la proprietà viene considerata privata ed è BindingFlags.NonPublic necessario usare | BindingFlags.Instance | BindingFlags.Static (in Visual Basic combinare i valori Orusando) per ottenerla.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 ricerca di name fa distinzione tra maiuscole e minuscole.The search for name is case-sensitive. Nella ricerca sono incluse le proprietà pubbliche e pubbliche dell'istanza.The search includes public static and public instance properties.

Se l'oggetto Type corrente rappresenta un tipo generico costruito, questo metodo restituisce PropertyInfo l'oggetto con i parametri di tipo sostituiti dagli argomenti di tipo appropriati.If the current Type represents a constructed generic type, this method returns the PropertyInfo with the type parameters replaced by the appropriate type arguments.

Se l'oggetto Type corrente rappresenta un parametro di tipo nella definizione di un tipo o di un metodo generico, questo metodo esegue la ricerca delle proprietà del vincolo di 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.

Indicizzatori e proprietà predefiniteIndexers and Default Properties

Visual Basic 2005Visual Basic 2005, Visual C# 2005Visual C# 2005 eVisual C++ 2005Visual C++ 2005 hanno una sintassi semplificata per accedere alle proprietà indicizzate e consentire a una proprietà indicizzata di essere un valore predefinito per il relativo 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. Se, ad esempio, la myList variabile fa riferimento ArrayLista un oggetto myList[3] ,myList(3) la sintassi (in Visual Basic) recupera l'elemento con l'indice 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. È possibile eseguire l'overload della proprietà.You can overload the property.

In C#questa funzionalità è denominata indicizzatore e non è possibile farvi riferimento in base al nome.In C#, this feature is called an indexer and cannot be referred to by name. Per impostazione predefinita, C# un indicizzatore viene visualizzato nei metadati come proprietà indicizzata denominata "Item".By default, a C# indexer appears in metadata as an indexed property named "Item". Tuttavia, uno sviluppatore di librerie di classi può IndexerNameAttribute utilizzare l'attributo per modificare il nome dell'indicizzatore nei metadati.However, a class library developer can use the IndexerNameAttribute attribute to change the name of the indexer in the metadata. Ad esempio, la String classe ha un indicizzatore denominato Chars[Int32].For example, the String class has an indexer named Chars[Int32]. Anche le proprietà indicizzate create usando lingue C# diverse da possono avere nomi diversi dall'elemento.Indexed properties created using languages other than C# can have names other than Item, as well.

Per determinare se un tipo ha una proprietà predefinita, usare il GetCustomAttributes(Type, Boolean) metodo per verificare l' DefaultMemberAttribute attributo.To determine whether a type has a default property, use the GetCustomAttributes(Type, Boolean) method to test for the DefaultMemberAttribute attribute. Se il tipo è DefaultMemberAttribute, la MemberName proprietà restituisce il nome della proprietà predefinita.If the type has DefaultMemberAttribute, the MemberName property returns the name of the default property.

Vedi anche

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

Cerca la proprietà pubblica specificata i cui parametri corrispondono ai tipi di argomenti specificati.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

Parametri

name
String String String String

Stringa che contiene il nome della proprietà pubblica da ottenere.The string containing the name of the public property to get.

types
Type[]

Matrice di oggetti Type che rappresentano numero, ordine e tipo dei parametri relativi alla proprietà indicizzata da ottenere.An array of Type objects representing the number, order, and type of the parameters for the indexed property to get.

-oppure--or- Matrice vuota di tipo Type (ovvero, Type[] types = new Type[0]) per ottenere una proprietà non indicizzata.An empty array of the type Type (that is, Type[] types = new Type[0]) to get a property that is not indexed.

Restituisce

Oggetto che rappresenta la proprietà pubblica i cui parametri corrispondono ai tipi di argomenti specificati, se presente; in caso contrario, null.An object representing the public property whose parameters match the specified argument types, if found; otherwise, null.

Implementazioni

Eccezioni

È stata trovata più di una proprietà con il nome specificato e corrispondente ai tipi di argomento specificati.More than one property is found with the specified name and matching the specified argument types.

name è null.name is null.

In alternativa-or- types è null.types is null.

types è multidimensionale.types is multidimensional.

Un elemento di types è null.An element of types is null.

Esempi

Nell'esempio seguente viene recuperato Type l'oggetto di una classe definita dall'utente, viene recuperata la proprietà della classe e vengono visualizzati il nome e il tipo della proprietà come specificato dagli argomenti passati a 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 '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 'Main
    End Class 'MyTypeClass
End Module 'Module1

Commenti

Una proprietà viene considerata pubblica per la reflection se dispone di almeno una funzione di accesso pubblica.A property is considered public to reflection if it has at least one accessor that is public. In caso contrario, la proprietà viene considerata privata ed è BindingFlags.NonPublic necessario usare | BindingFlags.Instance | BindingFlags.Static (in Visual Basic combinare i valori Orusando) per ottenerla.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 ricerca di name fa distinzione tra maiuscole e minuscole.The search for name is case-sensitive. Nella ricerca sono incluse le proprietà pubbliche e pubbliche dell'istanza.The search includes public static and public instance properties.

Se l'oggetto Type corrente rappresenta un tipo generico costruito, questo metodo restituisce PropertyInfo l'oggetto con i parametri di tipo sostituiti dagli argomenti di tipo appropriati.If the current Type represents a constructed generic type, this method returns the PropertyInfo with the type parameters replaced by the appropriate type arguments.

Se l'oggetto Type corrente rappresenta un parametro di tipo nella definizione di un tipo o di un metodo generico, questo metodo esegue la ricerca delle proprietà del vincolo di 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.

Indicizzatori e proprietà predefiniteIndexers and Default Properties

Visual Basic 2005Visual Basic 2005, Visual C# 2005Visual C# 2005 eVisual C++ 2005Visual C++ 2005 hanno una sintassi semplificata per accedere alle proprietà indicizzate e consentire a una proprietà indicizzata di essere un valore predefinito per il relativo 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. Se, ad esempio, la myList variabile fa riferimento ArrayLista un oggetto myList[3] ,myList(3) la sintassi (in Visual Basic) recupera l'elemento con l'indice 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. È possibile eseguire l'overload della proprietà.You can overload the property.

In C#questa funzionalità è denominata indicizzatore e non è possibile farvi riferimento in base al nome.In C#, this feature is called an indexer and cannot be referred to by name. Per impostazione predefinita, C# un indicizzatore viene visualizzato nei metadati come proprietà indicizzata denominata "Item".By default, a C# indexer appears in metadata as an indexed property named "Item". Tuttavia, uno sviluppatore di librerie di classi può IndexerNameAttribute utilizzare l'attributo per modificare il nome dell'indicizzatore nei metadati.However, a class library developer can use the IndexerNameAttribute attribute to change the name of the indexer in the metadata. Ad esempio, la String classe ha un indicizzatore denominato Chars[Int32].For example, the String class has an indexer named Chars[Int32]. Anche le proprietà indicizzate create usando lingue C# diverse da possono avere nomi diversi dall'elemento.Indexed properties created using languages other than C# can have names other than Item, as well.

Per determinare se un tipo ha una proprietà predefinita, usare il GetCustomAttributes(Type, Boolean) metodo per verificare l' DefaultMemberAttribute attributo.To determine whether a type has a default property, use the GetCustomAttributes(Type, Boolean) method to test for the DefaultMemberAttribute attribute. Se il tipo è DefaultMemberAttribute, la MemberName proprietà restituisce il nome della proprietà predefinita.If the type has DefaultMemberAttribute, the MemberName property returns the name of the default property.

Vedi anche

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

Cerca la proprietà pubblica specificata i cui parametri corrispondono ai tipi di argomenti specificati.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

Parametri

name
String String String String

Stringa che contiene il nome della proprietà pubblica da ottenere.The string containing the name of the public property to get.

returnType
Type Type Type Type

Tipo restituito della proprietà.The return type of the property.

types
Type[]

Matrice di oggetti Type che rappresentano numero, ordine e tipo dei parametri relativi alla proprietà indicizzata da ottenere.An array of Type objects representing the number, order, and type of the parameters for the indexed property to get.

In alternativa-or- Matrice vuota di tipo Type (ovvero, Type[] types = new Type[0]) per ottenere una proprietà non indicizzata.An empty array of the type Type (that is, Type[] types = new Type[0]) to get a property that is not indexed.

Restituisce

Oggetto che rappresenta la proprietà pubblica i cui parametri corrispondono ai tipi di argomenti specificati, se presente; in caso contrario, null.An object representing the public property whose parameters match the specified argument types, if found; otherwise, null.

Implementazioni

Eccezioni

È stata trovata più di una proprietà con il nome specificato e corrispondente ai tipi di argomento specificati.More than one property is found with the specified name and matching the specified argument types.

name è null.name is null.

-oppure--or- types è null.types is null.

types è multidimensionale.types is multidimensional.

Un elemento di types è null.An element of types is null.

Commenti

Una proprietà viene considerata pubblica per la reflection se dispone di almeno una funzione di accesso pubblica.A property is considered public to reflection if it has at least one accessor that is public. In caso contrario, la proprietà viene considerata privata ed è BindingFlags.NonPublic necessario usare | BindingFlags.Instance | BindingFlags.Static (in Visual Basic combinare i valori Orusando) per ottenerla.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 ricerca di name fa distinzione tra maiuscole e minuscole.The search for name is case-sensitive. Nella ricerca sono incluse le proprietà pubbliche e pubbliche dell'istanza.The search includes public static and public instance properties.

Se l'oggetto Type corrente rappresenta un tipo generico costruito, questo metodo restituisce PropertyInfo l'oggetto con i parametri di tipo sostituiti dagli argomenti di tipo appropriati.If the current Type represents a constructed generic type, this method returns the PropertyInfo with the type parameters replaced by the appropriate type arguments.

Se l'oggetto Type corrente rappresenta un parametro di tipo nella definizione di un tipo o di un metodo generico, questo metodo esegue la ricerca delle proprietà del vincolo di 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.

Indicizzatori e proprietà predefiniteIndexers and Default Properties

Visual Basic 2005Visual Basic 2005, Visual C# 2005Visual C# 2005 eVisual C++ 2005Visual C++ 2005 hanno una sintassi semplificata per accedere alle proprietà indicizzate e consentire a una proprietà indicizzata di essere un valore predefinito per il relativo 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. Se, ad esempio, la myList variabile fa riferimento ArrayLista un oggetto myList[3] ,myList(3) la sintassi (in Visual Basic) recupera l'elemento con l'indice 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. È possibile eseguire l'overload della proprietà.You can overload the property.

In C#questa funzionalità è denominata indicizzatore e non è possibile farvi riferimento in base al nome.In C#, this feature is called an indexer and cannot be referred to by name. Per impostazione predefinita, C# un indicizzatore viene visualizzato nei metadati come proprietà indicizzata denominata "Item".By default, a C# indexer appears in metadata as an indexed property named "Item". Tuttavia, uno sviluppatore di librerie di classi può IndexerNameAttribute utilizzare l'attributo per modificare il nome dell'indicizzatore nei metadati.However, a class library developer can use the IndexerNameAttribute attribute to change the name of the indexer in the metadata. Ad esempio, la String classe ha un indicizzatore denominato Chars[Int32].For example, the String class has an indexer named Chars[Int32]. Anche le proprietà indicizzate create usando lingue C# diverse da possono avere nomi diversi dall'elemento.Indexed properties created using languages other than C# can have names other than Item, as well.

Per determinare se un tipo ha una proprietà predefinita, usare il GetCustomAttributes(Type, Boolean) metodo per verificare l' DefaultMemberAttribute attributo.To determine whether a type has a default property, use the GetCustomAttributes(Type, Boolean) method to test for the DefaultMemberAttribute attribute. Se il tipo è DefaultMemberAttribute, la MemberName proprietà restituisce il nome della proprietà predefinita.If the type has DefaultMemberAttribute, the MemberName property returns the name of the default property.

Vedi anche

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

Cerca la proprietà pubblica specificata i cui parametri corrispondono ai tipi di argomenti e ai modificatori specificati.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

Parametri

name
String String String String

Stringa che contiene il nome della proprietà pubblica da ottenere.The string containing the name of the public property to get.

returnType
Type Type Type Type

Tipo restituito della proprietà.The return type of the property.

types
Type[]

Matrice di oggetti Type che rappresentano numero, ordine e tipo dei parametri relativi alla proprietà indicizzata da ottenere.An array of Type objects representing the number, order, and type of the parameters for the indexed property to get.

-oppure--or- Matrice vuota di tipo Type (ovvero, Type[] types = new Type[0]) per ottenere una proprietà non indicizzata.An empty array of the type Type (that is, Type[] types = new Type[0]) to get a property that is not indexed.

modifiers
ParameterModifier[]

Matrice di oggetti ParameterModifier che rappresentano gli attributi associati all'elemento corrispondente nella matrice types.An array of ParameterModifier objects representing the attributes associated with the corresponding element in the types array. Questo parametro non viene elaborato dal binder predefinito.The default binder does not process this parameter.

Restituisce

Oggetto che rappresenta la proprietà pubblica corrispondente ai requisiti specificati, se è stato trovato; in caso contrario, null.An object representing the public property that matches the specified requirements, if found; otherwise, null.

Implementazioni

Eccezioni

È stata trovata più di una proprietà con il nome specificato e corrispondente ai tipi di argomento e modificatori specificati.More than one property is found with the specified name and matching the specified argument types and modifiers.

name è null.name is null.

-oppure--or- types è null.types is null.

types è multidimensionale.types is multidimensional.

In alternativa-or- modifiers è multidimensionale.modifiers is multidimensional.

-oppure--or- types e modifiers non hanno la stessa lunghezza.types and modifiers do not have the same length.

Un elemento di types è null.An element of types is null.

Esempi

Nell'esempio seguente viene ottenuto un Type oggetto corrispondente a MyPropertyClasse la proprietà indicizzata di questa classe viene recuperata utilizzando GetProperty gli argomenti passati al metodo.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 'Main
End Class 'MyTypeClass

Commenti

Una proprietà viene considerata pubblica per la reflection se dispone di almeno una funzione di accesso pubblica.A property is considered public to reflection if it has at least one accessor that is public. In caso contrario, la proprietà viene considerata privata ed è BindingFlags.NonPublic necessario usare | BindingFlags.Instance | BindingFlags.Static (in Visual Basic combinare i valori Orusando) per ottenerla.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.

Sebbene il Binder ParameterModifier predefinito non elabori (il modifiers parametro), è possibile usare la classe astratta System.Reflection.Binder per scrivere un gestore di associazione personalizzato che esegue modifiersl'elaborazione.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. ParameterModifierviene utilizzato solo quando si effettua una chiamata tramite l'interoperabilità COM e vengono gestiti solo i parametri passati per riferimento.ParameterModifier is only used when calling through COM interop, and only parameters that are passed by reference are handled.

La ricerca di name fa distinzione tra maiuscole e minuscole.The search for name is case-sensitive. Nella ricerca sono incluse le proprietà pubbliche e pubbliche dell'istanza.The search includes public static and public instance properties.

Se l'oggetto Type corrente rappresenta un tipo generico costruito, questo metodo restituisce PropertyInfo l'oggetto con i parametri di tipo sostituiti dagli argomenti di tipo appropriati.If the current Type represents a constructed generic type, this method returns the PropertyInfo with the type parameters replaced by the appropriate type arguments.

Se l'oggetto Type corrente rappresenta un parametro di tipo nella definizione di un tipo o di un metodo generico, questo metodo esegue la ricerca delle proprietà del vincolo di 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.

Indicizzatori e proprietà predefiniteIndexers and Default Properties

Visual Basic 2005Visual Basic 2005, Visual C# 2005Visual C# 2005 eVisual C++ 2005Visual C++ 2005 hanno una sintassi semplificata per accedere alle proprietà indicizzate e consentire a una proprietà indicizzata di essere un valore predefinito per il relativo 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. Se, ad esempio, la myList variabile fa riferimento ArrayLista un oggetto myList[3] ,myList(3) la sintassi (in Visual Basic) recupera l'elemento con l'indice 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. È possibile eseguire l'overload della proprietà.You can overload the property.

In C#questa funzionalità è denominata indicizzatore e non è possibile farvi riferimento in base al nome.In C#, this feature is called an indexer and cannot be referred to by name. Per impostazione predefinita, C# un indicizzatore viene visualizzato nei metadati come proprietà indicizzata denominata "Item".By default, a C# indexer appears in metadata as an indexed property named "Item". Tuttavia, uno sviluppatore di librerie di classi può IndexerNameAttribute utilizzare l'attributo per modificare il nome dell'indicizzatore nei metadati.However, a class library developer can use the IndexerNameAttribute attribute to change the name of the indexer in the metadata. Ad esempio, la String classe ha un indicizzatore denominato Chars[Int32].For example, the String class has an indexer named Chars[Int32]. Anche le proprietà indicizzate create usando lingue C# diverse da possono avere nomi diversi dall'elemento.Indexed properties created using languages other than C# can have names other than Item, as well.

Per determinare se un tipo ha una proprietà predefinita, usare il GetCustomAttributes(Type, Boolean) metodo per verificare l' DefaultMemberAttribute attributo.To determine whether a type has a default property, use the GetCustomAttributes(Type, Boolean) method to test for the DefaultMemberAttribute attribute. Se il tipo è DefaultMemberAttribute, la MemberName proprietà restituisce il nome della proprietà predefinita.If the type has DefaultMemberAttribute, the MemberName property returns the name of the default property.

Vedi anche

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

Cerca la proprietà specificata i cui parametri corrispondono ai tipi di argomenti e ai modificatori specificati, usando i vincoli di binding specificati.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

Parametri

name
String String String String

Stringa contenente il nome della proprietà da ottenere.The string containing the name of the property to get.

bindingAttr
BindingFlags BindingFlags BindingFlags BindingFlags

Combinazione bit per bit di valori di enumerazione che specifica il modo in cui viene eseguita la ricerca.A bitwise combination of the enumeration values that specify how the search is conducted.

In alternativa-or- Default per restituire null.Default to return null.

binder
Binder Binder Binder Binder

Oggetto che definisce una serie di proprietà e permette il binding, che può implicare la scelta di un metodo di overload, la coercizione di tipi di argomento e la chiamata di un membro mediante reflection.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.

In alternativa-or- Riferimento Null (Nothing in Visual Basic) per l'uso di DefaultBinder.A null reference (Nothing in Visual Basic), to use the DefaultBinder.

returnType
Type Type Type Type

Tipo restituito della proprietà.The return type of the property.

types
Type[]

Matrice di oggetti Type che rappresentano numero, ordine e tipo dei parametri relativi alla proprietà indicizzata da ottenere.An array of Type objects representing the number, order, and type of the parameters for the indexed property to get.

-oppure--or- Matrice vuota di tipo Type (ovvero, Type[] types = new Type[0]) per ottenere una proprietà non indicizzata.An empty array of the type Type (that is, Type[] types = new Type[0]) to get a property that is not indexed.

modifiers
ParameterModifier[]

Matrice di oggetti ParameterModifier che rappresentano gli attributi associati all'elemento corrispondente nella matrice types.An array of ParameterModifier objects representing the attributes associated with the corresponding element in the types array. Questo parametro non viene elaborato dal binder predefinito.The default binder does not process this parameter.

Restituisce

Oggetto che rappresenta la proprietà corrispondente ai requisiti specificati, se presente; in caso contrario, null.An object representing the property that matches the specified requirements, if found; otherwise, null.

Implementazioni

Eccezioni

È stata trovata più di una proprietà con il nome specificato e corrispondente ai vincoli di associazione specificati.More than one property is found with the specified name and matching the specified binding constraints.

name è null.name is null.

-oppure--or- types è null.types is null.

types è multidimensionale.types is multidimensional.

-oppure--or- modifiers è multidimensionale.modifiers is multidimensional.

In alternativa-or- types e modifiers non hanno la stessa lunghezza.types and modifiers do not have the same length.

Un elemento di types è null.An element of types is null.

Commenti

Una proprietà viene considerata pubblica per la reflection se dispone di almeno una funzione di accesso pubblica.A property is considered public to reflection if it has at least one accessor that is public. In caso contrario, la proprietà viene considerata privata ed è BindingFlags.NonPublic necessario usare | BindingFlags.Instance | BindingFlags.Static (in Visual Basic combinare i valori Orusando) per ottenerla.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.

Sebbene il Binder ParameterModifier predefinito non elabori (il modifiers parametro), è possibile usare la classe astratta System.Reflection.Binder per scrivere un gestore di associazione personalizzato che esegue modifiersl'elaborazione.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. ParameterModifierviene utilizzato solo quando si effettua una chiamata tramite l'interoperabilità COM e vengono gestiti solo i parametri passati per riferimento.ParameterModifier is only used when calling through COM interop, and only parameters that are passed by reference are handled.

La tabella seguente mostra quali membri di una classe di base vengono restituiti dai Get metodi durante la reflection su un tipo.The following table shows what members of a base class are returned by the Get methods when reflecting on a type.

Tipo di membroMember Type StaticStatic Non staticoNon-Static
CostruttoreConstructor NoNo NoNo
CampoField NoNo Sì.Yes. Un campo è sempre nascosto per nome e firma.A field is always hide-by-name-and-signature.
eventEvent Non applicabileNot applicable La regola Common Type System è che l'ereditarietà è identica a quella dei metodi che implementano la proprietà.The common type system rule is that the inheritance is the same as that of the methods that implement the property. La reflection considera le proprietà come nascoste per nome e firma.Reflection treats properties as hide-by-name-and-signature. Vedere la nota 2 di seguito.See note 2 below.
MetodoMethod NoNo Sì.Yes. Un metodo (sia virtuale che non virtuale) può essere nascosto in base al nome o nascosto per nome e firma.A method (both virtual and non-virtual) can be hide-by-name or hide-by-name-and-signature.
Tipo annidatoNested Type NoNo NoNo
ProprietàProperty Non applicabileNot applicable La regola Common Type System è che l'ereditarietà è identica a quella dei metodi che implementano la proprietà.The common type system rule is that the inheritance is the same as that of the methods that implement the property. La reflection considera le proprietà come nascoste per nome e firma.Reflection treats properties as hide-by-name-and-signature. Vedere la nota 2 di seguito.See note 2 below.
  1. Hide-by-Name-and-signature prende in considerazione tutte le parti della firma, inclusi i modificatori personalizzati, i tipi restituiti, i tipi di parametro, le sentinelle e le convenzioni di chiamata non gestite.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. Si tratta di un confronto binario.This is a binary comparison.

  2. Per la reflection, le proprietà e gli eventi sono nascosti per nome e firma.For reflection, properties and events are hide-by-name-and-signature. Se si dispone di una proprietà con una funzione di accesso get e set nella classe di base, ma la classe derivata dispone solo di una funzione di accesso get, la proprietà della classe derivata nasconde la proprietà della classe base e non sarà possibile accedere al setter sulla classe di 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. Gli attributi personalizzati non fanno parte del Common Type System.Custom attributes are not part of the common type system.

È possibile BindingFlags utilizzare i flag di filtro seguenti per definire le proprietà da includere nella ricerca:The following BindingFlags filter flags can be used to define which properties to include in the search:

  • È necessario specificare BindingFlags.Instance o BindingFlags.Static per ottenere un valore restituito.You must specify either BindingFlags.Instance or BindingFlags.Static in order to get a return.

  • Consente BindingFlags.Public di specificare di includere le proprietà pubbliche nella ricerca.Specify BindingFlags.Public to include public properties in the search.

  • Specificare BindingFlags.NonPublic per includere proprietà non pubbliche (proprietà private, interne e protette) nella ricerca.Specify BindingFlags.NonPublic to include non-public properties (that is, private, internal, and protected properties) in the search.

  • Consente BindingFlags.FlattenHierarchy di specificare public la protected gerarchia per includere i membri statici. private i membri statici nelle classi ereditate non sono inclusi.Specify BindingFlags.FlattenHierarchy to include public and protected static members up the hierarchy; private static members in inherited classes are not included.

I flag BindingFlags di modifica seguenti possono essere utilizzati per modificare il funzionamento della ricerca:The following BindingFlags modifier flags can be used to change how the search works:

  • BindingFlags.IgnoreCaseper ignorare la distinzione tra namemaiuscole e minuscole.BindingFlags.IgnoreCase to ignore the case of name.

  • BindingFlags.DeclaredOnlyper eseguire la ricerca solo delle proprietà dichiarate in Type, non delle proprietà ereditate semplicemente.BindingFlags.DeclaredOnly to search only the properties declared on the Type, not properties that were simply inherited.

Per altre informazioni, vedere System.Reflection.BindingFlags.See System.Reflection.BindingFlags for more information.

Se l'oggetto Type corrente rappresenta un tipo generico costruito, questo metodo restituisce PropertyInfo l'oggetto con i parametri di tipo sostituiti dagli argomenti di tipo appropriati.If the current Type represents a constructed generic type, this method returns the PropertyInfo with the type parameters replaced by the appropriate type arguments.

Se l'oggetto Type corrente rappresenta un parametro di tipo nella definizione di un tipo o di un metodo generico, questo metodo esegue la ricerca delle proprietà del vincolo di 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.

Indicizzatori e proprietà predefiniteIndexers and Default Properties

Visual Basic 2005Visual Basic 2005, Visual C# 2005Visual C# 2005 eVisual C++ 2005Visual C++ 2005 hanno una sintassi semplificata per accedere alle proprietà indicizzate e consentire a una proprietà indicizzata di essere un valore predefinito per il relativo 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. Se, ad esempio, la myList variabile fa riferimento ArrayLista un oggetto myList[3] ,myList(3) la sintassi (in Visual Basic) recupera l'elemento con l'indice 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. È possibile eseguire l'overload della proprietà.You can overload the property.

In C#questa funzionalità è denominata indicizzatore e non è possibile farvi riferimento in base al nome.In C#, this feature is called an indexer and cannot be referred to by name. Per impostazione predefinita, C# un indicizzatore viene visualizzato nei metadati come proprietà indicizzata denominata "Item".By default, a C# indexer appears in metadata as an indexed property named "Item". Tuttavia, uno sviluppatore di librerie di classi può IndexerNameAttribute utilizzare l'attributo per modificare il nome dell'indicizzatore nei metadati.However, a class library developer can use the IndexerNameAttribute attribute to change the name of the indexer in the metadata. Ad esempio, la String classe ha un indicizzatore denominato Chars[Int32].For example, the String class has an indexer named Chars[Int32]. Anche le proprietà indicizzate create usando lingue C# diverse da possono avere nomi diversi dall'elemento.Indexed properties created using languages other than C# can have names other than Item, as well.

Per determinare se un tipo ha una proprietà predefinita, usare il GetCustomAttributes(Type, Boolean) metodo per verificare l' DefaultMemberAttribute attributo.To determine whether a type has a default property, use the GetCustomAttributes(Type, Boolean) method to test for the DefaultMemberAttribute attribute. Se il tipo è DefaultMemberAttribute, la MemberName proprietà restituisce il nome della proprietà predefinita.If the type has DefaultMemberAttribute, the MemberName property returns the name of the default property.

Vedi anche

Si applica a