다음을 통해 공유

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

  • 아티클

업데이트: 2007년 11월

오류 메시지

'construct'의 XML 주석에 잘못된 형식의 XML이 있습니다. 'reason'
XML comment on 'construct' has badly formed XML — 'reason'

/doc를 사용할 때에는 소스 코드의 모든 주석을 XML로 만들어야 합니다. XML 태그로 인한 오류는 모두 CS1570을 생성합니다. 예를 들면 다음과 같습니다.

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

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

  • 설명 텍스트에 > 또는 < 기호를 사용하려면 &gt; 또는 **&lt;**로 표현해야 합니다.

  • <include> 태그에 있는 파일이나 경로 특성이 없거나 잘못된 형식입니다.

다음 샘플에서는 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 ()
      {
      }
   }
}