CA1033: インターフェイス メソッドは、子型によって呼び出し可能でなければなりません

  • [アーティクル]
プロパティ 値
ルール ID CA1033
Title インターフェイス メソッドは、子型によって呼び出し可能でなければなりません
[カテゴリ] デザイン
修正が中断ありか中断なしか なし
.NET 8 では既定で有効 いいえ

原因

シールされていない外部から参照できる型によって、パブリック インターフェイスを持つメソッドを明示的に実装しています。また、同じ名前を持つ外部から参照できる代替のメソッドがありません。

規則の説明

public インターフェイス メソッドを明示的に実装する基本データ型を考えます。 基本データ型から派生する型は、インターフェイスにキャストされている現在のインスタンス (C# の 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();
    }
}

関連項目