Cách thêm ngắt dòng trong tài liệu C # .NET

Điều này sẽ dễ dàng hơn ...

Tôi muốn thêm ngắt dòng "được mã hóa" vào tài liệu XML trong mã của mình

/// <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>

Như bạn có thể thấy, tôi đã tìm thấy một số câu trả lời thể hiện việc thêm dấu ngoặc <và>. Thật thú vị, ngắt dòng 'ol <br /> tốt không tạo ra ngắt dòng trong cửa sổ bật lên Intellisense.

Tôi thấy phiền phức ...

Bất kỳ đề xuất?

Bạn có thể sử dụng <para />thẻ để tạo ngắt đoạn hoặc bạn có thể bọc văn bản trong <para></para>thẻ như một cách để nhóm văn bản và thêm dòng trống sau nó, nhưng không có tương đương <br />hoặc bất cứ điều gì tương tự. (Theo bài đăng trên diễn đàn MS cũ này là do thiết kế.) Bạn có thể lấy danh sách các thẻ có sẵn trong bài viết tài liệu này từ MS. Tài liệu mã của bạn

Ví dụ (dựa trên mẫu OP gốc):

/// <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>

Đây là cách sử dụng của tôi, như <br/>, nó đang hoạt động :)

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

Kể từ Visual Studio 2019, sử dụng <br/>cho các dòng mới trong các bình luận.

Thí dụ:

/// <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>

Lưu ý rằng không có thêm dòng bổ sung khi chúng tôi sử dụng <br/>thay vì <para>.

Thêm một <para>thẻ với một char đặc biệt trong đó, char char 255 hoặc char vô hình .

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

Nó sẽ hoạt động như thế này:

<br></br>và <br />dường như không hoạt động, và đôi khi nó không thực sự làm cho các <para>câu tách biệt nhiều như mong muốn có một dòng trống để phân tách mối quan tâm. Tôi đang đề cập đến vấn đề này ở đây bởi vì câu hỏi này dường như dành cho phụ huynh đối với nhiều câu hỏi đóng có tính chất này.

Điều duy nhất tôi tìm thấy để làm việc là

<para>&#160;</para>

Ví dụ

/// <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>

Kết quả trong

"This sentence shows up when the type is hovered"

int PrimaryKey

virtual Relation Relation