NewLine trong tóm tắt đối tượng

Lời chào hỏi

Khi thiết lập một bản tóm tắt cho một thuộc tính / trường / phương thức, v.v .. có thể có một dòng mới trong đó không?

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

Khi tôi đặt nó, nó sẽ hiển thị khi di chuột qua:

bool TestLine
This is line 1 This is line 2

Nhưng tôi muốn nó hiển thị như sau:

bool TestLine
This is line 1 
This is line 2

Tôi đã thử sử dụng \nnhưng điều đó không hoạt động. Có cách nào để hoàn thành việc này không?

Bạn muốn sử dụng một số thứ như thế này

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

Đúng:

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

Đây có thể là một chủ đề cũ nhưng tôi đã tìm kiếm một trình duyệt khi sử dụng Visual Studio 2019 . Tôi muốn ngắt đoạn và dòng. Những điều sau đây hoạt động tốt cho tôi:

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

Tạo ra những thứ sau:

parameter name="guidType" options:

0 = SequentialAsString
1 = SequentialAsBinary
2 = SequentialAtEnd

Bạn có thể sử dụng <para />để thêm một dòng mới trong phần tóm tắt:

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

Giống như:

Main comment
Line 1
Line 2

Trân trọng!

Tôi chỉ thêm điều này cho bất kỳ ai đang sử dụng Xamarin Studio như tôi. Tôi thấy rằng không có giải pháp nào ở trên phù hợp với tôi, nhưng giải pháp này đã làm được:

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

Điều này cho kết quả sau:

Summary  
Main summary line.

Your secondary summary

Nếu bạn đang sử dụng Swashbuckle (thư viện tích hợp API Web Swagger) thì <para></para>nên được thay thế bằng <p></p>và <br/>cũng có thể được sử dụng.

vì vậy sau đây

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

trở thành

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

Vấn đề đã được mô tả ở đây: Làm thế nào để thêm ngắt dòng vào tài liệu Swashbuckle? - sử dụng cấu hình đặc biệt, bình luận của domaindrivendev, https://github.com/domaindrivendev/Swashbuckle/issues/258 - về <br/>cách sử dụng.

Bạn có thể thêm thẻ para một cách hợp pháp, nhưng điều này thực sự tạo ra một đoạn mới cho mỗi dòng mới và khoảng cách dòng sẽ xuất hiện.
Cá nhân tôi thêm 1 para xung quanh đoạn văn và sau đó brgắn thẻ vào cuối các dòng tôi muốn ngắt, điều này duy trì khoảng cách dòng phù hợp:

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

Tôi khuyên bạn nên sử dụng định dạng này nếu bạn muốn có nhiều dòng trong bản tóm tắt mà không làm cho nó phức tạp. Nó sẽ hoạt động nếu bạn sử dụng thẻ <br /> sau mỗi dòng. (sử dụng nó ở bất kỳ vị trí nào bên trong văn bản sẽ tạo một dòng mới nơi cũng có thẻ.)

Mặc dù vậy, lưu ý rằng nếu bạn có khoảng trắng sau thẻ <br />, bạn sẽ có thêm một khoảng trắng ở dòng tiếp theo. Vì vậy, bạn muốn có cùng một lượng không gian trên mỗi dòng, vì vậy mọi hàng sẽ nằm trên một đường thẳng.

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