Поделиться через


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

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

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

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

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

b2s063f7.alert_note(ru-ru,VS.90).gifПримечание.

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

Содержание

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

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

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

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

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

См. также

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

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