Discussion :

[jowsuket]

Bonjour,

Je souhaiterai générer la documentation xml de mon code c# pour un projet web sous visual studio.

Pour le faire sur un projet c# normal je n'est pas de soucis (en suivant MSDN) :

1. Un projet étant sélectionné dans l'Explorateur de solutions, cliquez dans le menu Projet sur Propriétés.
2. Cliquez sur l'onglet Générer.
3. Sur la page Générer, sélectionnez Fichier de documentation XML. Par défaut, le fichier est créé sous le chemin de sortie spécifié, par exemple, « bin\Debug\Nomprojet.XML ».

Mais dans un projet de site web je n'ai pas ce menu... Existe-t-il un moyen de générer la documentation xml d'un projet web?

[tomlev]

Bizarre que ce ne soit pas prévu... sinon tu dois pouvoir le faire avec la ligne de commande (csc.exe)

[Philippe Vialatte]

Si c'est encore comme pour VS2005....tu peux pas

En fait, (une fois de plus, je parle cote 2005), si tu veux une doc pour ton projet web, il faut que ce soit une web application...

[jowsuket]

J'ai bien testé la commande csc mais j'ai un soucis quand je l'exécute sur une classe qui contient une instanciation d'une autre classe. Exemple :

csc /doc:Chien.xml Chien.cs

ne marche pas si dans une méthode de 'Chien' j'ai une instanciation de 'Patte' par exemple (super l'exemple )
Enfin bref j'ai une erreur du style :

Le type ou le nom d'espace de noms 'Patte' est introuvable (une directive using ou une référence d'assembly est-elle manquante ?)

Et si j'arrivais à faire marcher cette commande je suppose qu'il faudrait faire une sorte de batch pour l'exécuter sur toutes mes classe (ce qui est un peut fastidieux à maintenir je pense)

Je reste alors ouvert à toutes suggestions ou solutions sur le sujet

[tomlev]

Il faut que tu le fasses pour tous les fichiers à la fois, en mettant les références (/reference: ou /r:) vers les assemblies que tu utilises