CollectionConverter.GetProperties Metoda

Definicja

Pobiera kolekcję właściwości dla typu tablicy określonej przez parametr value przy użyciu określonego kontekstu i atrybutów.

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 tablicy, 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 tego typu danych lub null jeśli nie ma właściwości. Ta metoda zawsze zwraca wartość null.

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.

Przekazana tablica atrybutów będzie używana do filtrowania tablicy. Atrybuty mogą 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.

  • Jeśli wystąpienie Attribute 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 wystąpienia Attribute klasy .

Kolekcje nie obsługują właściwości; dlatego ta metoda zawsze zwraca wartość null.

Dotyczy

Zobacz też