[C#] C # .NET 설명서에서 줄 바꿈을 추가하는 방법

C# / 글쓴이

이것은 더 쉬워야합니다 …

코드의 XML 문서에 “코드화 된”줄 바꿈을 추가하고 싶습니다

/// <summary>
/// Get a human-readable variant of the SQL WHERE statement of the search element. &lt;br/&gt;
/// Rather than return SQL, this method returns a string with icon-tokens, which 
/// could be used to represent the search in a condensed pictogram format.
/// </summary>

보시다시피 <및> 괄호 추가를 보여주는 몇 가지 답변을 찾았습니다. 흥미롭게도, 좋은 ‘ol <br /> 줄 바꿈은 Intellisense 팝업에서 줄 바꿈을 만들지 않습니다.

이 짜증나는 것을 발견 …

어떤 제안?

답변

당신은 사용할 수있는 <para />단락 나누기를 생산하기 위해 태그를하거나 텍스트 래핑 할 수 <para></para>그룹 방법 텍스트로 태그를하고 그 뒤에 빈 줄을 추가,하지만에 해당이없는 <br />그런 또는 아무것도. ( 이 오래된 MS 포럼 게시물 에 따르면 의도적으로 설계된 것입니다.)이 문서 기사에서 사용 가능한 태그 목록을 MS에서 얻을 수 있습니다. 코드 문서화

예 (원본 OP 샘플 기준) : 

/// <summary>
/// <para>Get a human-readable variant of the SQL WHERE statement of the search element.</para>
/// Rather than return SQL, this method returns a string with icon-tokens, which 
/// could be used to represent the search in a condensed pictogram format.
/// </summary>

답변

이것은 내 사용법입니다. <br/>작동 중입니다 🙂

/// <summary>
/// Value: 0/1/2
/// <para/>0 foo,
/// <para/>1 bar,
/// <para/>2 other
/// </summary>

답변

Visual Studio 2019부터 <br/>주석의 줄 바꿈에 사용하십시오 .

예:

/// <summary>
/// This is a comment.<br/>
/// This is another comment <br/>
/// This is a long comment so i want it to continue <br/> on another line.
/// </summary>

여기에 이미지 설명을 입력하십시오

<br/>대신 사용할 때 추가 줄이 추가되지 않습니다 <para>.

답변

추가 <para>거기에 특수 문자, 255 문자, 또는으로 태그를 보이지 않는 문자 .

/// <summary>
/// Some text
/// <para>   </para>
/// More text
/// </summary>
/// <param name="str">Some string</param>
public void SomeMethod(string str) { }

다음과 같이 작동합니다.

여기에 이미지 설명을 입력하십시오

답변

<br></br>및 <br />작동하지, 때로는 그것을 만드는 방법에 대한 정말하지 않는 <para>문장이 우려 분리를위한 빈 줄을 가지고있는 욕망만큼 분리한다. 이 질문은이 성격에 대한 많은 비공개 질문에 대한 부모 인 것처럼 보이기 때문에 여기에 언급되어 있습니다.

내가 일한 유일한 것은 

<para>&#160;</para>

예를 들어

/// <summary>
///     <para>
///         "This sentence shows up when the type is hovered"
///     </para>
///     <para>&#160;</para>
///     <para>int PrimaryKey</para>
///     <para>&#160;</para>
///     <para>virtual Relation Relation</para>
/// </summary>

결과

"This sentence shows up when the type is hovered"

int PrimaryKey

virtual Relation Relation

답변