TypeDescriptor.GetAttributes Method

Definition

Retourne la collection d’attributs pour un composant ou un type.Returns the collection of attributes for a component or a type.

Overloads

GetAttributes(Object)

Retourne la collection d’attributs pour le composant spécifié.Returns the collection of attributes for the specified component.

GetAttributes(Type)

Retourne une collection d’attributs pour le type de composant spécifié.Returns a collection of attributes for the specified type of component.

GetAttributes(Object, Boolean)

Retourne une collection d’attributs pour le composant spécifié et une valeur booléenne indiquant qu’un descripteur de type personnalisé a été créé.Returns a collection of attributes for the specified component and a Boolean indicating that a custom type descriptor has been created.

GetAttributes(Object)

Retourne la collection d’attributs pour le composant spécifié.Returns the collection of attributes for the specified component.

public:
 static System::ComponentModel::AttributeCollection ^ GetAttributes(System::Object ^ component);
public static System.ComponentModel.AttributeCollection GetAttributes (object component);
static member GetAttributes : obj -> System.ComponentModel.AttributeCollection
Public Shared Function GetAttributes (component As Object) As AttributeCollection

Parameters

component
Object

Composant pour lequel vous souhaitez obtenir les attributs.The component for which you want to get attributes.

Returns

AttributeCollection

AttributeCollection contenant les attributs pour le composant.An AttributeCollection containing the attributes for the component. Si component est null, cette méthode retourne une collection vide.If component is null, this method returns an empty collection.

Examples

Pour obtenir un exemple de cette méthode, consultez la méthode Matches.For an example of this method, see the Matches method.

Remarks

Les attributs retournés par la méthode GetAttributes peuvent être modifiés dynamiquement à partir de la liste source du composant d’origine par les fournisseurs d’extendeurs (IExtenderProvider), les services de filtre (ITypeDescriptorFilterService) et les filtres d’attributs.The attributes returned by the GetAttributes method may be dynamically modified from the original component's source listing by extender providers (IExtenderProvider), filter services (ITypeDescriptorFilterService), and attribute filters.

Lorsque vous définissez un attribut personnalisé avec AttributeUsageAttribute.AllowMultiple défini sur true, vous devez substituer la propriété Attribute.TypeId pour le rendre unique.When you define a custom attribute with AttributeUsageAttribute.AllowMultiple set to true, you must override the Attribute.TypeId property to make it unique. Si toutes les instances de votre attribut sont uniques, substituez Attribute.TypeId pour retourner l’identité d’objet de votre attribut.If all instances of your attribute are unique, override Attribute.TypeId to return the object identity of your attribute. Si seules certaines instances de votre attribut sont uniques, retournez une valeur de Attribute.TypeId qui retournerait l’égalité dans ces cas.If only some instances of your attribute are unique, return a value from Attribute.TypeId that would return equality in those cases. Par exemple, certains attributs ont un paramètre de constructeur qui agit comme une clé unique.For example, some attributes have a constructor parameter that acts as a unique key. Pour ces attributs, retournez la valeur du paramètre de constructeur à partir de la propriété Attribute.TypeId.For these attributes, return the value of the constructor parameter from the Attribute.TypeId property.

Note

L’implémentation par défaut de Attribute.TypeId retourne l’identité de type, quelle que soit la valeur de la propriété AttributeUsageAttribute.AllowMultiple.The default implementation of Attribute.TypeId returns the type identity regardless of the value of the AttributeUsageAttribute.AllowMultiple property. Pour retourner plusieurs instances d’un attribut AttributeUsageAttribute.AllowMultiple à partir du AttributeCollection, votre attribut doit substituer la propriété Attribute.TypeId.In order to return multiple instances of an AttributeUsageAttribute.AllowMultiple attribute from the AttributeCollection, your attribute must override the Attribute.TypeId property.

See also

GetAttributes(Type)

Retourne une collection d’attributs pour le type de composant spécifié.Returns a collection of attributes for the specified type of component.

public:
 static System::ComponentModel::AttributeCollection ^ GetAttributes(Type ^ componentType);
public static System.ComponentModel.AttributeCollection GetAttributes (Type componentType);
static member GetAttributes : Type -> System.ComponentModel.AttributeCollection
Public Shared Function GetAttributes (componentType As Type) As AttributeCollection

Parameters

componentType
Type

Type du composant cible.The Type of the target component.

Returns

AttributeCollection

AttributeCollection avec les attributs pour le type du composant.An AttributeCollection with the attributes for the type of the component. Si le composant est null, la méthode retourne une collection vide.If the component is null, this method returns an empty collection.

Remarks

Appelez cette version de cette méthode uniquement si vous n’avez pas d’instance de l’objet.Call this version of this method only when you do not have an instance of the object.

Pour les attributs dont la valeur de AttributeUsageAttribute.AllowMultiple est true, la collection d’attributs supprime les instances dupliquées.For attributes with AttributeUsageAttribute.AllowMultiple set to true, the attribute collection removes duplicate instances. Il s’agit des instances dans lesquelles la propriété Attribute.TypeId retourne des valeurs égales.These are instances in which the Attribute.TypeId property returns equal values.

Lorsque vous définissez un attribut personnalisé avec AttributeUsageAttribute.AllowMultiple défini sur true, vous devez substituer la propriété Attribute.TypeId pour le rendre unique.When you define a custom attribute with AttributeUsageAttribute.AllowMultiple set to true, you must override the Attribute.TypeId property to make it unique. Si toutes les instances de votre attribut sont uniques, substituez Attribute.TypeId pour retourner l’identité d’objet de votre attribut.If all instances of your attribute are unique, override Attribute.TypeId to return the object identity of your attribute. Si seules certaines instances de votre attribut sont uniques, retournez une valeur de Attribute.TypeId qui retournerait l’égalité dans ces cas.If only some instances of your attribute are unique, return a value from Attribute.TypeId that would return equality in those cases. Par exemple, certains attributs ont un paramètre de constructeur qui agit comme une clé unique.For example, some attributes have a constructor parameter that acts as a unique key. Pour ces attributs, retournez la valeur du paramètre de constructeur à partir de la propriété Attribute.TypeId.For these attributes, return the value of the constructor parameter from the Attribute.TypeId property.

Note

L’implémentation par défaut de Attribute.TypeId retourne l’identité de type, quelle que soit la valeur de la propriété AttributeUsageAttribute.AllowMultiple.The default implementation of Attribute.TypeId returns the type identity regardless of the value of the AttributeUsageAttribute.AllowMultiple property. Pour retourner plusieurs instances d’un attribut AttributeUsageAttribute.AllowMultiple à partir du AttributeCollection, votre attribut doit substituer la propriété Attribute.TypeId.In order to return multiple instances of an AttributeUsageAttribute.AllowMultiple attribute from the AttributeCollection, your attribute must override the Attribute.TypeId property.

See also

GetAttributes(Object, Boolean)

Retourne une collection d’attributs pour le composant spécifié et une valeur booléenne indiquant qu’un descripteur de type personnalisé a été créé.Returns a collection of attributes for the specified component and a Boolean indicating that a custom type descriptor has been created.

public:
 static System::ComponentModel::AttributeCollection ^ GetAttributes(System::Object ^ component, bool noCustomTypeDesc);
public static System.ComponentModel.AttributeCollection GetAttributes (object component, bool noCustomTypeDesc);
static member GetAttributes : obj * bool -> System.ComponentModel.AttributeCollection
Public Shared Function GetAttributes (component As Object, noCustomTypeDesc As Boolean) As AttributeCollection

Parameters

component
Object

Composant pour lequel vous souhaitez obtenir les attributs.The component for which you want to get attributes.

noCustomTypeDesc
Boolean

true pour utiliser un ensemble d’attributs de base de référence à partir du descripteur de type personnalisé si component est de type ICustomTypeDescriptor ; sinon, false.true to use a baseline set of attributes from the custom type descriptor if component is of type ICustomTypeDescriptor; otherwise, false.

Returns

AttributeCollection

AttributeCollection avec les attributs pour le composant.An AttributeCollection with the attributes for the component. Si le composant est null, la méthode retourne une collection vide.If the component is null, this method returns an empty collection.

Remarks

Les attributs retournés par la méthode GetAttributes peuvent être modifiés dynamiquement à partir de la liste de sources des composants d’origine par les fournisseurs d’extendeurs (IExtenderProvider), les services de filtre (ITypeDescriptorFilterService) et les filtres d’attributs.The attributes returned by the GetAttributes method may be dynamically modified from the original components source listing by extender providers (IExtenderProvider), filter services (ITypeDescriptorFilterService), and attribute filters.

Lorsque vous définissez un attribut personnalisé avec AttributeUsageAttribute.AllowMultiple défini sur true, vous devez substituer la propriété Attribute.TypeId pour le rendre unique.When you define a custom attribute with AttributeUsageAttribute.AllowMultiple set to true, you must override the Attribute.TypeId property to make it unique. Si toutes les instances de votre attribut sont uniques, substituez Attribute.TypeId pour retourner l’identité d’objet de votre attribut.If all instances of your attribute are unique, override Attribute.TypeId to return the object identity of your attribute. Si seules certaines instances de votre attribut sont uniques, retournez une valeur de Attribute.TypeId qui retournerait l’égalité dans ces cas.If only some instances of your attribute are unique, return a value from Attribute.TypeId that would return equality in those cases. Par exemple, certains attributs ont un paramètre de constructeur qui agit comme une clé unique.For example, some attributes have a constructor parameter that acts as a unique key. Pour ces attributs, retournez la valeur du paramètre de constructeur à partir de la propriété Attribute.TypeId.For these attributes, return the value of the constructor parameter from the Attribute.TypeId property.

Note

L’implémentation par défaut de Attribute.TypeId retourne l’identité de type, quelle que soit la valeur de la propriété AttributeUsageAttribute.AllowMultiple.The default implementation of Attribute.TypeId returns the type identity regardless of the value of the AttributeUsageAttribute.AllowMultiple property. Pour retourner plusieurs instances d’un attribut AttributeUsageAttribute.AllowMultiple à partir du AttributeCollection, votre attribut doit substituer la propriété Attribute.TypeId.In order to return multiple instances of an AttributeUsageAttribute.AllowMultiple attribute from the AttributeCollection, your attribute must override the Attribute.TypeId property.

See also

Applies to