Partager via

Attributs dans les contrôles Windows Forms

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

Avertissement

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 contrôle et de composant

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 qui utilise un grand nombre de ces attributs, consultez Guide pratique pour appliquer des attributs dans les contrôles Windows Forms.

Caractéristique Descriptif
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 d’une propriété, d’un événement ou public void d’une méthode qui ne prend 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 textuelle 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 présente les attributs que vous pouvez appliquer pour spécifier la façon dont vos contrôles et composants personnalisés interagissent avec la liaison de données.

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

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.

Caractéristique Descriptif
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

  • Last updated on