C # .NET belgelerinde satır sonu ekleme

Bu daha kolay olmalı ...

Kodumdaki XML belgelerine "kodlanmış" satır sonu eklemek istiyorum

/// <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>

Gördüğünüz gibi, <ve> köşeli ayraç eklediğini gösteren bazı yanıtlar buldum. İlginçtir ki, iyi 'ol <br /> satır sonu, Intellisense açılır penceresinde satır sonu oluşturmaz.

Bu sinir bozucu buluyorum ...

Baska öneri?

<para />Bir paragraf sonu oluşturmak için bir etiket kullanabilir veya metni <para></para>gruplamak ve boş satırı sonradan eklemek için etiket olarak metni etiketlere yerleştirebilirsiniz, ancak buna eşdeğer <br />veya bunun gibi bir şey yoktur . ( Bu eski MS forum gönderisine göre tasarım gereğidir.) Bu dokümantasyondaki mevcut etiketlerin listesini MS'den alabilirsiniz. Kodunuzu belgeleme

Örnek (orijinal OP örneğine göre):

/// <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>

Bu benim kullanımım, <br/>çalışıyor gibi :)

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

Visual Studio 2019'dan itibaren <br/>yorumlardaki yeni satırlar için kullanın .

Misal:

/// <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/>Bunun yerine kullandığımızda fazladan bir satır eklenmediğine dikkat edin <para>.

<para>İçinde özel karakter, 255 karakter veya görünmeyen karakter içeren bir etiket ekleyin .

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

Bu şekilde çalışacaktır:

<br></br>ve <br />işe yaramıyor gibi görünüyor ve bazen bu gerçekten <para>de endişelerin ayrılması için boş bir çizgiye sahip olma arzusu kadar cümleleri birbirinden ayırmakla ilgili değil. Burada bahsediyorum, çünkü bu soru bu doğadaki birçok kapalı soruya ebeveyn gibi görünüyor.

Çalıştığım tek şey

<para>&#160;</para>

Örneğin

/// <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>

Sonuçları

"This sentence shows up when the type is hovered"

int PrimaryKey

virtual Relation Relation