CA1061:不要隐藏基类方法

属性	值
规则 ID	CA1061
标题	不要隐藏基类方法
类别	设计
修复是中断修复还是非中断修复	重大
在 .NET 8 中默认启用	作为建议

原因

派生类型声明的方法与其基方法之一具有相同的名称和相同数量的参数；一个或多个参数是基方法中相应参数的基类型；所有剩余参数的类型都与基方法中相应参数的类型相同。

规则说明

如果派生方法的参数签名只是在类型方面有所不同，而且与基方法的参数签名中的对应类型相比，这些类型的派生方式更弱，则基类型中的方法由派生类型中的同名方法隐藏。

如何解决冲突

若要解决此规则的冲突，请删除或重命名该方法，或者更改参数签名，使该方法不会隐藏基方法。

何时禁止显示警告

不禁止显示此规则发出的警告。

示例

以下示例显示与此规则冲突的方法。

class BaseType
{
    internal void MethodOne(string inputOne, object inputTwo)
    {
        Console.WriteLine("Base: {0}, {1}", inputOne, inputTwo);
    }

    internal void MethodTwo(string inputOne, string inputTwo)
    {
        Console.WriteLine("Base: {0}, {1}", inputOne, inputTwo);
    }
}

class DerivedType : BaseType
{
    internal void MethodOne(string inputOne, string inputTwo)
    {
        Console.WriteLine("Derived: {0}, {1}", inputOne, inputTwo);
    }

    // This method violates the rule.
    internal void MethodTwo(string inputOne, object inputTwo)
    {
        Console.WriteLine("Derived: {0}, {1}", inputOne, inputTwo);
    }
}

class Test
{
    static void Main1061()
    {
        DerivedType derived = new DerivedType();

        // Calls DerivedType.MethodOne.
        derived.MethodOne("string1", "string2");

        // Calls BaseType.MethodOne.
        derived.MethodOne("string1", (object)"string2");

        // Both of these call DerivedType.MethodTwo.
        derived.MethodTwo("string1", "string2");
        derived.MethodTwo("string1", (object)"string2");
    }
}