'construct' に対する XML コメントの XML 形式が正しくない XML - 'reason'
DocumentationFile を使用する場合、ソース コード内のコメントは XML に含まれている必要があります。 XML マークアップでエラーが発生すると、CS1570 が生成されます。 例えば次が挙げられます。
タグなど、
<exception>に文字列を渡す場合は、文字列を二重引用符で囲む必要があります。<seealso>など、終了タグがないタグを使用している場合は、右角かっこの前にスラッシュを指定する必要があります。説明のテキストで大きい記号または小さい記号を使用する必要がある場合は、
>または<で表す必要があります。 または、CDATA を使用することもできます。<include>タグのファイル属性またはパス属性が見つからないか、形式が正しくありません。
次の例では 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;
}
GitHub で Microsoft と共同作業する
このコンテンツのソースは GitHub にあります。そこで、issue や pull request を作成および確認することもできます。 詳細については、共同作成者ガイドを参照してください。
.NET