Prikaz komentarjev XML v novi vrstici

V Visual Studio lahko napišete komentarje XML dokumenta na C# in VB.NET lastnosti in metode. Ko ga boste napisali, si boste lahko ogledali opis lastnosti ali metode, ko jo boste zapisali v kodo, kazalec miške in uporabili orodje, kot je "Peščeni gradnik".

Če pa pišete preveč, se bo berljivost zmanjšala, zato jo boste običajno napisali v približno eni vrstici, v nekaterih primerih pa jo boste morda želeli prikazati v več vrsticah.

Če običajno prelomite vrstico v komentarju, boste pričakovali, da bo prikazana s prelomom vrstice, ko bo prikazan opis, ko pa ga dejansko poskusite, bo prikazana na naslednji način.

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

Rezultat prikaza razlage

V opisnem besedilu ni prelomov vrstice, postavitev pa je videti, kot da vsebuje presledke. XML vpliva na to, kako se ravna s prelomi belih prostorov in črt, Visual Studio pa ne meni, da so običajni prelomi vrstice prelomi besedila.

Torej, če želite prelomiti besedilo opisa v vrstici, kako to storiti je, da uporabite oznako "para". "odstavek" pomeni odstavek. Enote, ki jih želite prelomiti, vstavi v oznako para:

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

Opis je prikazan s prelomom vrstice, kot je prikazano na sliki. Če uporabljate orodje za ustvarjanje dokumentov, se prikaže tudi kot odstavek s prelomi vrstice.