किसी नई पंक्ति पर XML टिप्पणियाँ प्रदर्शित करने के लिए

विजुअल स्टूडियो में, आप सी # पर एक्सएमएल दस्तावेज़ टिप्पणियां लिख सकते हैं और गुणों और विधियों VB.NET कर सकते हैं। एक बार जब आप इसे लिखते हैं, तो आप कोड में लिखते समय संपत्ति या विधि का विवरण देख पाएंगे, माउस कर्सर को घुमा सकते हैं, और "सैंडकैसल" जैसे उपकरण का उपयोग कर सकते हैं।

हालाँकि, यदि आप बहुत अधिक लिखते हैं, तो पठनीयता कम हो जाएगी, इसलिए आमतौर पर आप इसे लगभग एक पंक्ति में लिखेंगे, लेकिन कुछ मामलों में आप इसे कई पंक्तियों पर प्रदर्शित करना चाह सकते हैं।

यदि आप सामान्य रूप से किसी टिप्पणी में एक पंक्ति को तोड़ते हैं, तो आप उम्मीद करेंगे कि यह वर्णन प्रदर्शित होने पर लाइन ब्रेक के साथ प्रदर्शित होगा, लेकिन जब आप वास्तव में इसे आज़माते हैं, तो यह निम्नानुसार प्रदर्शित किया जाएगा।

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

स्पष्टीकरण प्रदर्शन परिणाम

वर्णन पाठ में कोई पंक्ति विराम नहीं हैं, और लेआउट ऐसा लगता है जैसे इसमें रिक्तियाँ हैं. एक्सएमएल का व्हाइटस्पेस और लाइन ब्रेक को कैसे संभाला जाता है, इस पर अलग-अलग प्रभाव पड़ता है, और विजुअल स्टूडियो सामान्य लाइन ब्रेक को टेक्स्ट ब्रेक नहीं मानता है।

इसलिए, यदि आप एक पंक्ति पर विवरण पाठ को तोड़ना चाहते हैं, तो यह कैसे करें "पैरा" टैग का उपयोग करें। "पैरा" का अर्थ है "पैराग्राफ"। उन इकाइयों को संलग्न करें जिन्हें आप पैरा टैग में इस तरह से तोड़ना चाहते हैं:

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

विवरण एक रेखा विराम के साथ प्रदर्शित किया जाता है जैसा कि आकृति में दिखाया गया है। यदि आप दस्तावेज़ जनरेशन उपकरण का उपयोग करते हैं, तो यह पंक्ति विराम वाले अनुच्छेद के रूप में भी दिखाई देगा.