CA1033:介面方法應該要可以由子類型呼叫

發行項
11/14/2023

屬性	值
規則識別碼	CA1033
標題	介面方法應該要可以由子類型呼叫
類別	設計
修正程式是中斷或非中斷	不中斷
預設在 .NET 8 中啟用	No

原因

非密封外部可見的類型會提供公用介面的明確方法實作，但未提供同名的替代外部可見方法。

檔案描述

請考慮明確實作公用介面方法的基底類型。衍生自基底型別的類型只能透過轉換成介面之目前實例的參考來this 存取繼承的介面方法。如果衍生型別重新實作（明確）繼承的介面方法，就無法再存取基底實作。透過目前實例參考的呼叫會叫用衍生實作;這會導致遞歸和最終堆疊溢位。

當提供外部可見Close()或System.IDisposable.Dispose(Boolean)方法時，此規則不會針對的明確實System.IDisposable.Dispose作報告違規。

如何修正違規

若要修正此規則的違規行為，請實作新的方法，以公開相同的功能，而且衍生類型或變更為非公開實作。如果可接受重大變更，替代方式是將類型密封。

隱藏警告的時機

如果提供具有相同功能但與明確實作方法不同的外部可見方法，則隱藏此規則的警告是安全的。

隱藏警告

如果您只想要隱藏單一違規，請將預處理器指示詞新增至原始程式檔以停用，然後重新啟用規則。

#pragma warning disable CA1033
// The code that's violating the rule is on this line.
#pragma warning restore CA1033

若要停用檔案、資料夾或項目的規則，請在組態檔中將其嚴重性設定為。none

[*.{cs,vb}]
dotnet_diagnostic.CA1033.severity = none

如需詳細資訊，請參閱如何隱藏程式代碼分析警告。

範例

下列範例顯示違反規則的類型 ViolatingBase，以及 FixedBase顯示違規修正的類型。

public interface ITest
{
    void SomeMethod();
}

public class ViolatingBase : ITest
{
    void ITest.SomeMethod()
    {
        // ...
    }
}

public class FixedBase : ITest
{
    void ITest.SomeMethod()
    {
        SomeMethod();
    }

    protected void SomeMethod()
    {
        // ...
    }
}

sealed public class Derived : FixedBase, ITest
{
    public void SomeMethod()
    {
        // The following would cause recursion and a stack overflow.
        // ((ITest)this).SomeMethod();

        // The following is unavailable if derived from ViolatingBase.
        base.SomeMethod();
    }
}

另請參閱

介面

共用方式為