영어로 읽기

다음을 통해 공유


컴파일러 경고(수준 1) CS1570

'construct'의 XML 주석에 잘못된 형식의 XML이 있습니다. 'reason'

DocumentationFile을 사용할 때 소스 코드의 모든 주석은 XML이어야 합니다. XML 태그에 오류가 있으면 CS1570이 생성됩니다. 예시:

  • <exception>; 태그와 같이 cref에 문자열을 전달하는 경우 문자열을 큰따옴표로 묶어야 합니다.

  • <seealso>와 같이 닫는 태그가 없는 태그를 사용하는 경우 닫는 꺾쇠 괄호 앞에 슬래시를 지정해야 합니다.

  • 설명 텍스트에 보다 큼 또는 보다 작음 기호를 사용해야 하는 경우 &gt; 또는 &lt;로 나타내야 합니다. 또는 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 &lt; 5 </summary>
    // /// <summary><![CDATA[ returns true if < 5 ]]></summary>
    public static bool LessThanFive(int x) => x < 5;
}