XML açıklamalarını yeni bir satırda görüntülemek için

Visual Studio'da, C# ve VB.NET özellikleri ve yöntemleri hakkında XML belge yorumları yazabilirsiniz. Yazdıktan sonra, kodda yazarken özelliğin veya yöntemin açıklamasını görüntüleyebilir, fare imlecinin üzerine gelebilir ve "Sandcastle" gibi bir araç kullanabilirsiniz.

Ancak, çok fazla yazarsanız, okunabilirlik azalır, bu nedenle genellikle yaklaşık bir satıra yazarsınız, ancak bazı durumlarda birden fazla satırda görüntülemek isteyebilirsiniz.

Bir yorumdaki bir satırı normal şekilde keserseniz, açıklama görüntülendiğinde satır sonu ile görüntülenmesini beklersiniz, ancak gerçekten denediğinizde, aşağıdaki gibi görüntülenir.

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

Açıklama görüntüleme sonucu

Açıklama metninde satır sonu yoktur ve düzen boşluk içeriyormuş gibi görünür. XML, boşluk ve satır sonlarının nasıl işlendiği üzerinde farklı bir etkiye sahiptir ve Visual Studio normal satır sonlarını metin sonları olarak kabul etmez.

Bu nedenle, bir satırdaki açıklama metnini kırmak istiyorsanız, bunun nasıl yapılacağı "para" etiketini kullanmaktır. "para", "paragraf" anlamına gelir. Bunun gibi satırları kesmek istediğiniz birimleri bir para etiketine ekleyin:

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

Açıklama, şekilde gösterildiği gibi bir satır sonu ile görüntülenir. Belge oluşturma aracını kullanırsanız, satır sonları olan bir paragraf olarak da görünür.