ArrayConverter.GetProperties Methode

Definition

Ruft eine Auflistung von Eigenschaften für den durch den Wertparameter angegebenen Typ von Array 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

Eine Object-Klasse, die den Typ von Array angibt, für den die Eigenschaften abgerufen werden sollen.

attributes
Attribute[]

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

Gibt zurück

Eine PropertyDescriptorCollection-Klasse mit den Eigenschaften, die für ein Array verfügbar sind, oder null, wenn keine Eigenschaften verfügbar 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 Attributarray wird verwendet, um das Array zu filtern. Der attributes -Parameter kann eine Mischung aus Type und Attribute -Objekten angeben. Filterung wird durch die folgenden Regeln definiert:

  • A Type wird als Ein-Feldhalter behandelt. Es stimmt mit jeder Eigenschaft überein, die den Type in seinem 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 ein instance von Attributeist, muss die Eigenschaft eine genaue Übereinstimmung sein, sonst wird sie 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 in Attribute der -Eigenschaft vorhanden ist.

Gilt für: