Документация XML Visual Studio 2008

Question

Я не могу найти опцию «Создать» в папке «Свойства конфигурации» на страницах свойств моего проекта. Я искал всюду, пытаясь понять, как это сделать.

Я следовал direations здесь: http://msdn.microsoft.com/en-us/magazine/cc302121.aspx

Более конкретно здесь: http://msdn.microsoft.com/en-us/library/azt1z1eh.aspx («Для того, чтобы построить образец XML документации в Visual Studio» секция)

Я хочу, чтобы генерировать комментарии XML для моего проекта в build, но в моем окне «Свойства конфигурации» нет «папок» или «Build».

Я использую Visual Studio Team System 2008, любые идеи?

EDIT -> Это сайт [project-less] и написан как на C#, так и на VB.NET.

Нужно ли мне скачать любые инструменты? Я нашел GhostDoc, но это не очень помогает мне.

Answer 1

Я не уверен, что вы подразумеваете под папкой «Свойства конфигурации». У меня нет ничего подобного: если я просто дважды нажму на «Свойства» в проекте (в обозревателе решений), появится страница свойств со следующими вкладками (для консольного приложения в VS 2008 Pro):

• Применение
• Строительные
• Строительные события
• Debug
• Ресурсы
• Услуги
• Настройки
• Эталонные Дорожки
• Подписание
• безопасности
• Опубликовать

ли этот звук ничего похожего на экране вы смотрите? Можете ли вы получить скриншот того, что у вас есть?

Если вы просто дважды нажмете «Свойства», что у вас получится?

Answer 2

Вы используете C# или VB.NET? В VB.NET страницы свойств выглядят несколько иначе. На странице свойств компиляции есть флажок, на котором указано «Сгенерировать файл документации XML». Убедитесь, что он установлен.

Answer 3

У меня есть веб-сервис, для которого я хотел бы создать такую ​​документацию. Это также проект веб-сайта, поэтому у меня нет меню. Было ли найдено решение для этой ситуации?

Answer 4

щелкните правой кнопкой мыши из любой библиотеки классов вашего проекта и выберите свойства, после чего вы увидите вкладку «Добавить вкладку» ... там вы можете указать путь к файлу документации xml. -ibrahim

Answer 5

В статье журнала MSDN вы ссылаетесь на устаревшую информацию. Ссылка на документацию 2008 и 2010 годов была обновлена ​​и дает правильные указания.

Включите комментарии XML, выбрав Проект | Свойства из меню и поворот на Сборка страница. Вы можете заметить, что со многими мониторами вам придется прокручивать страницу Build, прежде чем найти раздел о комментариях XML.

Answer 6

Имеет смысл иметь возможность создавать документы для веб-сервиса (проект веб-сайта), поскольку он будет потребляться третьим лицом. Документы XML могут быть использованы абонентом веб-службы через wsdl, используя поток wcfextras. Означает ли это, что я должен разбить свое решение, состоящее всего из двух файлов .cs в отдельный проект, чтобы просто получить документ или есть другой способ? Благодарю.