Delimitadores de marcas de documentação (guia de programação de C#)

O uso de comentários de XML doc requer delimitadores, que indicam ao compilador onde um comentário de documentação começa e termina. Você pode usar os seguintes tipos de delimitadores com as marcas de documentação XML:

• ///
  Delimitador de linha única. Este é o formulário que é mostrado nos exemplos de documentação e usado pelos modelos de projeto do Visual C#. Se houver um caractere de espaço em branco após o delimitador, esse caractere não está incluído na saída XML.

  Observação
  O IDE Visual Studio tem um recurso chamado Smart edição de comentário que insere automaticamente o <summary> e </summary> marcas e move o cursor dentro dessas marcas após digitar a /// delimitador no Editor de código. Para acessar este recurso a partir de Formatação, C#, Editor de texto, caixa de diálogo Opções em suas páginas de propriedade de projeto.

• /** */
  Delimitadores de várias linhas.

Existem algumas regras de formatação a seguir ao usar o /** */ delimitadores.

• Na linha que contém o /** delimitador, se o restante da linha é o espaço em branco, a linha não é processado para comentários. Se o primeiro caractere após o /** delimitador é o espaço em branco, o que o caractere de espaço em branco será ignorado e o restante da linha é processado. Caso contrário, todo o texto da linha após a /** delimitador é processada como parte do comentário.

• Na linha que contém o */ delimitador, se houver somente espaços em branco até o */ delimitador, essa linha é ignorado. Caso contrário, o texto da linha até o */ delimitador é processada como parte do comentário, sujeitas às regras de correspondência de padrões descrito o marcador a seguir.

• Para as linhas após a que começa com o /** delimitador, o compilador procura um padrão comum no início de cada linha. O padrão pode consistir em espaços em branco opcional e um asterisco (*), seguido de mais espaço em branco opcionais. Se o compilador encontra um padrão comum no início de cada linha que não começa com o /** delimitador ou a */ delimitador, ele ignora esse padrão para cada linha.

Os exemplos a seguir ilustram essas regras.

• A única parte do seguinte comentário que será processada é a linha que começa com <summary>. Os formatos de três marca produzem os mesmos comentários.

  /** <summary>text</summary> */ 
  
  /** 
  <summary>text</summary> 
  */ 
  
  /** 
   * <summary>text</summary> 
  */ 
  

• O compilador identifica um padrão comum de" * " no início da segunda e terceira linhas. O padrão não está incluído na saída.

  /** 
   * <summary> 
   * text </summary>*/ 
  

• O compilador não encontra nenhum padrão comum no seguinte comentário, porque o segundo caractere na terceira linha não é um asterisco. Portanto, todo o texto a segunda e terceira linhas é processado como parte do comentário.

  /** 
   * <summary> 
     text </summary>
  */ 
  

• O compilador não encontra nenhum padrão no seguinte comentário por dois motivos. Primeiro, o número de espaços antes do asterisco não é consistente. Em segundo lugar, a quinta linha começa com uma guia, não coincide com espaços. Portanto, todo o texto das linhas de dois a cinco é processado como parte do comentário.

  /** 
    * <summary> 
    * text 
   *  text2 
      *  </summary> 
  */ 
  

Consulte também

Referência

XML Documentation Comments (C# Programming Guide)

/doc ( Opçõesdo compilador TRANSLATION FROM VPE FOR CSHARP)

XML Documentation Comments (C# Programming Guide)

Conceitos

C# Programming Guide