Untuk memaparkan komen XML pada baris baru

Dalam Visual Studio, anda boleh menulis komen dokumen XML pada C# dan sifat dan kaedah VB.NET. Sebaik sahaja anda menulisnya, anda akan dapat melihat perihalan harta atau kaedah apabila anda menulisnya dalam kod, gerakkan kursor tetikus, dan gunakan alat seperti "Sandcastle".

Walau bagaimanapun, jika anda menulis terlalu banyak, kebolehbacaan akan berkurangan, jadi biasanya anda akan menulisnya dalam kira-kira satu baris, tetapi dalam beberapa kes anda mungkin mahu memaparkannya pada berbilang baris.

Jika anda memecahkan baris dalam komen secara normal, anda akan menjangkakan ia akan dipaparkan dengan pemisah baris apabila perihalan dipaparkan, tetapi apabila anda benar-benar mencubanya, ia akan dipaparkan seperti berikut.

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

Hasil paparan penjelasan

Tiada pemisah baris dalam teks perihalan, dan susun atur kelihatan seolah-olah ia mengandungi ruang. XML mempunyai kesan yang berbeza-beza tentang cara ruang putih dan pemisah baris dikendalikan dan Visual Studio tidak menganggap pemisah baris biasa sebagai pemisah teks.

Jadi, jika anda ingin memecahkan teks perihalan pada baris, cara melakukannya adalah menggunakan tag "para". "para" bermaksud "perenggan". Sertakan unit yang anda ingin pecahkan garisan seperti ini dalam tag para:

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

Perihalan dipaparkan dengan pemisah garis seperti yang ditunjukkan dalam rajah. Jika anda menggunakan alat penjanaan dokumen, ia juga akan muncul sebagai perenggan dengan pemisah baris.