XML-kommenttien näyttäminen uudella rivillä

Visual Studiossa voit kirjoittaa XML-dokumenttikommentteja C#- ja VB.NET-ominaisuuksiin ja -menetelmiin. Kun olet kirjoittanut sen, voit tarkastella ominaisuuden tai menetelmän kuvausta, kun kirjoitat sen koodiin, siirrä hiiren kohdistin ja käytä työkalua, kuten "Sandcastle".

Jos kuitenkin kirjoitat liikaa, luettavuus heikkenee, joten yleensä kirjoitat sen noin yhdelle riville, mutta joissakin tapauksissa saatat haluta näyttää sen useilla riveillä.

Jos katkaiset rivin kommentissa normaalisti, odotat sen näkyvän rivinvaihdolla, kun kuvaus näytetään, mutta kun todella yrität sitä, se näytetään seuraavasti.

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

Selitysnäytön tulos

Kuvaustekstissä ei ole rivinvaihtoja, ja asettelu näyttää siltä, että se sisältää välilyöntejä. XML:llä on vaihteleva vaikutus välilyöntien ja rivinvaihtojen käsittelyyn, eikä Visual Studio pidä normaaleja rivinvaihtoja tekstinvaihtoina.

Joten, jos haluat rikkoa rivin kuvaustekstin, miten se tehdään, on käyttää "para" -tunnistetta. "para" tarkoittaa "kappaletta". Liitä para-tunnisteeseen yksiköt, joiden haluat rikkoa tällaisia rivejä:

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

Kuvaus näytetään rivinvaihdolla kuvan osoittamalla tavalla. Jos käytät asiakirjan luontityökalua, se näkyy myös kappaleena, jossa on rivinvaihtoja.