Comment ajouter un saut de ligne dans la documentation C # .NET

Cela devrait être plus facile ...

Je veux ajouter un saut de ligne "codé" à la documentation XML dans mon code

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

Comme vous pouvez le voir, j'ai trouvé quelques réponses qui ont démontré l'ajout de crochets <et>. Fait intéressant, le bon 'ol <br /> saut de ligne ne crée pas de saut de ligne dans la fenêtre contextuelle Intellisense.

Je trouve ça ennuyeux ...

Aucune suggestion?

Vous pouvez utiliser une <para />balise pour produire un saut de paragraphe ou vous pouvez encapsuler du texte dans des <para></para>balises pour regrouper le texte et ajouter la ligne vide après, mais il n'y a pas d'équivalent <br />ou quelque chose comme ça. (Ce qui, selon cet ancien article du forum MS, est de par sa conception.) Vous pouvez obtenir la liste des balises disponibles dans cet article de documentation de MS. Documenter votre code

Exemple (basé sur l'échantillon OP d'origine):

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

C'est mon utilisation, comme <br/>ça marche :)

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

Depuis Visual Studio 2019, utilisez <br/>pour les retours à la ligne dans les commentaires.

Exemple:

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

Notez qu'aucune ligne supplémentaire n'est ajoutée lorsque nous utilisons à la <br/>place de <para>.

Ajoutez une <para>balise contenant un caractère spécial, le 255 caractère ou le caractère invisible .

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

Cela fonctionnera comme ceci:

<br></br>et <br />ne semblent pas fonctionner, et parfois il ne s'agit pas vraiment de <para>séparer les phrases autant que le désir d'avoir une ligne blanche pour la séparation des préoccupations. Je le mentionne ici parce que cette question semble concerner de nombreuses questions fermées de cette nature.

La seule chose que j'ai trouvée pour travailler était

<para>&#160;</para>

Par exemple

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

Résulte en

"This sentence shows up when the type is hovered"

int PrimaryKey

virtual Relation Relation