Comprendre le problème : Valeurs de propriété par défaut dans les contrôles hérités

Lors de l’utilisation de contrôles hérités dans Visual Studio, définir des valeurs de propriété par défaut peut être un défi courant. Cela se produit souvent lorsque vous souhaitez que votre contrôle personnalisé ait une nouvelle valeur par défaut, mais que la classe de base définit une valeur par défaut différente. Par exemple, disons que vous créez un contrôle de boîte combinée personnalisé dérivé de System.Windows.Forms.ComboBox et que vous souhaitez que la propriété DropDownItems par défaut soit de 50 au lieu de sa valeur d’origine.

Le problème à résoudre

Lorsque vous dérivez une classe et définissez la propriété dans votre constructeur, comme ceci :

class NewCombo : System.Windows.Forms.ComboBox
{
    public NewCombo() { DropDownItems = 50; }
}

En glissant le contrôle dans un formulaire, Visual Studio génère automatiquement un fichier de code designer comme mycontrol.DropDownItems = 50;. Cela n’est pas intrinsèquement problématique tant que vous ne décidez pas de changer cette valeur plus tard. Si vous mettez à jour le constructeur à :

DropDownItems = 45;

Vous faites toujours face au problème que tous les contrôles placés précédemment conserveront leur valeur codée en dur de 50 dans les fichiers de designer. Cela va à l’encontre de l’objectif d’avoir une source unique pour vos valeurs par défaut, compliquant ainsi la maintenance et les futures mises à jour.

Trouver une solution : Écraser les propriétés et appliquer des attributs

Pour aborder ce problème de manière efficace, vous pouvez soit écraser soit masquer la propriété dans votre classe dérivée et réappliquer l’attribut de valeur par défaut. Voici comment vous pouvez y parvenir :

Guide étape par étape

1. Définir une nouvelle propriété

Pour écraser efficacement la propriété par défaut DropDownItems, suivez ces étapes dans votre classe de contrôle personnalisé :

class NewCombo : System.Windows.Forms.ComboBox
{
    [System.ComponentModel.DesignerSerializationVisibility(System.ComponentModel.DesignerSerializationVisibility.Visible)]
    public new int DropDownItems
    {
        get { return base.DropDownItems; }
        set { base.DropDownItems = value; }
    }

    public NewCombo()
    {
        DropDownItems = 50; // Définissez votre nouvelle valeur par défaut
    }
}

2. Annoter avec DesignerSerializationVisibility

En utilisant l’attribut DesignerSerializationVisibility, vous influencez la manière dont les propriétés sont sérialisées dans le designer. Dans ce cas :

• Visible indique que cette propriété doit être visible dans le designer.
• La définir comme new permet de masquer efficacement l’implémentation de base.

3. Contrôler le comportement dans le designer

Cette approche garantit que chaque instance de NewCombo respecte la valeur par défaut que vous avez définie dans le constructeur, permettant des mises à jour faciles si besoin.

Points clés à retenir

• Écraser/Masquer la propriété : Utilisez le mot-clé new pour créer votre propriété et définir la valeur par défaut comme requis.
• Attributs du designer : Utilisez des attributs tels que DesignerSerializationVisibility pour dicter le comportement des propriétés dans le designer de Visual Studio.

Conclusion

En suivant ces techniques, vous pouvez gérer efficacement les valeurs de propriété par défaut pour les contrôles hérités dans Visual Studio. Cela simplifie non seulement votre processus de développement, mais garantit également que votre code reste maintenable et adaptable aux changements demandés par les clients ou aux exigences du projet.

Maintenant, vous pouvez profiter de la flexibilité d’avoir des propriétés par défaut centralisées sans vous soucier des valeurs codées en dur dans les fichiers de designer !