XML-документация Visual Studio 2008
-
20-08-2019 - |
Вопрос
Кажется, я не могу найти опцию "Построить" в папке "Свойства конфигурации" на страницах свойств моего проекта.Я искал повсюду, пытаясь понять, как это сделать.
Я следил за приведенными здесь указаниями: http://msdn.microsoft.com/en-us/magazine/cc302121.aspx
Более конкретно здесь: http://msdn.microsoft.com/en-us/library/azt1z1eh.aspx (Раздел "Создание образца документации XML в Visual Studio")
Я хочу сгенерировать XML-комментарии для моего проекта в сборке, но в моем окне "Свойства конфигурации" нет "папок" или опции "Сборка" под ним.
Я использую Visual Studio Team System 2008, есть идеи?
РЕДАКТИРОВАТЬ -> Это веб-сайт [без проекта], и он написан как на C #, так и на VB.NET.
Нужно ли мне загружать какие-либо инструменты?Я нашел GhostDoc, но это мне не очень помогает.
Решение
Я не уверен, что вы подразумеваете под папкой «Свойства конфигурации».У меня нет ничего подобного - если я просто дважды щелкну «Свойства» в проекте (в обозревателе решений), появится страница свойств со следующими вкладками (для консольного приложения в VS 2008 Pro):
- Приложение
- Строить
- Создание событий
- Отлаживать
- Ресурсы
- Услуги
- Настройки
- Ссылочные пути
- Подписание
- Безопасность
- Публиковать
Это похоже на экран, на который вы смотрите?Можете ли вы сделать скриншот того, что у вас есть?
Если вы просто дважды щелкните «Свойства», что вы получите?
Другие советы
Вы используете C# или VB.NET?В VB.NET страницы свойств выглядят немного иначе.На странице свойств компиляции есть флажок «Создать файл документации XML».Убедитесь, что он отмечен.
У меня есть веб-сервис, для которого я хотел бы создать такого рода документацию.Это также веб-проект, поэтому у меня нет меню.Было ли найдено решение для этой ситуации?
щелкните правой кнопкой мыши любую библиотеку классов вашего проекта и выберите свойства, после чего вы найдете вкладку «Сборка»...там вы можете указать путь к файлу документации xml.-Ибрагим
Статья в журнале MSDN, на которую вы ссылаетесь, устарела.Ссылка на документацию 2008 и 2010 годов была обновлена и содержит соответствующие указания.
Включите XML-комментарии, выбрав Проект | Свойства из меню и переходя к Строить Страница.Вы можете заметить, что на многих мониторах вам придется прокручивать страницу вниз по Строить страницу перед поиском раздела о комментариях XML.
Имеет смысл создавать документы для веб-сервиса (проекта веб-сайта), поскольку они будут использоваться третьей стороной.XML-документы могут быть использованы вызывающей стороной веб-службы через wsdl, используя команду wcfextras поток.Означает ли это, что я должен вынести свое решение, состоящее всего из двух файлов .cs, в отдельный проект, чтобы просто получить документ, или есть другой способ?Спасибо.