StyleCop for Resharper - Insert Method Header，如何在 <param> 标签后禁用换行符

Question

如何阻止 Resharper（或 ReSharper 本身）的 StyleCop 在开始 param 元素标记之后和之前添加换行符添加方法头文档时的结束标记。

发件人：-

/// <param name="name">
/// The name.
/// </param>

收件人：-

/// <param name="name">The name.</param>

我已经取消选中 XML 文档注释 部分下提到换行符的所有内容，但无济于事，但找不到其他相关部分？

Answer 1

在 Visual Studio 菜单中 "Resharper" > "Options" 转到 "Tools" > "StyleCop" 并选中 "Use single lines for declaration headers".

Screenshot (link to imgur.com)

然而，这将适用于所有文档元素，而不仅仅是参数，例如：

/// <summary>The send error.</summary>
/// <param name="errorId">The error id.</param>
/// <param name="type">The type.</param>
/// <param name="message">The message.</param>

与以下相比，当复选框未选中时：

/// <param name="errorId">
/// The error id.
/// </param>
/// <param name="type">
/// The type.
/// </param>
/// <param name="message">
/// The message.
/// </param>

如果你想要比这更自定义，我怀疑你需要在那之后手动调整它。

StyleCop for Resharper - Insert Method Header，如何在 <param> 标签后禁用换行符

StyleCop for Resharper - Insert Method Header, how to disable line break after <param> tag

resharper

xml-documentation