phong cách kiểm soát resharper cop + comments

Question

này có vẻ như một câu hỏi tầm thường nhưng khi tôi cài đặt plugin StyleCop cho resharper ý kiến ​​của tôi đang nhận được định dạng như thế này

/// <summary> 
/// Gets the gift item. 
/// </summary> 
/// <param name="uid"> 
/// The uid. 
/// </param> 
/// <param name="upc"> 
/// The upc. 
/// </param> 
/// <returns> 
/// </returns> 
Gift GetGift(long uid, string upc); 

như trái ngược với

/// <summary>Gets the gift item.</summary> 
/// <param name="uid">The uid.</param> 
/// <param name="upc">The upc.</param> 
/// <returns></returns> 
Gift GetGift(long uid, string upc); 

tôi dường như không tìm thấy bất kỳ cách nào để tắt loại định dạng này.

Answer 1

Tặng GhostDoc một lần thử. Phần mở rộng Visual Studio miễn phí này tạo ra các nhận xét tài liệu XML đẹp hơn nữa. Các thẻ param và return được inline trong khi các thẻ summary vẫn còn trên các dòng riêng biệt. Có lẽ điều này đã phù hợp với nhu cầu của bạn.

Answer 2

Bạn có thể làm cho GhostDoc hoạt động nếu bạn tắt "Định dạng lại tài liệu XML được nhúng định dạng lại" trong cài đặt Mã làm sạch mặc định của bạn trong danh mục "C#". Sau đó, trong phần StyleCop, tắt quy tắc "1611: Tham số phần tử phải được ghi lại" và quy tắc "1618: Tham số kiểu chung phải được ghi lại". Bằng cách đó, việc dọn dẹp mã sẽ không làm xáo trộn các bình luận GhostDoc của bạn. Hãy nhớ rằng các tùy chọn Code Cleanup là giải pháp cụ thể.

Answer 3

Nếu bạn có plugin Microsoft Stylecop cho Resharper được cài đặt trong Resharper, hãy truy cập tùy chọn chia sẻ lại, công cụ, sau đó chọn StyleCop để Resharper. Ở đó bạn sẽ thấy một hộp kiểm cho Sử dụng các dòng đơn cho các tiêu đề khai báo.