Câu hỏi Thêm ngắt dòng cho nhận xét cho Intellisense [trùng lặp]


Câu hỏi này đã có câu trả lời ở đây:

Có ai biết làm thế nào để chèn một ngắt dòng vào một bình luận tóm tắt để ngắt dòng được phản ánh trong tài liệu Intellisense?

Để làm rõ, hãy giả sử tài liệu mã ..

/// <summary>
/// Some text documentation
///  - a line break - 
/// Some more documentation
/// </summary>
public void SomeMethod() { }

Vì vậy, khi sử dụng phương pháp này Intellisense cung cấp một bản tóm tắt cho các phương pháp được định dạng như thế này:

Một số tài liệu văn bản

Một số tài liệu khác

(Lưu ý - thẻ 'para' không tạo ra ngắt dòng trống - tôi đã thử nó!)


76
2018-01-21 21:58


gốc


Một "para" là một nửa câu trả lời (đó là thực sự đôi break), bắt đầu và kết thúc của dòng được cắt ngắn. Để thực thi phá vỡ một dòng ở đầu và cuối của tóm tắt thêm sau "<para> </ para>" (nhân vật được bỏ qua - thực sự không nhìn thấy và không gian zero). - SoLaR


Các câu trả lời:


Hãy thử sử dụng điều này.

/// <summary>
/// <para>Paragraph 1.</para>
/// <para>Paragraph 2.</para>
/// </summary>

Nhưng tôi không nghĩ rằng bạn có thể có một dòng sản phẩm nào. Thẻ para trống bị bỏ qua.


67
2018-01-21 22:01



Tôi nghĩ bạn chỉ muốn nghỉ ngơi. Tôi không nghĩ rằng bạn có thể có một dòng sản phẩm nào. - Brian Kim
MS làm thế nào với ngoại lệ trong các phương thức chẳng hạn? - flesh
Các ngoại lệ là các thẻ riêng biệt trong XML. Nó không phải là một dòng trống trong bản tóm tắt, nó chỉ hiển thị các phần khác nhau của tài liệu - bdukes
Một phiên bản đẹp hơn: /// <summary> /// <para> Đoạn 1. </ Para> /// <para> Đoạn 2. </ Para> /// </ summary> - Peter Huber
Xin lỗi cho các định dạng xấu xí, nhưng stackoverflow ngu ngốc không cho phép thay đổi một bình luận sau 5 phút và ngăn chặn bất kỳ định dạng phong nha anyway. Mẫu thích hợp nhìn thấy trong bình luận tiếp theo. - Peter Huber


Thử cái này:

/// <summary>
/// <para> [Non-Breaking Space] </para>
/// </summary>

[Non-Breaking Space] thu được bằng cách sử dụng Alt+255 (sử dụng Numpad).

Nó sẽ hiển thị như một dòng mới trống. Tôi biết điều này là cũ, nhưng nó đã làm việc cho tôi ngày hôm nay.


46
2018-05-10 20:49



+1: tôi cuối cùng có một nơi để viết // Magic, đừng chạm vào. - Louis Kottmann
Chỉ cần một cái gì đó tôi muốn nói: WOW! - Joel
Đó có thể là điều tuyệt vời và khủng khiếp nhất xảy ra đồng thời ở rất nhiều cấp độ tương tự mà tôi từng thấy. Để thêm các dòng trống, tôi sẽ sử dụng gợi ý của Al Erickson &#160; nhưng để làm thụt đầu dòng, đây là cách đẹp hơn. - Daryl
Alt + 0173 trông giống ma thuật hơn. Đó là nhân vật vô hình và hoạt động, quá. - modiX
làm thế nào để sử dụng Alt + 255 trong VS 2015? khi tôi thử Alt + 255 trong VS 2015 không có gì xảy ra - srh


/// <summary><br />
/// <para>To treat comment line like a DIV tag, surround them with PARA tags.</para><br />
/// <para>To add a break with whitespace, add the following line:</para><br />
/// <para>&#160;</para><br />
/// </summary>

23
2018-03-25 14:58



<br /> một mình làm việc cho tôi. Sử dụng <para> các thẻ đã tạo quá nhiều phần đệm đã đẩy phần còn lại của các nhận xét của tôi vượt quá tràn. - drzaus
<para>&#160;</para> là điều tôi đang tìm kiếm, tnx :) - Krowi
<br /> không hoạt động trong VS 2017. - David


Hy vọng duy nhất của bạn có lẽ là một cái gì đó cludgy như thế này:

/// <summary>
/// <para>line one</para>
/// <para>_</para>
/// <para>line two</para>
/// </summary>

7
2018-01-21 22:20



cludgy có, nhưng thats gần như ive có cho đến nay - flesh


Vâng, đó là Xml. Có lẽ &#10;&#13;


-2
2018-01-21 22:16



không có chuyện đó ... - flesh