В тегах документации C# вы можете производить вывод, похожий на MSDN. Каков список допустимых тегов для использования в области комментариев /// (тройная косая черта) над классами, методами и свойствами?Каковы теги документации C#?
32
A
ответ
6
Заканчивать Great documentation on the various C# XML documentation tags. (Перейти вниз, чтобы увидеть метки)
3
MSDN статья с 2002 года с подробным описанием всех тегов и когда использовать их:
2
Смотрите прекрасную статью MSDN here как ваша первая остановка.
3
GhostDoc помогает создать комментарий для вашего метода/класса.
12
Если вы напечатаете это чуть выше методы или класса, IntelliSense должен подсказать вам список доступных тегов:
/// <
10
Вот список:
- резюме
- пары
- пример
- код
- см
- seealso
- список
- значение
- файл
- авторских
Вот пример:
<file> <copyright>(c) Extreme Designers Inc. 2008.</copyright> <datecreated>2008-09-15</datecreated> <summary> Here's my summary </summary> <remarks> <para>The <see cref="TextReader"/> can be used in the following ways:</para> <list type="number"> <item>first item</item> <item>second item</item> </list> </remarks> <example> <code> System.Console.WriteLine("Hello, World"); </code> </example> <param name="aParam">My first param</param> <returns>an object that represents a summary</returns> </file>
1
Просмотр Документов для Sandcastle. Это новый стандарт документации для .NET.
Смежные вопросы
- 1. Какие теги WSDL могут иметь тег документации?
- 2. документации комментарии в C#: Каковы технические причины предпочитать /// или/**
- 3. Каковы эти //! + //! - теги в golang?
- 4. Flickr API: Каковы теги «видения»?
- 5. Что означают теги документации PHP: # @ + и # @ -
- 6. Objective-C: создание документации
- 7. C++ документации шаблоны
- 8. О документации по C
- 9. Примеры документации C#
- 10. Каковы приемлемые теги в тегах заголовков?
- 11. Каковы допустимые теги HTML в RSS-каналах?
- 12. Каковы статусные теги, например [build | минус]
- 13. Необходимо написать сценарий, работающий под Win32, чтобы автоматически разместить теги для документации. C++/C#
- 14. Документация C# - Определенные пользователем теги
- 15. Каковы лучшие сайты документации, характерные для ASP.Net MVC2?
- 16. Теги Grails 3.0.x AJAX не указаны в документации
- 17. C# string.length от Microsoft документации
- 18. Генератор документации Visual Studio C++
- 19. Ошибка документации на C# xml
- 20. Скрытие документации XML на C#
- 21. Отрисовка документации XML-комментариев C#
- 22. Могу ли я ссылаться на перегруженный метод, используя теги документации C#?
- 23. Генератор документации для Testcomplete
- 24. Каковы основные спецификации C/C++
- 25. Хорошие примеры документации для документации
- 26. void ** в документации API
- 27. C: Каковы основные аргументы?
- 28. Каковы стандарты форматирования C#?
- 29. Теги в списке C#
- 30. Вариант документации в GitHub
Увы, домен пропустил, и это неработающая ссылка. – 2010-03-19 00:41:14
Хорошо, что воняет - в кеше Google все еще есть, но как долго, кто знает? – 2010-03-19 02:11:15
Я предполагаю, что это так же, как JavaDocs, когда вы публикуете это на веб-странице. Более обновленная ссылка здесь: http://msdn.microsoft.com/en-us/library/b2s063f7.aspx – puretppc 2014-01-27 02:21:21