วิธีเพิ่มตัวแบ่งบรรทัดในเอกสารประกอบ C # .NET

ควรจะง่ายกว่านี้ ...

ฉันต้องการเพิ่มตัวแบ่งบรรทัด "รหัส" ลงในเอกสาร XML ในรหัสของฉัน

/// <summary>
/// Get a human-readable variant of the SQL WHERE statement of the search element. &lt;br/&gt;
/// Rather than return SQL, this method returns a string with icon-tokens, which 
/// could be used to represent the search in a condensed pictogram format.
/// </summary>

อย่างที่คุณเห็นฉันพบคำตอบบางอย่างที่แสดงการเพิ่ม <และ> วงเล็บเหลี่ยม ที่น่าสนใจการแบ่งบรรทัด 'ol <br /> ที่ดีไม่ได้สร้างการแบ่งบรรทัดในป๊อปอัพ Intellisense

ฉันพบว่ามันน่ารำคาญ ...

ข้อเสนอแนะใด ๆ

คุณสามารถใช้<para />แท็กเพื่อสร้างตัวแบ่งย่อหน้าหรือคุณสามารถตัดข้อความใน<para></para>แท็กเป็นวิธีการจัดกลุ่มข้อความและเพิ่มบรรทัดว่างหลังจากนั้น แต่ไม่มีอะไรเทียบเท่า<br />หรืออะไรทำนองนั้น (ซึ่งเป็นไปตามโพสต์ฟอรัม MS เก่านี้คือการออกแบบ) คุณสามารถรับรายการของแท็กที่มีอยู่ในบทความเอกสารนี้จาก MS เอกสารรหัสของคุณ

ตัวอย่าง (ขึ้นอยู่กับตัวอย่าง OP ต้นฉบับ):

/// <summary>
/// <para>Get a human-readable variant of the SQL WHERE statement of the search element.</para>
/// Rather than return SQL, this method returns a string with icon-tokens, which 
/// could be used to represent the search in a condensed pictogram format.
/// </summary>

นี่คือการใช้งานของฉันเช่น<br/>มันใช้งานได้ :)

/// <summary>
/// Value: 0/1/2
/// <para/>0 foo,
/// <para/>1 bar,
/// <para/>2 other
/// </summary>

ตั้งแต่ Visual Studio 2019 ใช้<br/>สำหรับบรรทัดใหม่ในความคิดเห็น

ตัวอย่าง:

/// <summary>
/// This is a comment.<br/>
/// This is another comment <br/>
/// This is a long comment so i want it to continue <br/> on another line.
/// </summary>

ขอให้สังเกตว่าไม่มีเส้นพิเศษที่เพิ่มเมื่อเราใช้แทน<br/><para>

เพิ่ม<para>แท็กที่มีถ่านพิเศษในนั้น 255 ถ่านหรือถ่านที่มองไม่เห็น

/// <summary>
/// Some text
/// <para>   </para>
/// More text
/// </summary>
/// <param name="str">Some string</param>
public void SomeMethod(string str) { }

มันจะทำงานเช่นนี้:

<br></br>และ<br />ดูเหมือนจะไม่ทำงานและบางครั้งมันก็ไม่เกี่ยวกับการทำให้<para>ประโยคแยกจากกันมากเท่าที่ความปรารถนาที่จะมีบรรทัดว่างสำหรับการแยกความกังวล ฉันกำลังพูดถึงเรื่องนี้ที่นี่เพราะคำถามนี้ดูเหมือนจะเป็นคำถามหลักสำหรับผู้ปกครองในคำถามนี้

สิ่งเดียวที่ฉันพบในการทำงานคือ

<para>&#160;</para>

ตัวอย่างเช่น

/// <summary>
///     <para>
///         "This sentence shows up when the type is hovered"
///     </para>
///     <para>&#160;</para>
///     <para>int PrimaryKey</para>
///     <para>&#160;</para>
///     <para>virtual Relation Relation</para>
/// </summary>

ผลลัพธ์ใน

"This sentence shows up when the type is hovered"

int PrimaryKey

virtual Relation Relation