PropertyDescriptor.GetChildProperties Method

Definition

Overloads

GetChildProperties()

Gibt die als Standard festgelegte PropertyDescriptorCollection-Klasse zurück.Returns the default PropertyDescriptorCollection.

GetChildProperties(Attribute[])

Gibt eine PropertyDescriptorCollection-Klasse unter Verwendung eines angegebenen Arrays von Attributen als Filter zurück.Returns a PropertyDescriptorCollection using a specified array of attributes as a filter.

GetChildProperties(Object)

Gibt eine PropertyDescriptorCollection-Klasse für ein angegebenes Objekt zurück.Returns a PropertyDescriptorCollection for a given object.

GetChildProperties(Object, Attribute[])

Gibt eine PropertyDescriptorCollection-Klasse für ein angegebenes Objekt zurück, wobei ein angegebenes Array von Attributen als Filter verwendet wird.Returns a PropertyDescriptorCollection for a given object using a specified array of attributes as a filter.

GetChildProperties()

Gibt die als Standard festgelegte PropertyDescriptorCollection-Klasse zurück.Returns the default PropertyDescriptorCollection.

public:
 System::ComponentModel::PropertyDescriptorCollection ^ GetChildProperties();
public System.ComponentModel.PropertyDescriptorCollection GetChildProperties ();
member this.GetChildProperties : unit -> System.ComponentModel.PropertyDescriptorCollection
Public Function GetChildProperties () As PropertyDescriptorCollection

Returns

PropertyDescriptorCollection

Eine Auflistung von Eigenschaftendeskriptoren.A collection of property descriptor.

Remarks

Diese Methode übergibt null sowohl für den instance Parameter als auch für den filter-Parameter.This method passes null for both the instance parameter and the filter parameter.

Die Eigenschaften für den instance-Parameter können sich von den Eigenschaften einer Klasse unterscheiden, da der Container Eigenschaften hinzufügen oder entfernen kann, wenn der instance Parameter positioniert ist.The properties for the instance parameter can differ from the properties of a class, because the container can add or remove properties if the instance parameter is sited.

Mit dem filter-Parameter können Type und Attribute-Objekte gemischt werden.The filter parameter can mix Type and Attribute objects. Das Filtern wird durch die folgenden Regeln definiert:Filtering is defined by the following rules:

  • Ein Type-Objekt wird als Platzhalter behandelt. Er gleicht jede Eigenschaft ab, die über den Type in der Attribut Gruppe verfügt.A Type object is treated as a wildcard; it matches any property that has the Type in its set of attributes.

  • Wenn eine Eigenschaft nicht über eine Attribute derselben Klasse verfügt, wird die Eigenschaft nicht in das zurückgegebene Array eingeschlossen.If a property does not have an Attribute of the same class, the property will not be included in the returned array.

  • Wenn das-Attribut eine Instanz von Attributeist, muss die-Eigenschaft eine genaue Entsprechung sein, die in das zurückgegebene Array eingeschlossen werden soll.If the attribute is an instance of Attribute, the property must be an exact match to be included in the returned array.

  • Wenn Sie eine Attribute angeben und es sich um die Standard Eigenschaft handelt, wird Sie in das zurückgegebene Array eingeschlossen, auch wenn keine Instanz von Attribute in der-Eigenschaft vorhanden ist.If you specify an Attribute and it is the default property, it will be included in the returned array, even if there is no instance of Attribute in the property.

See also

GetChildProperties(Attribute[])

Gibt eine PropertyDescriptorCollection-Klasse unter Verwendung eines angegebenen Arrays von Attributen als Filter zurück.Returns a PropertyDescriptorCollection using a specified array of attributes as a filter.

public:
 System::ComponentModel::PropertyDescriptorCollection ^ GetChildProperties(cli::array <Attribute ^> ^ filter);
public System.ComponentModel.PropertyDescriptorCollection GetChildProperties (Attribute[] filter);
member this.GetChildProperties : Attribute[] -> System.ComponentModel.PropertyDescriptorCollection
Public Function GetChildProperties (filter As Attribute()) As PropertyDescriptorCollection

Parameters

filter
Attribute[]

Ein Array des Typs Attribute, der als Filter verwendet werden soll.An array of type Attribute to use as a filter.

Returns

PropertyDescriptorCollection

Eine PropertyDescriptorCollection-Klasse mit den Eigenschaften, die mit den angegebenen Attributen übereinstimmen.A PropertyDescriptorCollection with the properties that match the specified attributes.

Remarks

Diese Methode übergibt null für den instance-Parameter.This method passes null for the instance parameter.

Die Eigenschaften für den instance-Parameter können sich von den Eigenschaften einer Klasse unterscheiden, da die Site Eigenschaften hinzufügen oder entfernen kann, wenn der instance Parameter positioniert ist.The properties for the instance parameter can differ from the properties of a class, because the site can add or remove properties if the instance parameter is sited.

Mit dem filter-Parameter können Type und Attribute-Objekte gemischt werden.The filter parameter can mix Type and Attribute objects. Das Filtern wird durch die folgenden Regeln definiert:Filtering is defined by the following rules:

  • Ein Type-Objekt wird als Platzhalter behandelt. Er gleicht jede Eigenschaft ab, die über den Type in der Attribut Gruppe verfügt.A Type object is treated as a wildcard; it matches any property that has the Type in its set of attributes.

  • Wenn eine Eigenschaft nicht über eine Attribute derselben Klasse verfügt, wird die Eigenschaft nicht in das zurückgegebene Array eingeschlossen.If a property does not have an Attribute of the same class, the property will not be included in the returned array.

  • Wenn das-Attribut eine Instanz von Attributeist, muss die-Eigenschaft eine genaue Entsprechung sein, die in das zurückgegebene Array eingeschlossen werden soll.If the attribute is an instance of Attribute, the property must be an exact match to be included in the returned array.

  • Wenn Sie eine Attribute Instanz angeben und es sich um die Standard Eigenschaft handelt, wird Sie in das zurückgegebene Array eingeschlossen, auch wenn keine Instanz des Attribute in der Eigenschaft vorhanden ist.If you specify an Attribute instance and it is the default property, it will be included in the returned array even if there is no instance of the Attribute in the property.

See also

GetChildProperties(Object)

Gibt eine PropertyDescriptorCollection-Klasse für ein angegebenes Objekt zurück.Returns a PropertyDescriptorCollection for a given object.

public:
 System::ComponentModel::PropertyDescriptorCollection ^ GetChildProperties(System::Object ^ instance);
public System.ComponentModel.PropertyDescriptorCollection GetChildProperties (object instance);
member this.GetChildProperties : obj -> System.ComponentModel.PropertyDescriptorCollection
Public Function GetChildProperties (instance As Object) As PropertyDescriptorCollection

Parameters

instance
Object

Eine Komponente, deren Eigenschaften abgerufen werden sollen.A component to get the properties for.

Returns

PropertyDescriptorCollection

Eine PropertyDescriptorCollection mit den Eigenschaften für die angegebene Komponente.A PropertyDescriptorCollection with the properties for the specified component.

Remarks

Diese Methode übergibt null für den filter-Parameter.This method passes null for the filter parameter.

Die Eigenschaften für den instance-Parameter können sich von den Eigenschaften einer Klasse unterscheiden, da die Site Eigenschaften hinzufügen oder entfernen kann, wenn der instance Parameter positioniert ist.The properties for the instance parameter can differ from the properties of a class, because the site can add or remove properties if the instance parameter is sited.

Mit dem filter-Parameter können Type und Attribute-Objekte gemischt werden.The filter parameter can mix Type and Attribute objects. Das Filtern wird durch die folgenden Regeln definiert:Filtering is defined by the following rules:

  • Ein Type-Objekt wird als Platzhalter behandelt. Er gleicht jede Eigenschaft ab, die über den Type in der Attribut Gruppe verfügt.A Type object is treated as a wildcard; it matches any property that has the Type in its set of attributes.

  • Wenn eine Eigenschaft nicht über eine Attribute derselben Klasse verfügt, wird die Eigenschaft nicht in das zurückgegebene Array eingeschlossen.If a property does not have an Attribute of the same class, the property will not be included in the returned array.

  • Wenn das-Attribut eine Instanz von Attributeist, muss die-Eigenschaft eine genaue Entsprechung sein, die in das zurückgegebene Array eingeschlossen werden soll.If the attribute is an instance of Attribute, the property must be an exact match to be included in the returned array.

  • Wenn Sie eine Attribute Instanz angeben und es sich um die Standard Eigenschaft handelt, wird Sie in das zurückgegebene Array eingeschlossen, auch wenn keine Instanz des Attribute in der Eigenschaft vorhanden ist.If you specify an Attribute instance and it is the default property, it will be included in the returned array even if there is no instance of the Attribute in the property.

See also

GetChildProperties(Object, Attribute[])

Gibt eine PropertyDescriptorCollection-Klasse für ein angegebenes Objekt zurück, wobei ein angegebenes Array von Attributen als Filter verwendet wird.Returns a PropertyDescriptorCollection for a given object using a specified array of attributes as a filter.

public:
 virtual System::ComponentModel::PropertyDescriptorCollection ^ GetChildProperties(System::Object ^ instance, cli::array <Attribute ^> ^ filter);
public virtual System.ComponentModel.PropertyDescriptorCollection GetChildProperties (object instance, Attribute[] filter);
abstract member GetChildProperties : obj * Attribute[] -> System.ComponentModel.PropertyDescriptorCollection
override this.GetChildProperties : obj * Attribute[] -> System.ComponentModel.PropertyDescriptorCollection
Public Overridable Function GetChildProperties (instance As Object, filter As Attribute()) As PropertyDescriptorCollection

Parameters

instance
Object

Eine Komponente, deren Eigenschaften abgerufen werden sollen.A component to get the properties for.

filter
Attribute[]

Ein Array des Typs Attribute, der als Filter verwendet werden soll.An array of type Attribute to use as a filter.

Returns

PropertyDescriptorCollection

Eine PropertyDescriptorCollection mit den Eigenschaften, die mit den angegebenen Attributen für die angegebene Komponente übereinstimmen.A PropertyDescriptorCollection with the properties that match the specified attributes for the specified component.

Remarks

Die Eigenschaften für den instance-Parameter können sich von den Eigenschaften einer Klasse unterscheiden, da die Site Eigenschaften hinzufügen oder entfernen kann, wenn der instance Parameter positioniert ist.The properties for the instance parameter can differ from the properties of a class, because the site can add or remove properties if the instance parameter is sited.

Mit dem filter-Parameter können Type und Attribute-Objekte gemischt werden.The filter parameter can mix Type and Attribute objects. Das Filtern wird durch die folgenden Regeln definiert:Filtering is defined by the following rules:

  • Ein Type-Objekt wird als Platzhalter behandelt. Er gleicht jede Eigenschaft ab, die über den Type in der Attribut Gruppe verfügt.A Type object is treated as a wildcard; it matches any property that has the Type in its set of attributes.

  • Wenn eine Eigenschaft nicht über eine Attribute derselben Klasse verfügt, wird die Eigenschaft nicht in das zurückgegebene Array eingeschlossen.If a property does not have an Attribute of the same class, the property will not be included in the returned array.

  • Wenn das-Attribut eine Instanz von Attributeist, muss die-Eigenschaft eine genaue Entsprechung sein, die in das zurückgegebene Array eingeschlossen werden soll.If the attribute is an instance of Attribute, the property must be an exact match to be included in the returned array.

  • Wenn Sie eine Attribute Instanz angeben und es sich um die Standard Eigenschaft handelt, wird Sie in das zurückgegebene Array eingeschlossen, auch wenn keine Instanz des Attribute in der Eigenschaft vorhanden ist.If you specify an Attribute instance and it is the default property, it will be included in the returned array even if there is no instance of the Attribute in the property.

Im Allgemeinen sollten untergeordnete Eigenschaften zurückgegeben werden, indem der GetProperties Member des von dieser Eigenschaft zurückgegebenen TypeConverter implementiert wird.Generally, child properties should be returned by implementing the GetProperties member of the TypeConverter returned from this property.

See also

Applies to