Resharper 2016.1 格式化方法文档 header (XML 文档注释)

Question

我正在尝试让 Resharper 以某种方式重新格式化我的 XML 文档评论。我希望摘要文本在新行中，但其他标签在一行中。这与 Visual Studio 占位符文本的格式相同（当输入 /// 时）。

我已经搜索了 Whosebug，但还没有找到任何东西。

如果我的解释不够清楚，这就是我的意思：

清理前：

/// <summary>This is a summary</summary>
/// <param name="object">An object</param>

清理后（当前）：

/// <summary>
/// This is a summary
/// </summary>
/// <param name="object">
/// An object
/// </param>

清理后（需要）：

/// <summary>
/// This is a summary
/// </summary>
/// <param name="object">An object</param>

有办法吗？

做不到这一点，有没有办法用 Resharper 生成的摘要文本填充 Visual Studio 占位符文本？

（我已经在 Resharper 论坛上发布了这个问题，但还没有得到回复）

Answer 1

Resharper 目前似乎无法做到这一点。可以使用 Agent Smith plugin, as suggested by Jeremy Morton on my Resharper Support post.

来完成

为此：

安装特工史密斯
在 Resharper 选项中，在 AgentSmith 下 => Xml Documentation => Reflow And Retag
- 将<summary>设置为'Always'
- 将其他所有设置为 'Never'
保存您的更改。

这可以在单个评论上完成，方法是打开快速修复 window (Ctrl + .) 并选择 'Reflow & Retag Comment [Agent Smith]'。

它也可以设置为对整个文件进行更改 - 在代码清理期间 - 通过选择 'Reflow & Retag XML Documentation Comments' 和 'Reflow XML Documentation Comments' 选项。

Resharper 2016.1 Formatting method documentation header (XML Doc Comments)