ExpandableObjectConverter.GetProperties Methode

Definition

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

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. Die attributes kann eine Mischung aus Type - und Attribute -Objekten aufweisen. Das Filtern wird durch die folgenden Regeln definiert:

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

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

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

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

Gilt für:

Weitere Informationen