Documentation XML de Visual Studio 2008
-
20-08-2019 - |
Question
Je n'arrive pas à trouver le " Build " option sous " Propriétés de configuration " dossier dans les pages de propriétés de mon projet. J'ai cherché partout à essayer de comprendre comment le faire.
J'ai suivi les instructions ici: http://msdn.microsoft.com /en-us/magazine/cc302121.aspx
Plus spécifiquement ici: http://msdn.microsoft.com/en -us / library / azt1z1eh.aspx (" création de l'exemple de documentation XML dans la section Visual Studio ")
Je souhaite générer des commentaires XML pour mon projet dans la construction, mais mes " Propriétés de la configuration " La fenêtre ne contient pas & "; dossiers &"; ou un " Build " option en dessous.
J'utilise Visual Studio Team System 2008, des idées?
EDIT - > C'est un site Web [sans projet] écrit en C # et VB.NET.
Dois-je télécharger des outils? J'ai trouvé GhostDoc mais cela ne m'aide pas beaucoup.
La solution
Je ne suis pas sûr de comprendre ce que vous entendez par & "Propriétés de la configuration &"; dossier. Je n'ai rien de tel - si je double-clique simplement sur & "Propriétés &"; sous le projet (dans l'Explorateur de solutions), la page de propriétés contenant les onglets suivants (pour une application console sous VS 2008 Pro) s'affiche:
- Application
- Construire
- Créer des événements
- Déboguer
- Ressources
- Services
- Paramètres
- Chemins de référence
- Signature
- Sécurité
- publier
Cela ressemble-t-il à l'écran que vous regardez? Pouvez-vous prendre une capture d'écran de ce que vous avez?
Si vous double-cliquez simplement sur & "Propriétés &"; qu'est-ce que vous obtenez?
Autres conseils
Utilisez-vous C # ou VB.NET? Dans VB.NET, les pages de propriétés sont un peu différentes. La page de propriétés Compile contient une case à cocher indiquant & "Générer le fichier de documentation XML &"; Assurez-vous que c'est coché.
J'ai un service Web pour lequel j'aimerais créer ce type de documentation. C'est aussi un projet de site Web, donc je n'ai pas le menu. Une solution a-t-elle été trouvée pour cette situation?
Cliquez avec le bouton droit de la souris sur une bibliothèque de classe de votre projet et sélectionnez les propriétés, puis l'option de construction de l'onglet ... permet de spécifier le chemin du fichier de documentation xml. -ibrahim
L'article de magazine MSDN auquel vous faites référence est obsolète. Le lien vers la documentation de 2008 et 2010 a été mis à jour et fournit les instructions appropriées.
Activez les commentaires XML en choisissant Projet | Propriétés dans le menu et passage à la page Créer . Vous remarquerez peut-être qu'avec de nombreux moniteurs, vous devrez faire défiler la page Construire avant de trouver la section sur les commentaires XML.
Il est logique de pouvoir créer des documents pour un service Web (un projet de site Web), car ils seront utilisés par un tiers. Les documents XML peuvent être utilisés par l'appelant de service Web via WSDL à l'aide du flux wcfextras . Est-ce que cela signifie que je dois séparer ma solution consistant en seulement deux fichiers .cs dans un projet séparé afin d'obtenir le document ou existe-t-il un autre moyen? Merci.