TypeDescriptor.GetAttributes Méthode

Définition

Retourne la collection d’attributs pour un composant ou un type.

Surcharges

GetAttributes(Object)

Retourne la collection d’attributs pour le composant spécifié.

GetAttributes(Type)

Retourne une collection d’attributs pour le type de composant spécifié.

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éé.

GetAttributes(Object)

Retourne la collection d’attributs pour le composant spécifié.

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

Paramètres

component
Object

Composant pour lequel vous souhaitez obtenir les attributs.

Retours

AttributeCollection

AttributeCollection contenant les attributs pour le composant. Si component est null, cette méthode retourne une collection vide.

Exemples

Pour obtenir un exemple de cette méthode, consultez la Matches méthode.

Remarques

Les attributs retournés par la GetAttributes méthode peuvent être modifiés dynamiquement à partir de la liste source du composant d’origine par les fournisseurs d’extendeurs (), les services de filtre (IExtenderProviderITypeDescriptorFilterService) et les filtres d’attributs.

Lorsque vous définissez un attribut personnalisé avec AttributeUsageAttribute.AllowMultiple la valeur définie true, vous devez remplacer la Attribute.TypeId propriété pour la rendre unique. Si toutes les instances de votre attribut sont uniques, remplacez Attribute.TypeId pour renvoyer l’identité d’objet de votre attribut. Si seules certaines instances de votre attribut sont uniques, retournez une valeur à partir de Attribute.TypeId laquelle retournerait l’égalité dans ces cas. Par exemple, certains attributs ont un paramètre de constructeur qui agit comme une clé unique. Pour ces attributs, retournez la valeur du paramètre constructeur de la Attribute.TypeId propriété.

Notes

L’implémentation par défaut de Attribute.TypeId retourne l’identité de type, quelle que soit la valeur de la AttributeUsageAttribute.AllowMultiple propriété. Pour retourner plusieurs instances d’un AttributeUsageAttribute.AllowMultiple attribut à partir du AttributeCollection, votre attribut doit remplacer la Attribute.TypeId propriété.

Voir aussi

S’applique à

GetAttributes(Type)

Retourne une collection d’attributs pour le type de composant spécifié.

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

Paramètres

componentType
Type

Type du composant cible.

Retours

AttributeCollection

AttributeCollection avec les attributs pour le type du composant. Si le composant est null, la méthode retourne une collection vide.

Remarques

Appelez cette version de cette méthode uniquement lorsque vous n’avez pas d’instance de l’objet.

Pour les attributs dont AttributeUsageAttribute.AllowMultiple la valeur est définie true, la collection d’attributs supprime les instances en double. Il s’agit d’instances dans lesquelles la Attribute.TypeId propriété retourne des valeurs égales.

Lorsque vous définissez un attribut personnalisé avec AttributeUsageAttribute.AllowMultiple la valeur définie true, vous devez remplacer la Attribute.TypeId propriété pour la rendre unique. Si toutes les instances de votre attribut sont uniques, remplacez Attribute.TypeId pour renvoyer l’identité d’objet de votre attribut. Si seules certaines instances de votre attribut sont uniques, retournez une valeur à partir de Attribute.TypeId laquelle retournerait l’égalité dans ces cas. Par exemple, certains attributs ont un paramètre de constructeur qui agit comme une clé unique. Pour ces attributs, retournez la valeur du paramètre constructeur de la Attribute.TypeId propriété.

Notes

L’implémentation par défaut de Attribute.TypeId retourne l’identité de type, quelle que soit la valeur de la AttributeUsageAttribute.AllowMultiple propriété. Pour retourner plusieurs instances d’un AttributeUsageAttribute.AllowMultiple attribut à partir du AttributeCollection, votre attribut doit remplacer la Attribute.TypeId propriété.

Voir aussi

S’applique à

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éé.

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

Paramètres

component
Object

Composant pour lequel vous souhaitez obtenir les attributs.

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.

Retours

AttributeCollection

AttributeCollection avec les attributs pour le composant. Si le composant est null, la méthode retourne une collection vide.

Remarques

Les attributs retournés par la GetAttributes méthode peuvent être modifiés dynamiquement à partir de la liste source des composants d’origine par les fournisseurs d’extendeurs (), les services de filtre (IExtenderProviderITypeDescriptorFilterService) et les filtres d’attributs.

Lorsque vous définissez un attribut personnalisé avec AttributeUsageAttribute.AllowMultiple la valeur définie true, vous devez remplacer la Attribute.TypeId propriété pour la rendre unique. Si toutes les instances de votre attribut sont uniques, remplacez Attribute.TypeId pour renvoyer l’identité d’objet de votre attribut. Si seules certaines instances de votre attribut sont uniques, retournez une valeur à partir de Attribute.TypeId laquelle retournerait l’égalité dans ces cas. Par exemple, certains attributs ont un paramètre de constructeur qui agit comme une clé unique. Pour ces attributs, retournez la valeur du paramètre constructeur de la Attribute.TypeId propriété.

Notes

L’implémentation par défaut de Attribute.TypeId retourne l’identité de type, quelle que soit la valeur de la AttributeUsageAttribute.AllowMultiple propriété. Pour retourner plusieurs instances d’un AttributeUsageAttribute.AllowMultiple attribut à partir du AttributeCollection, votre attribut doit remplacer la Attribute.TypeId propriété.

Voir aussi

S’applique à