Lai parādītu XML komentārus jaunā rindā

Programmā Visual Studio varat rakstīt XML dokumentu komentārus par C# un VB.NET rekvizītiem un metodēm. Kad esat to uzrakstījis, jūs varēsiet apskatīt īpašuma vai metodes aprakstu, rakstot to kodā, virzot peles kursoru un izmantojot rīku, piemēram, "Sandcastle".

Tomēr, ja rakstāt pārāk daudz, lasāmība samazināsies, tāpēc parasti jūs to ierakstīsit apmēram vienā rindā, bet dažos gadījumos, iespējams, vēlēsities to parādīt vairākās rindās.

Ja komentārā parasti pāršķirsiet rindiņu, jūs sagaidīsit, ka tā tiks parādīta ar rindiņas pārtraukumu, kad tiek parādīts apraksts, bet, kad jūs to faktiski izmēģināt, tā tiks parādīta šādi.

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

Paskaidrojuma parādīšanas rezultāts

Apraksta tekstā nav rindiņu pārtraukumu, un izkārtojums izskatās tā, it kā tajā būtu atstarpes. XML ir atšķirīga ietekme uz to, kā tiek apstrādāti atstarpju un rindiņu pārtraukumi, un Visual Studio neuzskata, ka parastie rindiņu pārtraukumi ir teksta pārtraukumi.

Tātad, ja vēlaties lauzt apraksta tekstu uz līnijas, kā to izdarīt, ir izmantot tagu "para". "para" nozīmē "punkts". Para tagā iekļaujiet vienības, kuras vēlaties pārraut šādas līnijas:

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

Apraksts tiek parādīts ar rindiņas pārtraukumu, kā parādīts attēlā. Ja izmantojat dokumentu ģenerēšanas rīku, tas tiks parādīts arī kā rindkopa ar rindiņu pārtraukumiem.