XML Multiline تعليقات في C# - ماذا أفعل خطأ؟

Question

بالنسبة الى هذه المقالة, ، من الممكن الحصول على تعليقات XML متعددة الأليفة - بدلاً من الاستخدام ///, ، استعمال /** */. هذا هو تفسيري لماهية التعليقات المتعددة ، وما أريد أن يحدث:

/**
 * <summary>
 * this comment is on line 1 in the tooltip
 * this comment is on line 2 in the tooltip
 * </summary>
 */

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

/// <summary>
/// this comment is on line 1 in the tooltip
/// this comment is on line 2 in the tooltip
/// </summary>

هل هذا السلوك ممكن في الواقع في VS2008؟

تعديل

أشار غابي إلى أنني قد أساءت فهم معنى "multiline" ، وأحتاج فعلاً إلى استخدامه <para> أو <br> للحصول على تأثيري المقصود. تقدمت واستخدمت <br> لأنني أريد التحكم في مكان حدوث كسر الخط ، أي

/// <summary>
/// this comment is on line 1 in the tooltip<br/>
/// this comment is on line 2 in the tooltip<br/>
/// </summary>

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

تحديث

حسنًا ، تقدمت وحاولت <para> علامة على كل سطر ، وهذا يعمل. غير متأكد من السبب <br/> لا.

/// <summary>
/// <para>this comment is on line 1 in the tooltip</para>
/// <para>this comment is on line 2 in the tooltip</para>
/// </summary>

Answer 1

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

كونك "متعدد الخطوط" لا يقول شيئًا عن أي كيفية عرض النص داخل التعليق. لوضع استراحة خط في تعليق XML ، يجب عليك إدراج أ <br/> ("كسر") أو لف الخط في أ <para> ("الفقرة") العلامة.

Answer 2

جرب هذا

/// <summary>
/// this comment is on line 1 in the tooltip
/// <para>this comment is on line 2 in the tooltip</para>
/// </summary>

Answer 3

يضيف <br/> لكسر الخط أو إرفاق الفقرات في <para>...</para>. إنه تمامًا مثل XML و HTML ، فإن كسر الخط ليس سوى مساحة بيضاء.