Attributs dans les contrôles Windows Forms

  • Article

.NET Framework fournit divers attributs que vous pouvez appliquer aux membres de vos composants et contrôles personnalisés. Certains de ces attributs affectent le comportement d’exécution d’une classe, et d’autres affectent le comportement au moment de la conception.

Attention

Ce contenu a été écrit pour .NET Framework. Si vous utilisez .NET 6 ou une version ultérieure, utilisez ce contenu avec prudence. Le système de concepteur a changé pour Windows Forms et il est important de passer en revue les modifications apportées au Concepteur depuis l’article .NET Framework .

Attributs pour les propriétés de composant et de contrôle

Le tableau suivant décrit les attributs que vous pouvez appliquer aux propriétés ou aux autres membres de vos composants et contrôles personnalisés. Pour obtenir un exemple d’utilisation de ces attributs, consultez Comment : appliquer des attributs dans les contrôles Windows Forms.

Attribut Description
AmbientValueAttribute Spécifie la valeur à passer à une propriété pour que celle-ci obtienne sa valeur à partir d’une autre source. On appelle cela l’ambiance.
BrowsableAttribute Spécifie si une propriété ou un événement doit être affiché dans une fenêtre Propriétés.
CategoryAttribute Spécifie le nom de la catégorie dans laquelle regrouper la propriété ou l’événement lorsqu’elle est affichée dans un PropertyGrid contrôle défini sur Categorized mode.
DefaultValueAttribute Spécifie la valeur par défaut d'une propriété.
DescriptionAttribute Spécifie une description pour une propriété ou un événement.
DisplayNameAttribute Spécifie le nom d’affichage complet pour une propriété, un événement, ou une méthode public void qui n’accepte aucun argument.
EditorAttribute Spécifie l’éditeur à utiliser pour modifier une propriété.
EditorBrowsableAttribute Spécifie qu'une propriété ou une méthode peut s'afficher dans un éditeur.
HelpKeywordAttribute Spécifie le mot clé du contexte pour une classe ou un membre.
LocalizableAttribute Spécifie si une propriété doit être localisée.
PasswordPropertyTextAttribute Indique que la représentation sous forme de texte d’un objet est masquée par des caractères tels que des astérisques.
ReadOnlyAttribute Spécifie si la propriété de cet attribut est liée est en lecture seule ou lecture/écriture au moment de la conception.
RefreshPropertiesAttribute Indique que la grille de propriétés doit s’actualiser lorsque la valeur de propriété associée change.
TypeConverterAttribute Spécifie le type à utiliser comme convertisseur de l'objet auquel cet attribut est lié.

Attributs pour les propriétés de liaison de données

Le tableau suivant montre les attributs que vous pouvez appliquer pour spécifier la façon dont vos composants et contrôles personnalisés interagissent avec la liaison de données.

Attribut Description
BindableAttribute Spécifie si une propriété est généralement utilisée pour la liaison.
ComplexBindingPropertiesAttribute Spécifie la source de données et les propriétés de membre de données pour un composant.
DefaultBindingPropertyAttribute Spécifie la propriété de liaison par défaut pour un composant.
LookupBindingPropertiesAttribute Spécifie la source de données et les propriétés de membre de données pour un composant.
AttributeProviderAttribute Active la redirection d’attribut.

Attributs pour les classes

Le tableau suivant montre les attributs que vous pouvez appliquer pour spécifier le comportement de vos composants et contrôles personnalisés au moment de la conception.

Attribut Description
DefaultEventAttribute Spécifie l’événement par défaut d’un composant.
DefaultPropertyAttribute Spécifie la propriété par défaut d’un composant.
DesignerAttribute Spécifie la classe utilisée pour implémenter des services au moment de la conception pour un composant.
DesignerCategoryAttribute Spécifie que le concepteur pour une classe appartient à une certaine catégorie.
ToolboxItemAttribute Représente un attribut d’un élément de boîte à outils.
ToolboxItemFilterAttribute Spécifie la chaîne de filtrage et le type de filtre à utiliser pour un élément de boîte à outils.

Voir aussi