Để hiển thị chú thích XML trên một dòng mới

Trong Visual Studio, bạn có thể viết nhận xét tài liệu XML về C# và VB.NET thuộc tính và phương pháp. Khi bạn viết nó, bạn sẽ có thể xem mô tả về thuộc tính hoặc phương thức khi bạn viết nó bằng mã, di con trỏ chuột và sử dụng một công cụ như "Lâu đài cát".

Tuy nhiên, nếu bạn viết quá nhiều, khả năng đọc sẽ giảm, vì vậy thông thường bạn sẽ viết nó trong khoảng một dòng, nhưng trong một số trường hợp, bạn có thể muốn hiển thị nó trên nhiều dòng.

Nếu bạn phá vỡ một dòng trong một nhận xét bình thường, bạn sẽ mong đợi nó được hiển thị với dấu ngắt dòng khi mô tả được hiển thị, nhưng khi bạn thực sự thử nó, nó sẽ được hiển thị như sau.

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

Giải thích hiển thị kết quả

Không có dấu ngắt dòng trong văn bản mô tả và bố cục trông như thể nó chứa khoảng trắng. XML có ảnh hưởng khác nhau đến cách xử lý khoảng trắng và ngắt dòng và Visual Studio không coi ngắt dòng bình thường là ngắt văn bản.

Vì vậy, nếu bạn muốn phá vỡ văn bản mô tả trên một dòng, làm thế nào để làm điều đó là sử dụng thẻ "para". "para" là viết tắt của "đoạn văn". Đặt các đơn vị bạn muốn ngắt các dòng như thế này trong một thẻ para:

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

Mô tả được hiển thị với dấu ngắt dòng như trong hình. Nếu bạn sử dụng công cụ tạo tài liệu, nó cũng sẽ xuất hiện dưới dạng một đoạn văn có ngắt dòng.