새 줄에 XML 주석을 표시하려면

페이지 업데이트 :
페이지 생성 날짜 :

Visual Studio에서는 C#에 대한 XML 문서 주석을 작성하고 속성 및 메서드를 VB.NET 할 수 있습니다. 일단 작성하면 코드로 작성하고 마우스 커서를 가리키며 "Sandcastle"과 같은 도구를 사용할 때 속성 또는 메서드에 대한 설명을 볼 수 있습니다.

그러나 너무 많이 쓰면 가독성이 떨어지므로 일반적으로 한 줄 정도면 작성되지만 경우에 따라 여러 줄에 표시 할 수 있습니다.

주석에서 정상적으로 줄을 끊으면 설명이 표시 될 때 줄 바꿈과 함께 표시 될 것으로 예상되지만 실제로 시도하면 다음과 같이 표시됩니다.

/// <summary>
/// これは
/// 普通に
/// 改行したもの
/// <summary>
public int Amount1 { get; set; }

설명 표시 결과

설명 텍스트에는 줄 바꿈이 없으며 레이아웃은 공백이 포함 된 것처럼 보입니다. XML은 공백과 줄 바꿈이 처리되는 방식에 다양한 영향을 미치며 Visual Studio에서는 일반 줄 바꿈을 텍스트 나누기로 간주하지 않습니다.

따라서 줄에 설명 텍스트를 자르려면 "para"태그를 사용하는 방법입니다. "para"는 "단락"을 의미합니다. 다음과 같이 줄을 끊으려는 단위를 para 태그에 묶으십시오.

/// <summary>
/// <para>paraを</para>
/// <para>使って</para>
/// <para>改行したもの</para>
/// </summary>
public int Amount2 { get; set; }

설명은 그림과 같이 줄 바꿈과 함께 표시됩니다. 문서 생성 도구를 사용하면 줄 바꿈이 있는 단락으로도 표시됩니다.