Compartilhar via


Marcas 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 nenhuma 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 marca que seja XML válida. As seguintes marcas fornecem as funcionalidades geralmente usadas na documentação do usuário.

(1 O compilador verifica a sintaxe.)

Observação

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

Consulte também