2

我正在尝试使用 Stylecop 4.7.31 我有一个项目,其中声明了一个接口:

public interface IRmlManager
{
    /// <summary>
    /// Adds the notification.
    /// </summary>
    /// <param name="notificationData">The notification data.</param>
    void AddNotification(RmlNotificationData notificationData);
}

和另一个项目,其中接口的实现:

public class RmlManager : IRmlManager
{
........
    /// ???
    void AddNotification(RmlNotificationData notificationData);
........
}

如果我使用<inheritdoc />而不是 ???,Stylecop 会忽略它并产生错误:

BusinessLogic\RmlManager.cs(39,1): error : SA1604: The documentation header must have a summary tag.
BusinessLogic\RmlManager.cs(39,1): error : SA1611: The documentation header must contain param tags matching the element's parameter list.

有什么想法我做错了吗?据谷歌称,Stylecop 大约从 4.1 版本开始支持这个标签

4

1 回答 1

0

我不想告诉你,但是 StyleCop 支持 Inheritdoc,根据http://stylecop.codeplex.com/workitem/6637

所以,这只能被假定为一个特定的实例(即它确实无法理解inheritdoc,只是这个特定的例子是一个错误行为)。

鉴于 inheritdoc 已被普遍接受,我建议您在 stylecop 特定列表上询问(在http://stylecop.codeplex.com/discussions上的 codeplax 上的他们网站上打开讨论),并可能制作一个重现案例并打开一个错误。

于 2012-06-14T21:14:33.993 回答