개체 요약의 NewLine


99

인사말

속성 / 필드 / 메서드 등에 대한 요약을 설정할 때 개행을 넣을 수 있습니까?

/// <summary>
/// This is line 1
/// This is line 2
/// </summary>
public bool TestLine { get; set; }

이것을 설정하면 마우스를 올리면 다음과 같이 표시됩니다.

bool TestLine
This is line 1 This is line 2

그러나 다음과 같이 표시하고 싶습니다.

bool TestLine
This is line 1 
This is line 2

나는 사용해 \n보았지만 작동하지 않습니다. 이 작업을 수행 할 수있는 방법이 있습니까?

답변:


188

이런 걸 사용하고 싶어요

/// <summary> 
/// Your Main comment 
/// <para>This is line 1</para> 
/// <para>This is line 2</para> 
/// </summary> 
public bool TestLine { get; set; }

1
@YetAnotherUser, 빈 줄은 어떻습니까?
Behzad 2013 년

1
@Behzad를 사용해보십시오 <para>&nbsp;</para>.
YetAnotherUser

15
나는 그 여분의 라인 :( 싫어
월 Macháček

10
Visual Studio 2017 IDE에서 위의 "솔루션"은 실제로 1 행과 2 행 사이에 하나의 빈 줄을 표시합니다 (즉, 1 행 뒤의 줄 바꿈 뒤에 빈 행 2 행). 이것은 동일하지 않습니다. OP가 요청한대로 새 줄. VS 2017 IDE의 버그입니까?
Jazimov

새 줄이 아니라 새 단락입니다. 문서 구문이 다소 제한적이라는 느낌이 듭니다.
GrizzlyMcBear

33

예:

/// <summary> 
/// Main comment 
/// <para>Line 1</para> 
/// <para>Line 2</para> 
/// </summary> 
public bool TestLine { get; set; }

14

이것은 오래된 스레드 일 수 있지만 Visual Studio 2019 를 사용하는 동안 anwser를 검색했습니다 . 단락과 줄 바꿈을 원했습니다. 다음은 나를 위해 잘 작동합니다.

/// <summary>
/// <para>parameter name="guidType" options:</para>
/// <br>0 = SequentialAsString</br>
/// <br>1 = SequentialAsBinary</br>
/// <br>2 = SequentialAtEnd</br>
/// </summary>

다음을 생성합니다.

parameter name="guidType" options:

0 = SequentialAsString
1 = SequentialAsBinary
2 = SequentialAtEnd

4
VS2019 이상에서는이 답변이 허용 된 답변보다 기술적으로 더 정확합니다.
Riaan Walters

VS2019의 줄 끝에서 <br /> 사용할 수도 있습니다. 이러한 솔루션은 실제 줄 바꿈을 생성하며 빈 줄이있는 새 단락이 아닙니다! 감사합니다
Phillip S

5

<para />요약 내에 새 줄을 추가하는 데 사용할 수 있습니다 .

/// <summary> 
/// Main comment<para />
/// Line 1<para />
/// Line 2<para />
/// </summary>
public bool TestLine { get; set; }

다음과 같이 보입니다.

Main comment
Line 1
Line 2

친애하는!


2

나는 Xamarin Studio를 사용하는 모든 사람을 위해 이것을 추가하고 있습니다. 위의 솔루션 중 어느 것도 나를 위해 작동하지 않는다는 것을 알았습니다.

/// <summary>
/// Main summarry line.
/// <para></para>
/// <para></para>
/// Your secondary summary
/// </summary>

그러면 다음과 같은 출력이 제공됩니다.

Summary  
Main summary line.

Your secondary summary

1

Swashbuckle (Swagger Web API 통합 라이브러리)을 <para></para>사용하는 경우 <p></p><br/> 사용할 수 있습니다.

그래서 다음

    /// <para>
    ///     Flag1, Flag2
    ///     - bool flags, optional.
    /// </para>

된다

    /// <p>
    ///     Flag1, Flag2<br/>
    ///     - bool flags, optional.
    /// </p>

문제는 이미 여기에 설명되어 있습니다. Swashbuckle 문서에 줄 바꿈을 추가하는 방법은 무엇입니까? -특수 구성, domaindrivendev의 의견 ( https://github.com/domaindrivendev/Swashbuckle/issues/258)<br/> 사용 - 사용시.


0

합법적으로 para 태그를 추가 할 수 있지만 실제로는 각 새 줄에 대해 새 단락이 만들어지고 줄 간격이 사라집니다.
저는 개인적으로 단락 주위에 1 개의 para를 추가하고 br적절한 줄 간격을 유지하기 위해 중단하고 싶은 줄 끝에 태그를 추가합니다.

/// <summary> 
/// <para>Main comment<br /> 
/// Line 1<br />
/// Line 2</para> 
/// </summary>
public bool TestLine { get; set; }

3
이것은 작동하지 않으며 <para>와의 간격에 대해 아무런 문제가 없습니다. 어떤 버전의 VS / .Net을 사용하고 있습니까?
Dani

2
HTML 태그는 태그 summary안에 있더라도에서 무시됩니다 para.
Lazaro Fernandes Lima Suleiman 2015 년

-7

복잡하게 만들지 않고 요약에 여러 줄을 원할 경우이 서식을 사용하는 것이 좋습니다. 각 줄 뒤에 <br /> 태그사용하면 작동합니다 .(텍스트 내부 어디에서나 사용하면 태그가있는 새 줄이 만들어집니다.)

그러나 <br /> 태그 뒤에 공백이 있으면 다음 줄에 추가 공백이 생깁니다. 따라서 각 선에 동일한 양의 공간을 원하므로 모든 행이 직선이 될 것입니다.

/// <summary>
/// This is line 1<br />
/// This is line 2<br />
/// This is line 3<br />
/// </summary>
public bool TestLine { get; set; }

3
그것이 작동하지 않기 때문에 해결책을 찾기 전에 먼저 시도했습니다!
Philippe
당사 사이트를 사용함과 동시에 당사의 쿠키 정책개인정보 보호정책을 읽고 이해하였음을 인정하는 것으로 간주합니다.
Licensed under cc by-sa 3.0 with attribution required.