2008-09-15 7 views
32

В тегах документации C# вы можете производить вывод, похожий на MSDN. Каков список допустимых тегов для использования в области комментариев /// (тройная косая черта) над классами, методами и свойствами?Каковы теги документации C#?

ответ

6

Заканчивать Great documentation on the various C# XML documentation tags. (Перейти вниз, чтобы увидеть метки)

+7

Увы, домен пропустил, и это неработающая ссылка. – 2010-03-19 00:41:14

+0

Хорошо, что воняет - в кеше Google все еще есть, но как долго, кто знает? – 2010-03-19 02:11:15

+1

Я предполагаю, что это так же, как JavaDocs, когда вы публикуете это на веб-странице. Более обновленная ссылка здесь: http://msdn.microsoft.com/en-us/library/b2s063f7.aspx – puretppc 2014-01-27 02:21:21

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.

Смежные вопросы