כדי להציג הערות XML בשורה חדשה

ב- Visual Studio, באפשרותך לכתוב הערות למסמך XML במאפיינים ובשיטות של C# ו- VB.NET. לאחר שתכתוב אותו, תוכל להציג את תיאור המאפיין או השיטה בעת כתיבתו בקוד, לרחף על סמן העכבר ולהשתמש בכלי כגון "Sandcastle".

עם זאת, אם אתה כותב יותר מדי, הקריאות תפחת, ולכן בדרך כלל תכתוב את זה בערך שורה אחת, אבל במקרים מסוימים ייתכן שתרצה להציג את זה על מספר שורות.

אם תנתק שורה בהערה באופן רגיל, תצפה שהיא תוצג עם מעבר שורה כאשר התיאור מוצג, אך כאשר תנסה זאת בפועל, היא תוצג באופן הבא.

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

תוצאת תצוגת הסברים

אין מעברי שורה בטקסט התיאור, והפריסה נראית כאילו היא מכילה רווחים. ל- XML יש השפעה משתנה על אופן הטיפול ברווחים לבנים ובמעברי שורה, ו- Visual Studio אינו מחשיב מעברי שורה רגילים כמעברי טקסט.

לכן, אם ברצונך לשבור את טקסט התיאור בשורה, כיצד לעשות זאת היא להשתמש בתג "para". "para" מייצג "פסקה". צרף את היחידות שברצונך לשבור שורות כאלה בתג para:

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

התיאור מוצג עם מעבר שורה כפי שמוצג באיור. אם אתה משתמש בכלי יצירת המסמך, הוא יופיע גם כפסקה עם מעברי שורה.