ExpandableObjectConverter.GetProperties Methode

  • Referenz

Definition

Namespace:
System.ComponentModel
Assembly:
System.ComponentModel.TypeConverter.dll
Assembly:
System.dll
Assembly:
netstandard.dll

Ruft eine Auflistung von Eigenschaften für den durch den Wertparameter angegebenen Typ von Objekt ab.

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);
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, der einen Formatierungskontext bereitstellt.

value
Object

Ein Object, das den Typ von Objekt angibt, für das die Eigenschaften abgerufen werden sollen.

attributes
Attribute[]

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

Gibt zurück

PropertyDescriptorCollection

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

Hinweise

Mithilfe des context-Parameters können zusätzliche Informationen über die Umgebung extrahiert werden, aus der dieser Konverter aufgerufen wurde. Dieser Parameter kann null sein und muss daher immer überprüft werden. Außerdem können die Eigenschaften des Kontextobjekts null zurückgeben.

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

  • Ein Type Objekt wird als Wildcard behandelt. Es stimmt mit jeder Eigenschaft überein, die in Type seinem Satz von Attributen enthalten ist.

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

  • Wenn es sich bei dem Attribut um eine Instanz handelt Attribute, muss die Eigenschaft eine genaue Übereinstimmung sein, oder sie wird nicht 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 keine Instanz der Attribute Eigenschaft vorhanden ist.

Gilt für:

Siehe auch