Metodo Type.GetPropertyImpl
Aggiornamento: novembre 2007
Quando viene sottoposto a override in una classe derivata, cerca la proprietà specificata i cui parametri corrispondono ai modificatori e ai tipi di argomenti definiti, utilizzando i vincoli di associazione specificati.
Assembly: mscorlib (in mscorlib.dll)
protected abstract PropertyInfo GetPropertyImpl( string name, BindingFlags bindingAttr, Binder binder, Type returnType, Type[] types, ParameterModifier[] modifiers )
protected abstract PropertyInfo GetPropertyImpl( String name, BindingFlags bindingAttr, Binder binder, Type returnType, Type[] types, ParameterModifier[] modifiers )
protected abstract function GetPropertyImpl( name : String, bindingAttr : BindingFlags, binder : Binder, returnType : Type, types : Type[], modifiers : ParameterModifier[] ) : PropertyInfo
Parametri
- name
- Tipo: System.String
String contenente il nome della proprietà da ottenere.
- bindingAttr
- Tipo: System.Reflection.BindingFlags
Maschera di bit costituita da uno o più BindingFlags che consentono di specificare le modalità di esecuzione della ricerca.
-o-
Zero, per restituire null.
- binder
- Tipo: System.Reflection.Binder
Oggetto Binder che definisce una serie di proprietà e consente l'associazione, che può implicare la scelta di un metodo di overload, l'assegnazione forzata dei tipi di argomento e la chiamata di un membro mediante reflection.
-o-
null, per utilizzare DefaultBinder.
- returnType
- Tipo: System.Type
Tipo restituito della proprietà.
- types
- Tipo: System.Type[]
Matrice di oggetti Type che rappresentano numero, ordine e tipo dei parametri relativi alla proprietà indicizzata da ottenere.
-o-
Matrice vuota di tipo Type (ovvero Type[] types = new Type[0]) per ottenere una proprietà non indicizzata.
- modifiers
- Tipo: System.Reflection.ParameterModifier[]
Matrice di oggetti ParameterModifier che rappresentano gli attributi associati all'elemento corrispondente nella matrice types. Questo parametro non viene elaborato dal gestore di associazione predefinito.
Valore restituito
Tipo: System.Reflection.PropertyInfoOggetto PropertyInfo che rappresenta la proprietà corrispondente ai requisiti specificati, se è stato trovato. In caso contrario, null.
| Eccezione | Condizione |
|---|---|
| AmbiguousMatchException | È stata trovata più di una proprietà con il nome specificato che corrisponde ai vincoli di associazione specificati. |
| ArgumentNullException | nameè null. -o- typesè null. -o- Uno degli elementi in types è null. |
| ArgumentException | types è multidimensionale. -o- modifiers è multidimensionale. -o- types e modifiers non hanno la stessa lunghezza. |
Sebbene il gestore di associazione predefinito non elabori l'oggetto ParameterModifier (il parametro modifiers ), è possibile utilizzare la classe astratta System.Reflection.Binder per scrivere un gestore di associazione personalizzato che elabori modifiers . ParameterModifier viene utilizzato solo per le chiamate tramite interoperabilità COM e vengono gestiti solo parametri passati per riferimento.
È possibile utilizzare i seguenti flag di filtro BindingFlags per definire le proprietà da includere nella ricerca:
Per ottenere un risultato è necessario specificare BindingFlags.Instance o BindingFlags.Static.
Specificare BindingFlags.Public per includere le proprietà pubbliche nella ricerca.
Specificare BindingFlags.NonPublic per includere nella ricerca proprietà di tipo non pubblico, ovvero proprietà private e protette.
Specificare BindingFlags.FlattenHierarchy per includere i membri statici public e protected nella gerarchia; i membri statici private nelle classi ereditate non sono inclusi.
È possibile utilizzare i seguenti flag di modifica BindingFlags per modificare le modalità di esecuzione della ricerca:
BindingFlags.IgnoreCase per ignorare l'utilizzo di maiuscole e minuscole in name.
BindingFlags.DeclaredOnly per cercare solo le proprietà dichiarate su Type e non quelle semplicemente ereditate.
Per ulteriori informazioni, vedere System.Reflection.BindingFlags.
Se la proprietà richiesta non è pubblica e il chiamante non dispone dell'oggetto ReflectionPermission necessario per eseguire la reflection degli oggetti non pubblici al di fuori dell'assembly corrente, il metodo restituisce null.
Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition , Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile per Smartphone, Windows Mobile per Pocket PC, Xbox 360
.NET Framework e .NET Compact Framework non supportano tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.