Cette documentation est archivée et n’est pas conservée.

Type.GetPropertyImpl, méthode

En cas de substitution dans une classe dérivée, recherche la propriété spécifiée dont les paramètres correspondent aux types d'arguments et modificateurs spécifiés, en utilisant les contraintes de liaison indiquées.

Espace de noms : System
Assembly : mscorlib (dans 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

Paramètres

name

String contenant le nom de la propriété à obtenir.

bindingAttr

Masque de bits constitué d'un ou de plusieurs BindingFlags spécifiant le mode d'exécution de la recherche.

– ou –

Zéro, pour retourner référence Null (Nothing en Visual Basic).

binder

Objet Binder qui définit un ensemble de propriétés et permet la liaison, ce qui peut impliquer la sélection d'un membre surchargé, la contrainte de types d'arguments et l'appel d'un membre par la réflexion.

– ou –

référence Null (Nothing en Visual Basic), pour utiliser DefaultBinder.

returnType

Type de retour de la propriété.

types

Tableau d'objets Type représentant le nombre, l'ordre et le type des paramètres de la propriété indexée à obtenir.

– ou –

Tableau vide du type Type (c'est-à-dire Type[] types = new Type[0]) pour obtenir une propriété qui n'est pas indexée.

modifiers

Tableau d'objets ParameterModifier représentant les attributs associés à l'élément correspondant dans le tableau types. Le binder par défaut ne traite pas ce paramètre.

Valeur de retour

Objet PropertyInfo représentant la propriété qui correspond aux critères spécifiés, si elle existe ; sinon, référence Null (Nothing en Visual Basic).

Type d'exceptionCondition

AmbiguousMatchException

Il existe plusieurs propriétés portant le nom spécifié et correspondant aux contraintes de liaison spécifiées.

ArgumentNullException

name a la valeur référence Null (Nothing en Visual Basic).

– ou –

types a la valeur référence Null (Nothing en Visual Basic).

– ou –

Un des éléments dans types est référence Null (Nothing en Visual Basic).

ArgumentException

types est multidimensionnel.

– ou –

modifiers est multidimensionnel.

– ou –

types et modifiers n'ont pas la même longueur.

Bien que le binder par défaut ne traite pas ParameterModifier (le paramètre modifiers), vous pouvez utiliser la classe abstraite System.Reflection.Binder pour écrire un binder personnalisé qui traite modifiers. ParameterModifier est utilisé uniquement lors d'un appel via COM Interop, et seuls sont gérés les paramètres passés par référence.

Les tableaux types et modifiers ont la même longueur. Un paramètre spécifié dans le tableau types peut avoir les attributs suivants, spécifiés dans le tableau modifiers : pdIn, pdOut, pdLcid, pdRetval, pdOptional et pdHasDefault, qui représentent [In], [Out], [lcid], [retval], [optional], et une valeur spécifiant si le paramètre a une valeur par défaut. Les attributs associés à un paramètre sont stockés dans les métadonnées et utilisés pour l'interopérabilité.

Les indicateurs de filtre BindingFlags suivants peuvent être utilisés pour définir les propriétés à inclure dans la recherche :

  • Vous devez spécifier soit BindingFlags.Instance, soit BindingFlags.Static pour obtenir un retour.

  • Spécifiez BindingFlags.Public pour inclure les propriétés publiques dans la recherche.

  • Spécifiez BindingFlags.NonPublic pour inclure les propriétés non publiques (c'est-à-dire les propriétés privées et protégées) dans la recherche.

  • Spécifiez BindingFlags.FlattenHierarchy pour inclure les membres statiques public et protected en haut de la hiérarchie ; les membres statiques private dans les classes héritées ne sont pas inclus.

Les indicateurs de modificateur BindingFlags suivants peuvent être utilisés pour modifier le fonctionnement de la recherche :

  • BindingFlags.IgnoreCase pour ignorer la casse de name.

  • BindingFlags.DeclaredOnly pour rechercher uniquement les propriétés déclarées sur Type et non les propriétés qui ont été simplement héritées.

Pour plus d'informations, consultez System.Reflection.BindingFlags.

Si le type demandé est non public et si l'appelant ne possède pas de ReflectionPermission pour réfléchir les objets non publics en dehors de l'assembly en cours, cette méthode retourne alors référence Null (Nothing en Visual Basic).

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile pour Pocket PC, Windows Mobile pour Smartphone, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition

Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.

.NET Framework

Prise en charge dans : 2.0, 1.1, 1.0

.NET Compact Framework

Prise en charge dans : 2.0, 1.0
Afficher: