Compilerwarnung (Ebene 1) CS1570

Der XML-Kommentar zu 'construct' enthält schlecht gebildetes XML — 'Grund'.

Bei Verwendung von DocumentationFile müssen sich alle Kommentare im Quellcode in XML befinden. Jeder Fehler mit Ihrem XML-Markup generiert CS1570. Beispiel:

  • Wenn Sie eine Zeichenfolge an ein Cref übergeben, z. B. in einem <exception> Tag, muss die Zeichenfolge in doppelte Anführungszeichen eingeschlossen werden.

  • Wenn Sie ein Tag verwenden, das nicht über ein schließendes Tag verfügt, z. B. <seealso>, müssen Sie einen Schrägstrich vor der schließenden Winkelklammer angeben.

  • Wenn Sie im Text der Beschreibung ein größer-als- oder kleiner-als-Symbol verwenden müssen, müssen Sie sie mit &gt; oder &lt; darstellen. Alternativ können Sie CDATA verwenden.

  • Das Datei- oder Pfad-Attribut eines <include> Tags fehlt oder wurde nicht ordnungsgemäß gebildet.

Im folgenden Beispiel wird CS1570 generiert:

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 &lt; 5 </summary>
    // /// <summary><![CDATA[ returns true if < 5 ]]></summary>
    public static bool LessThanFive(int x) => x < 5;
}