Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Comentário XML no 'construct' tem XML malformado — 'motivo'
Ao usar o DocumentationFile, quaisquer comentários no código-fonte devem estar em XML. Qualquer erro na sua marcação XML gerará CS1570. Por exemplo:
Se você estiver a passar uma string a um cref, como numa tag
<exception>, a string deve estar colocada entre aspas duplas.Se estiver a usar uma etiqueta que não tenha etiqueta de fecho, como
<seealso>, deve especificar uma barra para a frente antes do colchete angular de fecho.Se precisar de usar um símbolo maior ou menor que no texto da descrição, precisa de os representar com
>ou<. Alternativamente, podes usar CDATA.O ficheiro ou atributo do caminho numa
<include>etiqueta estava ausente ou mal formado.
O exemplo seguinte gera CS1570:
public static class CompareFive
{
// the following line generates CS1570
/// <summary> returns true if < 5 </summary>
// try one of the following instead
// /// <summary> returns true if < 5 </summary>
// /// <summary><![CDATA[ returns true if < 5 ]]></summary>
public static bool LessThanFive(int x) => x < 5;
}