Processando o arquivo XML (Visual Basic)

O compilador gera uma sequência de identificação para cada constructo no seu código que está marcado para gerar a documentação.(Para obter informações sobre como marcar seu código, consulte Recomendado marcas XML para comentários da documentação (Visual Basic).) A sequência de caracteres ID identifica exclusivamente o constructo.Programas que processam o arquivo XML podem usar a sequência de identificação para identificar o item metadados/reflexão.NET Framework correspondente.

O arquivo XML é não uma representação hierárquica de seu código; é uma lista simples com uma identificação gerada para cada elemento.

O compilador observa as regras a seguir quando ele gera as sequências de identificação:

• Nenhum espaço em branco é colocado na sequência de caracteres.

• A primeira parte da sequência de identificação identifica o tipo de participante que está sendo identificada, com um único caractere seguido por dois pontos.Os seguintes tipos membro são usados.

  Caracterer	Descrição
  N	namespace Não é possível adicionar comentários de documentação a um espaço de nomes, mas você pode fazer referências CREF a eles, onde for suportado.
  T	tipo: Class, Module, Interface, Structure, Enum, Delegate
  F	campo: Dim
  P	propriedade: Property (incluindo propriedades padrão)
  M	método: Sub, Function, Declare, Operator
  E	evento: Event
  !	sequência de caracteres de erro O restante da sequência de caracteres fornece informações sobre o erro.O compilador Visual Basic gera informações de erro para links que não podem ser resolvidos.

• A segunda parte da String é o nome totalmente qualificado do item, começando a raiz do namespace.O nome do item, seus tipos delimitador(es) e o espaço de nomes são separados por pontos.Se o próprio nome do item contiver períodos, elas serão substituídos pelo sinal de número (#).Pressupõe-se que nenhum item possui um sinal de número diretamente no seu nome.Por exemplo, o nome totalmente qualificado do construtor String seria System.String.#ctor.

• Para propriedades e métodos, se houver argumentos para o método, a lista de argumentos colocados entre parênteses segue.Se não houver nenhum argumento, nenhum parêntese estará presenteOs argumentos são separados por vírgulas.A codificação de cada argumento segue diretamente como ela é codificada em uma assinatura .NET Framework .

Exemplo

O código a seguir mostra como a identificação sequências de caracteres de uma classe e seus membros são gerados.

Namespace SampleNamespace

  ''' <summary>Signature is 
  ''' "T:SampleNamespace.SampleClass"
  ''' </summary>
  Public Class SampleClass

    ''' <summary>Signature is 
    ''' "M:SampleNamespace.SampleClass.#ctor"
    ''' </summary>
    Public Sub New()
    End Sub

    ''' <summary>Signature is 
    ''' "M:SampleNamespace.SampleClass.#ctor(System.Int32)"
    ''' </summary>
    Public Sub New(ByVal i As Integer)
    End Sub

    ''' <summary>Signature is 
    ''' "F:SampleNamespace.SampleClass.SampleField"
    ''' </summary>
    Public SampleField As String

    ''' <summary>Signature is 
    ''' "F:SampleNamespace.SampleClass.SampleConstant"
    ''' </summary>
    Public Const SampleConstant As Integer = 42

    ''' <summary>Signature is 
    ''' "M:SampleNamespace.SampleClass.SampleFunction"
    ''' </summary>
    Public Function SampleFunction() As Integer
    End Function

    ''' <summary>Signature is 
    ''' "M:SampleNamespace.SampleClass.
    ''' SampleFunction(System.Int16[],System.Int32[0:,0:])"
    ''' </summary>
    Public Function SampleFunction( _
        ByVal array1D() As Short, _
        ByVal array2D(,) As Integer) _
        As Integer
    End Function

    ''' <summary>Signature is 
    ''' "M:SampleNamespace.SampleClass. 
    ''' op_Addition(SampleNamespace.SampleClass,
    '''             SampleNamespace.SampleClass)"
    ''' </summary>
    Public Shared Operator +( _
        ByVal operand1 As SampleClass, _
        ByVal operand2 As SampleClass) _
        As SampleClass

      Return Nothing
    End Operator

    ''' <summary>Signature is 
    ''' "P:SampleNamespace.SampleClass.SampleProperty"
    ''' </summary>
    Public Property SampleProperty() As Integer
      Get
      End Get
      Set(ByVal value As Integer)
      End Set
    End Property

    ''' <summary>Signature is
    ''' "P:SampleNamespace.SampleClass.Item(System.String)"
    ''' </summary>
    Default Public ReadOnly Property Item( _
        ByVal s As String) As Integer

      Get
      End Get
    End Property

    ''' <summary>Signature is 
    ''' "T:SampleNamespace.SampleClass.NestedClass"
    ''' </summary>
    Public Class NestedClass
    End Class

    ''' <summary>Signature is 
    ''' "E:SampleNamespace.SampleClass.SampleEvent(System.Int32)"
    ''' </summary>
    Public Event SampleEvent As SampleDelegate

    ''' <summary>Signature is 
    ''' "T:SampleNamespace.SampleClass.SampleDelegate"
    ''' </summary>
    Public Delegate Sub SampleDelegate(ByVal i As Integer)
  End Class
End Namespace

Consulte também

Tarefas

Como: Criar documentação XML no Visual Basic

Referência

/doc

Date	History	Motivo
Julho de 2008	Exemplo de código revisado.	Comentários do cliente.