NewLine in der Objektzusammenfassung

Schöne Grüße

Wenn Sie eine Zusammenfassung für eine Eigenschaft / ein Feld / eine Methode usw. festlegen, ist es möglich, eine neue Zeile darin zu haben?

/// <summary>
/// This is line 1
/// This is line 2
/// </summary>
public bool TestLine { get; set; }

Wenn ich dies einstelle, wird wie bei der Maus angezeigt:

bool TestLine
This is line 1 This is line 2

Aber ich möchte, dass es Folgendes zeigt:

bool TestLine
This is line 1 
This is line 2

Ich habe es versucht, \naber das funktioniert nicht. Gibt es eine Möglichkeit, dies zu erreichen?

Sie möchten so etwas verwenden

/// <summary> 
/// Your Main comment 
/// <para>This is line 1</para> 
/// <para>This is line 2</para> 
/// </summary> 
public bool TestLine { get; set; }

Ja:

/// <summary> 
/// Main comment 
/// <para>Line 1</para> 
/// <para>Line 2</para> 
/// </summary> 
public bool TestLine { get; set; }

Dies mag ein alter Thread sein, aber ich habe bei der Verwendung von Visual Studio 2019 nach einer Antwort gesucht . Ich wollte Absatz- und Zeilenumbrüche. Folgendes funktioniert gut für mich:

/// <summary>
/// <para>parameter name="guidType" options:</para>
/// <br>0 = SequentialAsString</br>
/// <br>1 = SequentialAsBinary</br>
/// <br>2 = SequentialAtEnd</br>
/// </summary>

Produziert folgendes:

parameter name="guidType" options:

0 = SequentialAsString
1 = SequentialAsBinary
2 = SequentialAtEnd

Sie können <para />eine neue Zeile in die Zusammenfassung einfügen:

/// <summary> 
/// Main comment<para />
/// Line 1<para />
/// Line 2<para />
/// </summary>
public bool TestLine { get; set; }

Sieht aus wie:

Main comment
Line 1
Line 2

Freundliche Grüße!

Ich füge dies nur für jeden hinzu, der Xamarin Studio so verwendet wie ich. Ich habe festgestellt, dass keine der oben genannten Lösungen für mich funktioniert, aber diese hat Folgendes getan:

/// <summary>
/// Main summarry line.
/// <para></para>
/// <para></para>
/// Your secondary summary
/// </summary>

Dies ergibt die folgende Ausgabe:

Summary  
Main summary line.

Your secondary summary

Wenn Sie Swashbuckle (Swagger Web API-Integrationsbibliothek) verwenden, <para></para>sollte dies durch ersetzt werden <p></p>und <br/>könnte auch verwendet werden.

also das folgende

    /// <para>
    ///     Flag1, Flag2
    ///     - bool flags, optional.
    /// </para>

wird

    /// <p>
    ///     Flag1, Flag2<br/>
    ///     - bool flags, optional.
    /// </p>

Das Problem ist hier bereits beschrieben: Wie füge ich der Swashbuckle-Dokumentation einen Zeilenumbruch hinzu? - Verwenden einer speziellen Konfiguration, des Kommentars von domaindrivendev, https://github.com/domaindrivendev/Swashbuckle/issues/258 - zur <br/>Verwendung.

Sie können legitimerweise Para-Tags hinzufügen, dies erstellt jedoch tatsächlich einen neuen Absatz für jede neue Zeile und der Zeilenabstand wird deaktiviert.
Ich persönlich füge 1 Absatz um den Absatz hinzu und brtagge dann am Ende der Zeilen, für die ich eine Unterbrechung wollte, wodurch ein anständiger Zeilenabstand erhalten bleibt:

/// <summary> 
/// <para>Main comment<br /> 
/// Line 1<br />
/// Line 2</para> 
/// </summary>
public bool TestLine { get; set; }

Ich würde empfehlen, diese Formatierung zu verwenden, wenn Sie mehrere Zeilen in der Zusammenfassung haben möchten, ohne dies zu komplizieren. Es funktioniert, wenn Sie nach jeder Zeile das <br /> -Tag verwenden. (Wenn Sie es irgendwo im Text verwenden, wird eine neue Zeile erstellt, in der sich auch das Tag befindet.)

Beachten Sie jedoch, dass Sie in der nächsten Zeile ein zusätzliches Leerzeichen erhalten, wenn Sie nach dem <br /> -Tag ein Leerzeichen haben. Sie möchten also in jeder Zeile den gleichen Platz haben, sodass jede Zeile in einer geraden Linie verläuft.

/// <summary>
/// This is line 1<br />
/// This is line 2<br />
/// This is line 3<br />
/// </summary>
public bool TestLine { get; set; }