ComponentConverter.GetProperties Methode

Definition

Ruft eine Auflistung von Eigenschaften für den Typ der Komponente ab, die durch den Wertparameter angegeben wird.

public:
 override System::ComponentModel::PropertyDescriptorCollection ^ GetProperties(System::ComponentModel::ITypeDescriptorContext ^ context, System::Object ^ value, cli::array <Attribute ^> ^ attributes);
public override System.ComponentModel.PropertyDescriptorCollection GetProperties(System.ComponentModel.ITypeDescriptorContext context, object value, Attribute[] attributes);
override this.GetProperties : System.ComponentModel.ITypeDescriptorContext * obj * Attribute[] -> System.ComponentModel.PropertyDescriptorCollection
Public Overrides Function GetProperties (context As ITypeDescriptorContext, value As Object, attributes As Attribute()) As PropertyDescriptorCollection

Parameter

context
ITypeDescriptorContext

Ein ITypeDescriptorContext Formatkontext.

value
Object

Ein Object Wert, der den Typ der Komponente angibt, für die die Eigenschaften abgerufen werden sollen.

attributes
Attribute[]

Ein Array vom Typ Attribute , das als Filter verwendet wird.

Gibt zurück

A PropertyDescriptorCollection mit den Eigenschaften, die für die Komponente verfügbar gemacht werden, oder null wenn keine Eigenschaften vorhanden sind.

Hinweise

Der context Parameter kann verwendet werden, um zusätzliche Informationen zur Umgebung zu extrahieren, aus der dieser Konverter aufgerufen wird. Dies kann sein null, also immer überprüfen. Außerdem können Eigenschaften für das Kontextobjekt zurückgegeben werden null.

Das attributes Array wird verwendet, um das Array zu filtern. Dies attributes kann eine Mischung aus Type und Attribute Objekten aufweisen. Filterung wird durch die folgenden Regeln definiert:

  • Ein Type Objekt wird als Wildcard behandelt. Es entspricht jeder Eigenschaft, die den Type In-Satz von Attributen enthält.

  • Wenn eine Eigenschaft nicht über eine Attribute der gleichen Klasse verfügt, wird die Eigenschaft nicht in das zurückgegebene Array eingeschlossen.

  • Wenn das Attribut eine Instanz von Attributeist, muss die Eigenschaft eine genaue Übereinstimmung sein, oder sie wird nicht in das zurückgegebene Array eingeschlossen.

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

Gilt für: