System.Type.GetProperty-methoden

Opmerking

In dit artikel vindt u aanvullende opmerkingen in de referentiedocumentatie voor deze API.

De volgende richtlijnen zijn van toepassing op alle overbelastingen:

• Een eigenschap wordt voor reflectie als openbaar beschouwd als deze ten minste één toegangsfunctie heeft die openbaar is. Anders wordt de eigenschap als privé beschouwd en moet u (in Visual Basic de waarden combineren met behulp van) gebruiken BindingFlags.NonPublic | BindingFlags.Instance | BindingFlags.Staticom deze te verkrijgen.Or
• Als de huidige Type een geconstrueerd generiek type vertegenwoordigt, retourneert deze methode de PropertyInfo met typeparameters vervangen door de geschikte typeargumenten.
• Als de huidige Type een typeparameter vertegenwoordigt in de definitie van een algemeen type of algemene methode, doorzoekt deze methode de eigenschappen van de klassebeperking.

GetProperty(String) methode

De zoekopdracht name is hoofdlettergevoelig. De zoekopdracht omvat openbare statische en openbare instantiesigenschappen.

Situaties waarin AmbiguousMatchException zich voordoet, zijn onder andere:

• Een type bevat twee geïndexeerde eigenschappen met dezelfde naam, maar verschillende aantallen parameters. Als u de dubbelzinnigheid wilt oplossen, gebruikt u een overbelasting van de GetProperty methode waarmee parametertypen worden opgegeven.
• Een afgeleid type declareert een eigenschap die een overgenomen eigenschap met dezelfde naam verbergt met behulp van de new modifier (Shadows in Visual Basic). Als u de dubbelzinnigheid wilt oplossen, gebruikt u de overbelasting van de GetProperty(String, BindingFlags) methode en voegt u de BindingFlags.DeclaredOnly vlag toe om de zoekopdracht te beperken tot leden die niet zijn overgenomen.

GetProperty(String, BindingFlags) methode

De volgende BindingFlags filtervlagmen kunnen worden gebruikt om te definiëren welke eigenschappen moeten worden opgenomen in de zoekopdracht:

• U moet of BindingFlags.Instance of BindingFlags.Static opgeven om een retour te krijgen.
• Geef BindingFlags.Public op dat openbare eigenschappen moeten worden opgenomen in de zoekopdracht.
• Geef BindingFlags.NonPublic op dat u niet-openbare eigenschappen (dat wil gezegd privé-, interne en beveiligde eigenschappen) wilt opnemen in de zoekopdracht.
• Geef BindingFlags.FlattenHierarchy op dat u statische leden wilt opnemen public in protected de hiërarchie. private Statische leden in overgenomen klassen zijn niet opgenomen.

De volgende BindingFlags wijzigingsvlagmen kunnen worden gebruikt om de werking van de zoekopdracht te wijzigen:

• BindingFlags.IgnoreCase om de hoofdlettergevoeligheid van name te negeren.
• BindingFlags.DeclaredOnly om alleen de eigenschappen te doorzoeken die zijn gedeclareerd op de Type, niet eigenschappen die gewoon zijn overgenomen.

Situaties waarin AmbiguousMatchException zich voordoet, zijn onder andere:

• Een type bevat twee geïndexeerde eigenschappen met dezelfde naam, maar verschillende aantallen parameters. Als u de dubbelzinnigheid wilt oplossen, gebruikt u een overbelasting van de GetProperty methode waarmee parametertypen worden opgegeven.
• Een afgeleid type declareert een eigenschap die een overgenomen eigenschap met dezelfde naam verbergt met behulp van de new wijzigingsfunctie (Shadows in Visual Basic). Om de dubbelzinnigheid op te lossen, moet u BindingFlags.DeclaredOnly opnemen om de zoekopdracht te beperken tot leden die niet zijn overgenomen.

GetProperty(System.String, System.Reflection.BindingFlags, System.Reflection.Binder, System.Type, System.Type[], methode System.Reflection.ParameterModifier[])

Hoewel de standaardbinder ParameterModifier (het modifiers-argument) niet verwerkt, kunt u de abstracte klasse System.Reflection.Binder gebruiken om een aangepaste binder te schrijven die modifiers wel verwerkt. ParameterModifier wordt alleen gebruikt bij het aanroepen via COM-interop en alleen parameters die worden doorgegeven door verwijzing, worden verwerkt.

In de volgende tabel ziet u welke leden van een basisklasse worden geretourneerd door de Get methoden bij het weergeven van een type.

Ledentype	Statisch	Niet-statisch
Constructeur	Nee.	Nee.
Veld	Nee.	Ja. Een veld wordt altijd verborgen op basis van naam en kenmerk.
Gebeurtenis	Niet van toepassing	De algemene regels van het type-systeem zijn dat de overerving hetzelfde is als die van de methoden die de eigenschap implementeren. Reflectie behandelt eigenschappen als verbergen-naar-naam-en-handtekening.2
Methode	Nee.	Ja. Een methode (zowel virtueel als niet-virtueel) kan worden verborgen op basis van naam of op basis van naam en handtekening.
Geneste type	Nee.	Nee.
Vastgoed	Niet van toepassing	De algemene regels van het type-systeem zijn dat de overerving hetzelfde is als die van de methoden die de eigenschap implementeren. Reflectie behandelt eigenschappen als verbergen-naar-naam-en-handtekening.2

Opmerkingen:

• Hide-by-name-and-signature beschouwt alle onderdelen van de handtekening, waaronder aangepaste modifiers, retourtypen, parametertypen, sentinels en onbeheerde aanroepconventies. Dit is een binaire vergelijking.
• Voor reflectie worden eigenschappen en gebeurtenissen verborgen op basis van naam en signatuur. Als u een eigenschap hebt met zowel een get als een set accessor in de basisklasse, maar de afgeleide klasse alleen een get-accessor heeft, verbergt de eigenschap afgeleide klasse de eigenschap basisklasse en hebt u geen toegang tot de setter op de basisklasse.
• Aangepaste kenmerken maken geen deel uit van het algemene typesysteem.

De volgende BindingFlags filtervlagmen kunnen worden gebruikt om te definiëren welke eigenschappen moeten worden opgenomen in de zoekopdracht:

• U moet of BindingFlags.Instance of BindingFlags.Static opgeven om een retour te krijgen.
• Geef BindingFlags.Public op dat openbare eigenschappen moeten worden opgenomen in de zoekopdracht.
• Geef BindingFlags.NonPublic op dat u niet-openbare eigenschappen (dat wil gezegd privé-, interne en beveiligde eigenschappen) wilt opnemen in de zoekopdracht.
• Geef BindingFlags.FlattenHierarchy op dat u statische leden wilt opnemen public in protected de hiërarchie. private Statische leden in overgenomen klassen zijn niet opgenomen.

De volgende BindingFlags wijzigingsvlagmen kunnen worden gebruikt om de werking van de zoekopdracht te wijzigen:

• BindingFlags.IgnoreCase om de hoofdlettergevoeligheid van name te negeren.
• BindingFlags.DeclaredOnly om alleen de eigenschappen te doorzoeken die zijn gedeclareerd op de Type, niet eigenschappen die gewoon zijn overgenomen.

Indexeerfuncties en standaardeigenschappen

Visual Basic, C# en C++ hebben vereenvoudigde syntaxis voor het openen van geïndexeerde eigenschappen en toestaan dat één geïndexeerde eigenschap een standaardwaarde is voor het type. Als de variabele myList bijvoorbeeld verwijst naar een ArrayList, haalt de syntaxis myList[3] (myList(3) in Visual Basic) het element op met de index 3. U kunt de eigenschap overbelasten.

In C# wordt deze functie een indexeerfunctie genoemd en kan niet worden verwezen op naam. Standaard wordt een C#-indexeerfunctie weergegeven in metagegevens als een geïndexeerde eigenschap met de naam Item. Een klassebibliotheekontwikkelaar kan echter het IndexerNameAttribute kenmerk gebruiken om de naam van de indexeerfunctie in de metagegevens te wijzigen. Bijvoorbeeld, de String klasse heeft een indexeerfunctie genaamd Chars[]. Geïndexeerde eigenschappen die zijn gemaakt met andere talen dan C# kunnen ook andere namen hebben dan Item,

Als u wilt bepalen of een type een standaardeigenschap heeft, gebruikt u de GetCustomAttributes(Type, Boolean) methode om te testen op het DefaultMemberAttribute kenmerk. Als het type heeft DefaultMemberAttribute, retourneert de MemberName eigenschap de naam van de standaardeigenschap.