Compartilhar via


Recomendado marcas XML para comentários da documentação (Visual Basic)

The Visual Basic compiler can process documentation comments in your code to an XML file. You can use additional tools to process the XML file into documentation.

XML comments are allowed on code constructs such as types and type members. For partial types, only one part of the type can have XML comments, although there is no restriction on commenting its members.

ObservaçãoObservação

Documentation comments cannot be applied to namespaces. The reason is that one namespace can span several assemblies, and not all assemblies have to be loaded at the same time.

The compiler processes any tag that is valid XML. The following tags provide commonly used functionality in user documentation.

<c>

<code>

<example>

<exceção>1

<include>1

<list>

<para>

<param>1

<paramref>

<permissão>1

<remarks>

<returns>

<see>1

<seealso>1

<summary>

<typeparam>1

<value>

(1 o compilador verifica a sintaxe.)

ObservaçãoObservação

If you want angle brackets to appear in the text of a documentation comment, use &lt; and &gt;. For example, the string "&lt;text in angle brackets&gt;" will appear as <text in angle brackets>.

Consulte também

Tarefas

Como: criar documentação XML no Visual Basic

Referência

/doc

Conceitos

Documentando Seu Código com XML (Visual Basic)