aviso do compilador (nível 1) CS1570

  • Artigo

Mensagem de erro

Comentário XML em 'construção' tem formato incorreto XML — 'motivo'

Ao usar /doc, os comentários no código-fonte devem estar no XML.Qualquer erro com a marcação XML gerará CS1570.Por exemplo:

  • Caso você esteja passando uma seqüência de caracteres para um cref, sistema autônomo em um <exceção> marca, a seqüência de caracteres deve ser colocada entre aspas duplas.

  • Se você estiver usando uma marca, sistema autônomo <seealso>, que não tem uma marca de fechamento, você deve especificar uma barra / / invertida antes do colchete angular de fechamento.

  • Se você precisar usar uma maior – que ou menos – símbolo no texto da descrição que, você precisa para representá-los com &ampgt; or &amplt;.

  • O atributo de arquivo ou caminho em um <include> marca está ausente ou formado incorretamente.

O exemplo a seguir gera CS1570:

// CS1570.cs
// compile with: /W:1
namespace ns
{
   // the following line generates CS1570
   /// <summary> returns true if < 5 </summary>
   // try this instead
   // /// <summary> returns true if &lt;5 </summary>

   public class MyClass
   {
      public static void Main ()
      {
      }
   }
}