NewLine w podsumowaniu obiektów

Pozdrowienia

Podczas ustawiania podsumowania dla właściwości / pola / metody itp. Czy jest możliwe umieszczenie w nim nowej linii?

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

Kiedy to ustawię, pokazuje się jak po najechaniu myszą:

bool TestLine
This is line 1 This is line 2

Ale chcę, żeby to było wyświetlane jako:

bool TestLine
This is line 1 
This is line 2

Próbowałem użyć, \nale to nie działa. Czy jest jakiś sposób, aby to zrobić?

Chcesz użyć czegoś takiego

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

Tak:

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

To może być stary wątek, ale szukałem anwser podczas korzystania z Visual Studio 2019 . Chciałem łamać akapity i linie. U mnie dobrze działa:

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

Produkuje:

parameter name="guidType" options:

0 = SequentialAsString
1 = SequentialAsBinary
2 = SequentialAtEnd

Możesz użyć, <para />aby dodać nową linię w podsumowaniu:

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

Wygląda jak:

Main comment
Line 1
Line 2

Z poważaniem!

Po prostu dodam to dla każdego, kto używa Xamarin Studio, tak jak ja. Okazało się, że żadne z powyższych rozwiązań nie działa dla mnie, ale to zadziałało:

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

Daje to następujący wynik:

Summary  
Main summary line.

Your secondary summary

Jeśli używasz Swashbuckle (biblioteki integracji interfejsu API sieci Web Swagger), <para></para>należy go zastąpić <p></p>i <br/>również można go użyć.

więc następujące

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

staje się

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

Problem jest już opisany tutaj: Jak dodać podział wiersza do dokumentacji Swashbuckle? - przy użyciu specjalnej konfiguracji, komentarz domaindrivendev, https://github.com/domaindrivendev/Swashbuckle/issues/258 - o <br/>użyciu.

Możesz legalnie dodawać znaczniki para, ale w rzeczywistości tworzy to nowy akapit dla każdego nowego wiersza, a odstępy między wierszami wydają się być wyłączone.
Osobiście dodaję 1 akapit wokół akapitu, a następnie brtagi na końcu wierszy, w których chciałem zrobić przerwę, co pozwala zachować przyzwoity odstęp między wierszami:

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

Sugerowałbym użycie tego formatowania, jeśli chcesz, aby podsumowanie zawierało wiele wierszy, nie komplikując go. Będzie działać, jeśli użyjesz tagu <br /> po każdym wierszu. (użycie go w dowolnym miejscu w tekście spowoduje utworzenie nowego wiersza, w którym również znajduje się tag).

Pamiętaj jednak, że jeśli masz spację po tagu <br />, dostaniesz dodatkową spację o jedną w następnej linii. Więc chcesz mieć taką samą ilość miejsca w każdej linii, aby każdy wiersz był w linii prostej.

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