Attribut Description pour une collection

Version imprimable

Bonjour,

La question va sans doute paraitre simple, et ce n'est qu'un détail... c'est d'autant plus rageant de perdre du temps dessus!

J'ai créé une userform, qui a une collection d'objet en propriété.
La classe utilisée pour la collection est définie aussi, chacune des propriétés a des attributs Category et Description, par exemple :
Code:

1 2 3 [Category("Configuration"), Description("Libellé pour recherche et en-tête")] public string titreColonne { get; set; }
Dans Visual Studio (2015), j'utilise mon composant, j'accède via le menu aux propriétés, ouvre ma collection, ajoute un objet. Les propriétés sont bien listées.
Mais par contre aucune catégorie affichée. Aucune description non plus...
Google n'a pas été mon ami sur ce coup.

Ou est mon erreur? Est-ce d'autres attributs qu'il faut utiliser? Ou les utiliser différemment? Ou...

Merci de votre aide.

*** Edit : lorsque je renseigne la collection sur ma form via le menu de Visual Studio, elle n'est pas enregistrée. Du coup, mon erreur doit être ailleurs... voici un bout de code plus complet :
Code:

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 public partial class Dyn_DataGrid : UserControl { [Category("Configuration"), Description("Options des colonnes")] public List<infoColonne> iColonne { get; set; } } public class infoColonne { [Category("Configuration"), Description("nom SQL de la colonne")] public string idColonne { get; set; } [Category("Configuration"), Description("Libellé pour recherche et en-tête")] public string titreColonne { get; set; } [Category("Configuration"), Description("Traduction éventuelle (requête SQL)")] public string Trad { get; set; } }
**** edit : Après relecture du tuto de Thomas Lebrun, j'ai tenté en vain quelques modifications.

Ajout de l'attribut DesignerSerializationVisibility(DesignerSerializationVisibility.Visible) (valeur par défaut il me semble, mais dans le doute...)
Ajout partour de l'attribut Browsable(true)

Mais rien ne change. Modifier les valeurs ne marche pas. Et pas d'affichage des catégories/descriptions sur les collections.

Bonjour

1/L'Attribut Browsable(bool) est par défaut à "true"...
Cet Attribut est utile uniquement lorsqu'on veut ne pas afficher(masquer) une propriété dans le designer VS....
L'Icone Détails de l'inspecteur de propriété est ton ami....!!!

Citation:

lorsque je renseigne la collection sur ma form via le menu de Visual Studio, elle n'est pas enregistrée. Du coup, mon erreur doit être ailleurs... voici un bout de code plus complet

2/ Attribut DesignerSerializationVisibility
- Hidden :La propriété peut être assignée sur le Designer. mais aucun code pour la propriété n'est génère dans le designer .

Cet attribut est utile si on veut que la propriété soit -uniquement utilisable dans le code- par l'user du control ....
-Content : La propriété peut être assignée sur le Designer ,le code pour la propriété ainsi que le code d'assignation de sa valeur sont génères dans le designer .
Cet attribut est utile si on veut conserver la valeur à l'exécution car le code génère est "sérialise" (conserve à l'exécution)....

-Visible : à ne pas utiliser ....
Cet attribut est utile dans un CodeDom Seriliazer car il sérialise le code C# : code des getter & setters de la propriété ...

ton code revu avec l'initialisation de la propreté( omise ):

Code:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
 
 
 public partial class Dyn_DataGrid : UserControl
    {
        public Dyn_DataGrid()
        {
            InitializeComponent();
        }
        private List<infoColonne> _iColonne = new List<infoColonne>();
        [Browsable(true)]
        [Category("Configuration"), Description("Options des colonnes")]
        [DesignerSerializationVisibility(DesignerSerializationVisibility.Content)]
        public List<infoColonne> iColonne 
        {
            get { return _iColonne ; }
            set { _iColonne  = value; }
        }
 
 
 
 
 
    }

coup d'oeil à l'extrait du code du Designer (fichier Form2.Designer.cs) :
1/HIDDEN

Code:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
 
 
 
private void InitializeComponent()
        {
            this.dyn_DataGrid1 = new WinSousBinding.Dyn_DataGrid();
            this.SuspendLayout();
            // 
            // dyn_DataGrid1
            // 
            this.dyn_DataGrid1.Location = new System.Drawing.Point(53, 48);
            this.dyn_DataGrid1.Name = "dyn_DataGrid1";
            this.dyn_DataGrid1.Size = new System.Drawing.Size(150, 150);
            this.dyn_DataGrid1.TabIndex = 2;
            // 
            // Form2
            // 
            this.AutoScaleDimensions = new System.Drawing.SizeF(6F, 13F);
            this.AutoScaleMode = System.Windows.Forms.AutoScaleMode.Font;
            this.ClientSize = new System.Drawing.Size(544, 320);
            this.Controls.Add(this.dyn_DataGrid1);
            this.Name = "Form2";
            this.Text = "Form2";
            this.Load += new System.EventHandler(this.Form2_Load);
            this.ResumeLayout(false);
 
        }
 
        #endregion
 
        private Dyn_DataGrid dyn_DataGrid1;

2/Content(ce code est genere des qu'on assigne des valleurs à la liste)

Code:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
 
 
 private void InitializeComponent()
        {
            WinSousBinding.infoColonne infoColonne1 = new WinSousBinding.infoColonne();
            WinSousBinding.infoColonne infoColonne2 = new WinSousBinding.infoColonne();
            WinSousBinding.infoColonne infoColonne3 = new WinSousBinding.infoColonne();
            this.dyn_DataGrid1 = new WinSousBinding.Dyn_DataGrid();
            this.SuspendLayout();
            // 
            // dyn_DataGrid1
            // 
            this.dyn_DataGrid1.BackColor = System.Drawing.SystemColors.ControlDark;
            infoColonne1.idColonne = null;
            infoColonne1.titreColonne = null;
            infoColonne1.Trad = null;
            infoColonne2.idColonne = null;
            infoColonne2.titreColonne = null;
            infoColonne2.Trad = null;
            infoColonne3.idColonne = null;
            infoColonne3.titreColonne = null;
            infoColonne3.Trad = null;
            this.dyn_DataGrid1.iColonne.Add(infoColonne1);
            this.dyn_DataGrid1.iColonne.Add(infoColonne2);
            this.dyn_DataGrid1.iColonne.Add(infoColonne3);
            this.dyn_DataGrid1.Location = new System.Drawing.Point(125, 44);
            this.dyn_DataGrid1.Name = "dyn_DataGrid1";
            this.dyn_DataGrid1.Size = new System.Drawing.Size(150, 150);
            this.dyn_DataGrid1.TabIndex = 0;
            // 
            // Form2
            // 
            this.AutoScaleDimensions = new System.Drawing.SizeF(6F, 13F);
            this.AutoScaleMode = System.Windows.Forms.AutoScaleMode.Font;
            this.ClientSize = new System.Drawing.Size(544, 320);
            this.Controls.Add(this.dyn_DataGrid1);
            this.Name = "Form2";
            this.Text = "Form2";
            this.Load += new System.EventHandler(this.Form2_Load);
            this.ResumeLayout(false);
 
        }
 
        #endregion
 
        private Dyn_DataGrid dyn_DataGrid1;

bon code ...

23/09/2016, 09h50
ZenZiTone

Citation:

Envoyé par Shampra

Dans Visual Studio (2015), j'utilise mon composant, j'accède via le menu aux propriétés, ouvre ma collection, ajoute un objet. Les propriétés sont bien listées.
Mais par contre aucune catégorie affichée. Aucune description non plus...
Google n'a pas été mon ami sur ce coup.

Ou est mon erreur? Est-ce d'autres attributs qu'il faut utiliser? Ou les utiliser différemment? Ou...

Je me trompe peut-être, mais je pense que tu as mal interprété le comportement de ces métadonnées. La catégorie permet l'ordonnancement dans la liste des propriétés du UserControl. Par défaut tu auras "Accessibilité", "Apparence", etc... Ensuite, la description correspond au petit texte en bas de la fenêtre des propriétés. Exemple pour la propriété Font : "La police utilisée pour afficher le texte dans le contrôle."
23/09/2016, 12h57
Shampra

1 pièce(s) jointe(s)

Bonjour et merci pour vos réponse :).

ZenZiTone,
Non, j'ai bien compris ça (c'est presque la seule chose de claire ^^).
Je l'utilise pour les propriétés sans problème : mes propriétés sont groupés dans une catégorie et un descriptif s'affiche en bas pour l'aide.
Sauf que pour la collection, rien de tout ça et c'est dommage.

MABROUKI,
Réponse bien complète, merci!
Pour les browsables, j'avais vu effectivement pour la valeur par défaut, mais à force de piétiner j'ai fini par les définir "dans le doute" (ce qui n'est pas idéal pour comprendre ^^).

Pour les DesignerSerializationVisibility.Content, j'en suis arrivé à ce résultat à force d'essais (et d'erreurs!), mais une explication claire reste très appréciable :).
Pour le Visible, je l'ai toujours sur les propriétés de la classe utilisée sur la liste.

Donc je dois :
- supprimer les Browsables car inutile
- supprimer les DesignerSerializationVisibility.Visible car à risque d'après ce que j'en comprends
C'est fait, ça marche toujours :).

Reste que... je n'ai toujours ni catégorie ni description lors de l'édition de la collection :(.
Voici le résultat :
Pièce jointe 221009
23/09/2016, 14h12
ZenZiTone

J'ai regardé sur d'anciens projet et j'ai la chose suivante : non pas une collection (List<T>, par exemple), mais un objet héritant de ObservableCollection. Dans ce contexte, la description et la catégorie sont bien affectés.

Pas mieux :(

Code:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
 
public partial class Dyn_DataGrid : UserControl
{
 [Category("Configuration"), Description("Options des colonnes"),DesignerSerializationVisibility(DesignerSerializationVisibility.Content)]
 public ObservableCollection<infoColonne> iColonne { get; set; }
 
 public Dyn_DataGrid()
        {
            // on ne fait rien dans le constructeur, pour pouvoir le faire après définition des property lors de la création
            InitializeComponent();
            iColonne = new ObservableCollection<infoColonne>(); // Si je ne l'initialize pas, impossible de remplir la collection ensuite
        }
...
}
 
 public class infoColonne
    {
        [Category("Configuration"), Description("nom SQL de la colonne")]
        public string idColonne { get; set; }
        [Category("Configuration"), Description("Libellé pour recherche et en-tête")]
        public string titreColonne { get; set; }
        [Category("Configuration"), Description("Traduction éventuelle (requête SQL)")]
        public string Trad { get; set; }
        [Category("Configuration"), Description("Visible ou pas")]
        private bool _isVisible = true;
        public bool isVisible
        {
            get { return _isVisible; }
            set { _isVisible = value; }
        }
        [Category("Configuration"), Description("Est-ce modifiable")]
        private bool _isModifiable = true;
        public bool isModifiable
        {
            get { return _isModifiable; }
            set { _isModifiable = value; }
        }
        [Category("Configuration"), Description("Afficher un filtre?"), Browsable(true), DesignerSerializationVisibility(DesignerSerializationVisibility.Visible)]
        private bool _isFiltrable = true;
        public bool isFiltrable
        {
            get { return _isFiltrable; }
            set { _isFiltrable = value; }
        }
    }
 
 
}

23/09/2016, 15h44
MABROUKI

bonjour
Moi j'utilise VS 2010 et je vois en cliquant sur l'Icone Détails( le plus à droite) du PropertyGrid du Designer ,affiche une catégorie Configuration ...
Les catégories sont affichées dans l'ordre alphabétique quand l'Icone Détails est cliqué...
Ceci avec un List<T>....
A moins que ce soit un coup de soleil africain ,mais l'été est terminé...!!!
23/09/2016, 16h05
MABROUKI

bonjour

Autre recommandation importante lors de la conception de control:
Le nouveau control & le Form sont dans le même projet:
1/Supprimer toujours le control droppé avant de modifier son code
2/Modifier le code
3/Régénérer la Solution
4/Dropper le control

Le nouveau control est un projet à part (lib) :
1/Supprimer toujours le control droppé avant de modifier son code
2/Supprimer sa référence dans le Projet Test du Form
3/Modifier le code
4/Régénérer le projet Lib
5/Ajouter sa référence dans le Projet Test du Form
6/Régénérer la Solution (projet Lib +Form)
7/Dropper le control

Ca s'épaissit dans le cas du projet Lib...
Sinon on s'expose au syndrome "hallucination custom control" !!!
bon code....

3/bis supprimer
30/09/2016, 09h36
Shampra

2 pièce(s) jointe(s)

Bonjour,

Merci Mabrouki. Après quelques jours sur d'autres tâches, retour à ce code.

Je cherche toujours ce que je fais mal :/.
Concernant la procédure... outch, lourd! Cela dit j'ai été forcé de le faire (effet "hallucination custom control", la première fois j'ai mis un moment à comprendre que ça venait de Visual ^^).
F6 systématique bien sûr, relance de Visual réguliers. Dropper le control... fait une fois, mais comme il faut le replacer, reconfiguer, erc à chaque fois, j'évite. Le drop n'a pas changé la donne concernant ce problème de toute façon.

Je suis en VS Community 2015, version 14.
Je n'ai pas d'icône "Détail" (promis, j'ai regardé partout plusieurs fois!), l'interface aurait changé entre VS2010 et 2015?
Dans mon cas :
- sur ma form, je sélectionne le custom control
- dans le PropertyGrid du designer, je vois bien les propriétés du control avec description et catégories
Pièce jointe 221544
- je clique sur celle de type collection (iColonne dans mon cas), ça ouvre l'éditeur de collection...
... et là, c'est le drame (ok, ptêt pas vu le gravité du problème ^^). Pas de catégorie, pas de descriptions.
Pièce jointe 221545

Le tout en List<T> mais j'ai tenté iCollection sans plus de succès. Puis bon, c'est censé marcher avec List!
Si quelqu'un a une idée, merci :).