वस्तु सारांश में न्यूलाइन

Question

अभिवादन

प्रॉपर्टी / फील्ड / मेथड आदि के लिए सारांश सेट करते समय .. क्या इसमें एक नई रूपरेखा संभव है?

/// <summary>
/// This is line 1
/// This is line 2
/// </summary>
public bool TestLine { get; set; }

जब मैंने इसे सेट किया तो यह माउस के ऊपर जैसा दिखता है:

bool TestLine
This is line 1 This is line 2

लेकिन मैं यह दिखाना चाहता हूं:

bool TestLine
This is line 1 
This is line 2

मैंने प्रयोग करने की कोशिश की है \nलेकिन वह काम नहीं करता है। क्या इसे पूरा करने का कोई तरीका है?

Answer 1

आप कुछ इस तरह का उपयोग करना चाहते हैं

/// <summary> 
/// Your Main comment 
/// <para>This is line 1</para> 
/// <para>This is line 2</para> 
/// </summary> 
public bool TestLine { get; set; }

Comments

@YetAnotherUser, एक रिक्त रेखा के बारे में क्या?

— बेहजाद

@Behzad का उपयोग करने का प्रयास करें <para>&nbsp;</para>।

— येटनोथेरयूज़र

मुझे उन अतिरिक्त पंक्तियों से नफरत है :(

— Jan Macháček

विज़ुअल स्टूडियो 2017 आईडीई में, उपरोक्त "समाधान" वास्तव में लाइन 1 और लाइन 2 के बीच एक अकेला BLINE लाइन प्रदर्शित करता है (अर्थात, पंक्ति 1 के बाद की एक नई रेखा, फिर रिक्त पंक्ति 2 के बाद) - यह वही नहीं है नई लाइन, ओपी ने अनुरोध किया। क्या यह वीएस 2017 आईडीई में एक बग है - या हर कोई जो मतदान करता है, वह यह नहीं देखता कि यह उत्तर ओपी को वांछित आउटपुट के रूप में क्या दिखाता है?

— जजीमोव

वह नया पैराग्राफ है, नई लाइन नहीं। यह मुझे लगता है कि प्रलेखन वाक्यविन्यास कुछ सीमित है।

— ग्रिजली मैकबीयर

Answer 2

हाँ:

/// <summary> 
/// Main comment 
/// <para>Line 1</para> 
/// <para>Line 2</para> 
/// </summary> 
public bool TestLine { get; set; }

Answer 3

यह एक पुराना धागा हो सकता है लेकिन मैं विजुअल स्टूडियो 2019 का उपयोग करते समय एक अन्वेषक की खोज कर रहा था । मैं पैराग्राफ और लाइनें तोड़ना चाहता था। निम्नलिखित मेरे लिए अच्छी तरह से काम करता है:

/// <summary>
/// <para>parameter name="guidType" options:</para>
/// <br>0 = SequentialAsString</br>
/// <br>1 = SequentialAsBinary</br>
/// <br>2 = SequentialAtEnd</br>
/// </summary>

निम्नलिखित का उत्पादन करता है:

parameter name="guidType" options:

0 = SequentialAsString
1 = SequentialAsBinary
2 = SequentialAtEnd

Comments

VS2019 और इसके लिए, यह उत्तर तकनीकी रूप से स्वीकृत उत्तर की तुलना में अधिक सही है।

— रियान वाल्टर्स

तुम भी बस VS2019 में लाइन के अंत में सिर्फ <br /> का उपयोग कर सकते हैं। ये समाधान एक वास्तविक लाइन ब्रेक का उत्पादन करते हैं न कि एक खाली लाइन के साथ एक नया पैराग्राफ! धन्यवाद

— फिलिप एस

Answer 4

आप <para />सारांश के भीतर एक नई पंक्ति जोड़ने के लिए उपयोग कर सकते हैं :

/// <summary> 
/// Main comment<para />
/// Line 1<para />
/// Line 2<para />
/// </summary>
public bool TestLine { get; set; }

जैसा दिखता है:

Main comment
Line 1
Line 2

सादर!

Answer 5

मैं सिर्फ Xamarin स्टूडियो का उपयोग करके किसी के लिए इसे जोड़ रहा हूं जैसे मैं हूं। मैंने पाया कि उपरोक्त समाधानों में से कोई भी मेरे लिए काम नहीं करता है, लेकिन यह एक ने किया:

/// <summary>
/// Main summarry line.
/// <para></para>
/// <para></para>
/// Your secondary summary
/// </summary>

यह निम्न आउटपुट देता है:

Summary  
Main summary line.

Your secondary summary

Answer 6

यदि आप Swashbuckle (Swagger Web API इंटीग्रेशन लाइब्रेरी) का उपयोग कर रहे हैं तो <para></para>इसे बदल दिया जाना चाहिए <p></p>और <br/>इसका उपयोग भी किया जा सकता है।

तो निम्नलिखित है

    /// <para>
    ///     Flag1, Flag2
    ///     - bool flags, optional.
    /// </para>

हो जाता है

    /// <p>
    ///     Flag1, Flag2<br/>
    ///     - bool flags, optional.
    /// </p>

समस्या पहले से ही यहाँ बताई गई है: स्वशबकल दस्तावेज़ में लाइन ब्रेक कैसे जोड़ें? - एक विशेष विन्यास का उपयोग करते हुए, domaindrivendev की टिप्पणी, https://github.com/domaindrivendev/Swashbuckle/issues/258 - <br/>उपयोग पर ।

Answer 7

आप कानूनी रूप से पैरा टैग जोड़ सकते हैं, लेकिन यह वास्तव में प्रत्येक नई लाइन के लिए एक नया पैराग्राफ बनाता है और लाइन रिक्ति दिखाई देता है।
मैं व्यक्तिगत रूप से पैराग्राफ के चारों ओर 1 पैरा जोड़ता हूं और फिर brउन पंक्तियों के अंत में टैग करता हूं जिन पर मैं एक ब्रेक चाहता था, जो सभ्य लाइन रिक्ति को संरक्षित करता है:

/// <summary> 
/// <para>Main comment<br /> 
/// Line 1<br />
/// Line 2</para> 
/// </summary>
public bool TestLine { get; set; }

Comments

यह काम नहीं करता है, और <para> के साथ रिक्ति के बारे में कुछ भी नहीं है। VS / .Net के किस संस्करण का आप उपयोग कर रहे हैं?

— दानी

HTML टैग्स को अनदेखा कर दिया जाएगा summary, भले ही वे paraटैग के अंदर हों ।

— लजारो फर्नांडिस लीमा सुलेमान

Answer 8

यदि आप इसे बिना जटिल किए सारांश में कई लाइनें चाहते हैं तो मैं इस प्रारूपण का उपयोग करने का सुझाव दूंगा। यदि आप प्रत्येक पंक्ति के बाद <br /> टैग का उपयोग करते हैं तो यह काम करेगा।(पाठ के अंदर कहीं भी इसका उपयोग करने से एक नई पंक्ति बनेगी जहां टैग भी है।)

हालाँकि, ध्यान दें कि अगर आपके पास <br /> टैग के बाद कोई स्थान है, तो आपको अगली पंक्ति में एक अतिरिक्त स्थान मिलेगा। इसलिए आप प्रत्येक पंक्ति में एक ही स्थान चाहते हैं, इसलिए प्रत्येक पंक्ति एक सीधी रेखा में होगी।

/// <summary>
/// This is line 1<br />
/// This is line 2<br />
/// This is line 3<br />
/// </summary>
public bool TestLine { get; set; }

Comments

पहली बात मैंने हल खोजने से पहले कोशिश की क्योंकि वह काम नहीं करता है!

— फिलिप

मेरे लिए भी काम करता है। अपवोटेड

— अलेक्सवेई