CA1033: インターフェイス メソッドは、子型によって呼び出し可能でなければなりません
プロパティ | 値 |
---|---|
ルール ID | CA1033 |
Title | インターフェイス メソッドは、子型によって呼び出し可能でなければなりません |
[カテゴリ] | デザイン |
修正が中断ありか中断なしか | なし |
.NET 9 では既定で有効 | いいえ |
原因
シールされていない外部から参照できる型によって、パブリック インターフェイスを持つメソッドを明示的に実装しています。また、同じ名前を持つ外部から参照できる代替のメソッドがありません。
規則の説明
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();
}
}
関連項目
.NET