Discussion :

[Jérémy Lefevre]

Bonjour à tous,

Ma question est simple,y a t'il moyen sur visual studio 2013 de générer des commentaires à chaque fois que je vais créer une fonction.
Commentaires qui me serviront à générer de la documentation avec un outil externe.

Merci

[clementmarcotte]

Bonjour,

Oui.

Pour peu que l'élément "Générer le fichier de documentation XML" dans l'onglet "Compiler" du "MyProject" soit coché (il l'est par défaut); il suffit de positionner le pointeur de souris juste en haut d'une ligne sub ou Function et de taper trois apostrophes et (presque) miracle on voit surgir quelque chose comme cela:

''' <summary>
'''
''' </summary>
''' <param name="deck"></param>
''' <returns></returns>
''' <remarks></remarks>

Tant que l'on reste entre les balises XML et que l'on a les trois apostrophes au début de chaque ligne, tout ce que l'on écrit là, se retrouve dans un fichier XML dans le bin/debug et peut-être dans le bin/release. Le fichier xml a le même nom que le projet.

Rendu là c'est une question de discipline. On peut le faire au fur et à mesure du développement, ou à la toute fin. VS est assez gentil pour tenir compte automatiquement des modifications que l'on peut faire dans ce bloc-là