Diese Dokumentation wurde archiviert und wird nicht länger gepflegt.

TypeDescriptor.GetProperties-Methode (Object, Attribute[], Boolean)

Aktualisiert: November 2007

Gibt die Auflistung von Eigenschaften für eine angegebene Komponente zurück, wobei das angegebene Array von Attributen als Filter fungiert und ein benutzerdefinierter Typdeskriptor verwendet wird.

Namespace:  System.ComponentModel
Assembly:  System (in System.dll)

public static PropertyDescriptorCollection GetProperties(
	Object component,
	Attribute[] attributes,
	bool noCustomTypeDesc
)
public static PropertyDescriptorCollection GetProperties(
	Object component,
	Attribute[] attributes,
	boolean noCustomTypeDesc
)
public static function GetProperties(
	component : Object, 
	attributes : Attribute[], 
	noCustomTypeDesc : boolean
) : PropertyDescriptorCollection

Parameter

component
Typ: System.Object
Eine Komponente, für die die Eigenschaften abgerufen werden sollen.
attributes
Typ: System.Attribute[]
Ein Array vom Typ Attribute, das als Filter verwendet werden soll.
noCustomTypeDesc
Typ: System.Boolean
true, um benutzerdefinierte Typinformationen zu berücksichtigen, andernfalls false.

Rückgabewert

Typ: System.ComponentModel.PropertyDescriptorCollection
Eine PropertyDescriptorCollection mit den Ereignissen, die mit den angegebenen Attributen für die angegebene Komponente übereinstimmen.

AusnahmeBedingung
NotSupportedException

component ist ein prozessübergreifendes Remoteobjekt.

Die Eigenschaften für eine component können sich von den Eigenschaften einer Klasse unterscheiden, da Eigenschaften durch die Site hinzugefügt oder entfernt werden können, wenn die component platziert wird.

Das attributes-Parameterarray wird zum Filtern des Arrays verwendet. Der Filtervorgang wird durch folgende Regeln definiert:

  • Wenn eine Eigenschaft über keine Attribute-Klasse derselben Klasse verfügt, wird die Eigenschaft nicht in das zurückgegebene Array aufgenommen.

  • Wenn das Attribut eine Instanz der Attribute-Klasse ist, wird die Eigenschaft nur bei exakter Übereinstimmung in das zurückgegebene Array aufgenommen.

  • Wenn eine Attribute-Instanz angegeben ist und es sich um die Standardeigenschaft handelt, wird sie auch dann in das zurückgegebene Array aufgenommen, wenn in der Eigenschaft keine Instanz von Attribute vorhanden ist.

  • Wenn attributes über ein Standardattribut verfügt, beachtet die GetProperties-Methode die Groß- und Kleinschreibung, wenn das Attribut nicht auf die Eigenschaft angewendet wird.

Wenn der component-Parameter null ist, wird eine leere Auflistung zurückgegeben.

Die Auflistung wird nicht bei jedem Aufruf in der gleichen Reihenfolge zurückgegeben und muss daher vor ihrer Verwendung stets sortiert werden.

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

.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.

.NET Framework

Unterstützt in: 3.5, 3.0, 2.0, 1.1, 1.0
Anzeigen: