Aby wyświetlić komentarze XML w nowym wierszu

W programie Visual Studio można pisać komentarze do dokumentów XML w języku C# i VB.NET właściwości i metody. Po napisaniu go będziesz mógł wyświetlić opis właściwości lub metody podczas pisania go w kodzie, najechać kursorem myszy i użyć narzędzia takiego jak "Sandcastle".

Jeśli jednak napiszesz za dużo, czytelność zmniejszy się, więc zwykle napiszesz to w około jednym wierszu, ale w niektórych przypadkach możesz chcieć wyświetlić go w wielu wierszach.

Jeśli normalnie przerwiesz wiersz w komentarzu, będziesz oczekiwać, że będzie on wyświetlany z podziałem wiersza podczas wyświetlania opisu, ale kiedy faktycznie spróbujesz, zostanie on wyświetlony w następujący sposób.

/// <summary>
/// これは
/// 普通に
/// 改行したもの
/// <summary>
public int Amount1 { get; set; }

Wyjaśnienie wyniku wyświetlania

W tekście opisu nie ma podziałów wierszy, a układ wygląda tak, jakby zawierał spacje. XML ma różny wpływ na sposób obsługi białych znaków i podziałów wierszy, a program Visual Studio nie uważa normalnych podziałów wierszy za podziały tekstu.

Tak więc, jeśli chcesz złamać tekst opisu w linii, jak to zrobić, użyj tagu "para". "para" oznacza "akapit". Umieść jednostki, które chcesz podzielić wiersze w następujący sposób, w paratagu:

/// <summary>
/// <para>paraを</para>
/// <para>使って</para>
/// <para>改行したもの</para>
/// </summary>
public int Amount2 { get; set; }

Opis jest wyświetlany z podziałem wiersza, jak pokazano na rysunku. Jeśli użyjesz narzędzia do generowania dokumentów, pojawi się ono również jako akapit z podziałami wierszy.