لعرض تعليقات XML على سطر جديد

في Visual Studio، يمكنك كتابة تعليقات مستند XML على C# وخصائص VB.NET وأساليبها. بمجرد كتابته ، ستتمكن من عرض وصف الخاصية أو الطريقة عند كتابتها في التعليمات البرمجية ، وتمرير مؤشر الماوس ، واستخدام أداة مثل "Sandcastle".

ومع ذلك ، إذا كنت تكتب أكثر من اللازم ، فستنخفض قابلية القراءة ، لذلك عادة ما تكتبها في سطر واحد تقريبا ، ولكن في بعض الحالات قد ترغب في عرضها على أسطر متعددة.

إذا قمت بكسر سطر في تعليق بشكل طبيعي ، فتتوقع أن يتم عرضه بفاصل أسطر عند عرض الوصف ، ولكن عند تجربته بالفعل ، سيتم عرضه على النحو التالي.

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

نتيجة عرض الشرح

لا توجد فواصل أسطر في نص الوصف، ويبدو التخطيط كما لو كان يحتوي على مسافات. XML له تأثير متفاوت على كيفية التعامل مع المسافة البيضاء وفواصل الأسطر، ولا يعتبر Visual Studio فواصل الأسطر العادية فواصل نصية.

لذلك ، إذا كنت ترغب في كسر نص الوصف على سطر ، فكيفية القيام بذلك هي استخدام علامة "para". "para" تعني "الفقرة". أرفق الوحدات التي تريد كسر خطوط مثل هذه في علامة فقرة:

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

يتم عرض الوصف مع فاصل أسطر كما هو موضح في الشكل. إذا كنت تستخدم أداة إنشاء المستند، فستظهر أيضا كفقرة بها فواصل أسطر.