Pentru a afișa comentarii XML pe o linie nouă

În Visual Studio, aveți posibilitatea să scrieți comentarii document XML pe C# și VB.NET proprietăți și metode. După ce îl scrieți, veți putea vizualiza descrierea proprietății sau a metodei atunci când o scrieți în cod, treceți cursorul mouse-ului și utilizați un instrument, cum ar fi "Sandcastle".

Cu toate acestea, dacă scrieți prea mult, lizibilitatea va scădea, așa că, de obicei, o veți scrie în aproximativ o linie, dar în unele cazuri poate doriți să o afișați pe mai multe linii.

Dacă rupeți o linie într-un comentariu în mod normal, vă veți aștepta ca aceasta să fie afișată cu un sfârșit de linie atunci când descrierea este afișată, dar când o încercați efectiv, aceasta va fi afișată după cum urmează.

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

Rezultatul de afișare a explicațiilor

Nu există sfârșituri de linie în textul descrierii, iar aspectul arată ca și cum ar conține spații. XML are un efect variabil asupra modului în care spațiile albe și sfârșiturile de linie sunt gestionate și Visual Studio nu consideră pauze de linie normale pentru a fi pauze de text.

Deci, dacă doriți să rupeți textul de descriere pe o linie, cum să faceți acest lucru este să utilizați eticheta "para". "para" înseamnă "paragraf". Încadrați unitățile pe care doriți să le rupeți astfel de linii într-o etichetă para:

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

Descrierea este afișată cu un sfârșit de linie așa cum se arată în figură. Dacă utilizați instrumentul de generare a documentelor, acesta va apărea și ca paragraf cu sfârșituri de linie.