programing

C#에서 줄 바꿈을 추가하는 방법.NET 문서

skycolor 2023. 5. 2. 22:31
반응형

C#에서 줄 바꿈을 추가하는 방법.NET 문서

이건 좀 더 쉬워야 할 것 같은데요...

코드의 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>

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>

Visual Studio 2019 툴팁에 나타나는 요약 이미지. 요약 텍스트에 각 HTML 구분 태그가 추가된 줄 바꿈이 표시됩니다.

사용 시 추가 줄이 없습니다.<br/>대신에<para>.

이건 내가 쓰는 말이야, 마치.<br/>효과가 있습니다 :)

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

추가 a<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

언급URL : https://stackoverflow.com/questions/7279108/how-to-add-a-line-break-in-c-sharp-net-documentation

반응형