Комментарии XML-документации (Руководство по программированию в C#)

Обновлен: Ноябрь 2007

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

/// <summary>
///  This class performs an important function.
/// </summary>
public class MyClass{}

При выполнении компиляции с параметром /doc компилятор выполнит поиск всех тегов XML в исходном коде и создаст файл документации XML.

Примечание.
Комментарии XML-документации не являются метаданными. Они не включаются в скомпилированную сборку, и поэтому к ним нельзя обратиться посредством отражения.

Содержание

• Рекомендуемые теги для комментариев документации

• Обработка XML-файла

• Разделители для тегов документации

• Практическое руководство. Использование XML-документации

Связанные разделы

Дополнительные сведения см. в следующих разделах:

• /doc (обработка комментариев документации)

• Пример XML-документации

Спецификация языка C#

Дополнительные сведения см. в следующих разделах документа Спецификация языка C#:

• Приложение А. Комментарии документации

См. также

Основные понятия

Руководство по программированию в C#