Come aggiungere un'interruzione di riga nella documentazione di C # .NET

Questo dovrebbe essere più facile ...

Voglio aggiungere un'interruzione di riga "codificata" alla documentazione XML nel mio codice

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

Come puoi vedere, ho trovato alcune risposte che hanno dimostrato l'aggiunta di parentesi <e>. È interessante notare che la buona interruzione di riga 'ol <br /> non crea un'interruzione di linea nel popup Intellisense.

Lo trovo fastidioso ...

Eventuali suggerimenti?

Puoi usare un <para />tag per produrre un'interruzione di paragrafo oppure puoi racchiudere il testo nei <para></para>tag come un modo per raggruppare il testo e aggiungere la riga vuota dopo di esso, ma non esiste un equivalente <br />o qualcosa del genere. (Che secondo questo vecchio post sul forum MS è in base alla progettazione.) Puoi ottenere l'elenco dei tag disponibili in questo articolo di documentazione da MS. Documentare il tuo codice

Esempio (basato sul campione OP originale):

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

Questo è il mio utilizzo, tipo <br/>, funziona :)

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

A partire da Visual Studio 2019, utilizzare <br/>per le nuove righe nei commenti.

Esempio:

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

Si noti che non viene aggiunta alcuna riga aggiuntiva quando si utilizza <br/>invece di <para>.

Aggiungi un <para>tag con un carattere speciale al suo interno, il 255 carattere o il carattere invisibile .

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

Funzionerà così:

<br></br>e <br />non sembrano funzionare, e talvolta non si tratta in realtà di <para>separare le frasi tanto quanto il desiderio di avere una linea vuota per la separazione delle preoccupazioni. Lo menziono qui perché questa domanda sembra essere genitore di molte domande chiuse di questa natura.

L'unica cosa che ho scoperto di funzionare è stata

<para>&#160;</para>

Per esempio

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

Risultati in

"This sentence shows up when the type is hovered"

int PrimaryKey

virtual Relation Relation