Udostępnij za pośrednictwem


ComponentConverter.GetProperties Metoda

Definicja

Pobiera kolekcję właściwości dla typu składnika określonego przez parametr value.

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

Parametry

context
ITypeDescriptorContext

Element ITypeDescriptorContext , który zapewnia kontekst formatu.

value
Object

Element Object określający typ składnika, dla którego mają być uzyskiwane właściwości.

attributes
Attribute[]

Tablica typu Attribute , która będzie używana jako filtr.

Zwraca

Element PropertyDescriptorCollection z właściwościami uwidocznianymi dla składnika lub null jeśli nie ma właściwości.

Uwagi

Parametr context może służyć do wyodrębniania dodatkowych informacji o środowisku, z którego jest wywoływany ten konwerter. Może to być nullwartość , więc zawsze sprawdzaj. Ponadto właściwości obiektu kontekstu mogą zwracać wartość null.

Tablica attributes będzie używana do filtrowania tablicy. Obiekt attributes może mieć kombinację Type obiektów i Attribute . Filtrowanie jest definiowane przez następujące reguły:

  • Type Obiekt będzie traktowany jako symbol wieloznaczny. Będzie on zgodny z dowolną właściwością, która znajduje się Type w zestawie atrybutów.

  • Jeśli właściwość nie ma Attribute tej samej klasy, właściwość nie zostanie uwzględniona w zwracanej tablicy.

  • Jeśli atrybut jest wystąpieniem Attributeklasy , właściwość musi być dokładnym dopasowaniem lub nie zostanie uwzględniona w zwracanej tablicy.

  • Attribute Jeśli wystąpienie jest określone i jest to właściwość domyślna, zostanie ona uwzględniona w zwracanej tablicy, nawet jeśli w właściwości nie ma żadnego wystąpienia Attribute obiektu .

Dotyczy