<list> (Visual Basic)
Define uma lista ou tabela.
Sintaxe
<list type="type">
<listheader>
<term>term</term>
<description>description</description>
</listheader>
<item>
<term>term</term>
<description>description</description>
</item>
</list>
Parâmetros
type
O tipo da lista. Deve ser um "marcador" para uma lista com marcadores, "número" para uma lista numerada ou "tabela" para uma tabela de duas colunas.
term
Usado apenas quando type
é "tabela". Um termo a definir, que é definido na tag description.
description
Quando type
é "marcador" ou "número", description
é um item na lista Quando type
é "tabela", description
é a definição de term
.
Observações
O <listheader>
bloco define o título de uma tabela ou lista de definições. Ao definir uma tabela, você só precisa fornecer uma entrada para term
o título.
Cada item da lista é especificado com um <item>
bloco. Ao criar uma lista de definições, você deve especificar e term
description
. No entanto, para uma tabela, lista com marcadores ou lista numerada, você só precisa fornecer uma entrada para description
.
Uma lista ou tabela pode ter quantos <item>
blocos forem necessários.
Compile com -doc para processar comentários de documentação para um arquivo.
Exemplo
Este exemplo usa a <list>
tag para definir uma lista com marcadores na seção de comentários.
''' <remarks>Before calling the <c>Reset</c> method, be sure to:
''' <list type="bullet">
''' <item><description>Close all connections.</description></item>
''' <item><description>Save the object state.</description></item>
''' </list>
''' </remarks>
Public Sub Reset()
' Code goes here.
End Sub