Partilhar via


Tags XML recomendadas para comentários de documentação (Visual Basic)

O compilador do Visual Basic pode processar comentários de documentação em seu código para um arquivo XML. Você pode usar ferramentas adicionais para processar o arquivo XML na documentação.

Comentários XML são permitidos em construções de código, como tipos e membros de tipo. Para tipos parciais, apenas uma parte do tipo pode ter comentários XML, embora não haja restrição para comentar seus membros.

Observação

Os comentários da documentação não podem ser aplicados a namespaces. O motivo é que um namespace pode abranger vários assemblies e nem todos os assemblies precisam ser carregados ao mesmo tempo.

O compilador processa qualquer tag que seja XML válido. As tags a seguir fornecem a funcionalidade comumente usada na documentação do usuário.

(1 O compilador verifica a sintaxe.)

Observação

Se quiser que os colchetes angulares apareçam no texto de um comentário da documentação, use &lt; e &gt;. Por exemplo, a cadeia de caracteres "&lt;text in angle brackets&gt;" aparecerá como <text in angle brackets>.

Ver também