Discussion :

[FRED.G]

Hello,

J'aimerais savoir s'il existe des balises XML que je pourrais insérer entre les balises <summary> pour faire référence à des types CLR (ainsi que leur membres).

Ainsi le nom de ces types seraient automatiquement mis à jour dans mes commentaires en cas de renomage dans mon projet ...

Par exemple, imaginons une classe nommée Personne qui contient une propriété Name.
Puis admettons que j'ai ce commentaire quelque part dans une classe :

Code vb.net :

Sélectionner tout - Visualiser dans une fenêtre à part

1
2
3
4
    ''' <summary>
    ''' Collection contenant des objets Personne.
    ''' Les objets Personne ont une propriété Name.
    ''' </summary>

Si je renomme ma classe Personne en "Contact" et/ou sa propriété Name en "Prénom", mon commentaire ne sera pas mis à jour comme ceci :

Code vb.net :

Sélectionner tout - Visualiser dans une fenêtre à part

1
2
3
4
    ''' <summary>
    ''' Collection contenant des objets Contact.
    ''' Les objets Contact ont une propriété Prénom.
    ''' </summary>

A moins de le faire manuellement bien sûr...

Donc y a-t-il un moyen de faire référence à des types ou leur membres à l'intérieur de balises <summary> ?

[Thomas Lebrun]

Euh là, je crois que tu en demandes bcp.....

[FRED.G]

Dommage ...

Un moment j'ai cru que c'était bon avec les balises <see cref="MonType"></see>.

Tanpis !