Стиль cop + resharper комментарии управления

это может показаться тривиальным вопросом, но когда я установил плагин stylecop для resharper, мои комментарии будут отформатированы таким образом

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

в отличие от

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

Я не могу найти способ отключить этот тип форматирования.

Ответы

Ответ 1

Если у вас установлен плагин Microsoft Stylecop for Resharper в Resharper, перейдите к параметрам Resharper, Tools, затем StyleCop для Resharper. Там вы должны установить флажок Использовать одиночные строки для заголовков деклараций.

Ответ 2

Дайте GhostDoc. Это бесплатное расширение Visual Studio создает еще более приятные комментарии к XML-документам. param и return теги, в то время как теги summary остаются в отдельных строках. Возможно, это уже соответствует вашим потребностям.

Ответ 3

Вы можете заставить GhostDoc работать, если вы отключите "Reformat embedded XML doc comments" в настройках очистки кода по умолчанию в категории "С#". Затем в разделе StyleCop отключите правило "1611: параметры элемента должны быть документированы" и правило "1618: параметры типового типа должны быть документированы". Таким образом, очистка кода не приведет к искажению ваших комментариев GhostDoc. Имейте в виду, что параметры очистки кода зависят от конкретного решения.