C# コンパイラエラー CS0061: インターフェイスのアクセス修飾子不一致について解説
C#のコンパイラエラーCS0061は、インターフェイスのアクセス修飾子に一貫性がない場合に発生します。
具体的には、基本インターフェイスが公開(public)されているのに対し、派生インターフェイスのアクセスが制限(internalなど)されると起こります。
各インターフェイスのアクセシビリティを統一することで解決できます。
エラーCS0061の発生原因
アクセス修飾子の不一致
基本インターフェイスと派生インターフェイスの関係
基本インターフェイスと派生インターフェイスは、継承関係にあります。
そのため、派生インターフェイスは基本インターフェイスのアクセスレベルを越えることができません。
例えば、基本インターフェイスが internal として定義されている場合、派生インターフェイスを public で定義すると、継承関係に不整合が生じ、エラーとなります。
この関係は、以下の数式で表現できます。
ここで、internal は制限が強く、public は最も広いアクセスレベルとなるため、基本インターフェイスが internal の場合、派生インターフェイスも同様に internal でなければなりません。
不一致によるエラーメッセージの詳細
アクセス修飾子の不一致がある場合、コンパイラはエラーCS0061を表示します。
エラーメッセージには「アクセシビリティに一貫性がありません。
基本インターフェイス ‘interface 1’ のアクセシビリティはインターフェイス ‘interface 2’ よりも低く設定されています」という内容が記されます。
このメッセージは、基本インターフェイスと派生インターフェイス間でアクセスレベルに差があり、基本インターフェイスのアクセス修飾子が制限されすぎていることを示しており、設計上の注意点として理解することが重要です。
内部と公開のアクセスレベル
internalとpublicの役割
internal は、同一アセンブリ内でのみアクセス可能なアクセス修飾子であり、外部への公開を意図しない場合に使用されます。
対して public は、どのアセンブリからでもアクセスできることを意味します。
このため、インターフェイスやクラスの設計において、必要なアクセス範囲に合わせて適切な修飾子を選択することが求められます。
internal：アセンブリ内に留めたい場合public：広く利用されることを想定している場合
アクセス制限が引き起こす問題
アクセス制限が不整合な場合、例えば internal な基本インターフェイスを持ちながら、その派生インターフェイスを public に設定すると、利用側は予期せぬ制限に遭遇します。
これが原因で、コンパイラは整合性を保つためにエラーCS0061を発生させ、設計の見直しを促します。
また、実行時にはアクセス制御の期待と異なる振る舞いとなる可能性があるため、開発段階での回避が望まれます。
コード例で確認するエラーの事例
発生コードパターンの解説
問題発生時の具体的コード例
以下のサンプルコードは、エラーCS0061が発生する代表的な例です。
// サンプルコード：エラーが発生する場合
// compile with: /target:library
// 基本インターフェイスを internal として定義
internal interface BaseInterface { }
// 派生インターフェイスを public として定義(エラーとなる)
public interface DerivedInterface : BaseInterface { }
public class Program
{
public static void Main(string[] args)
{
// このプログラムはコンパイルエラーとなります
System.Console.WriteLine("アクセス修飾子の不一致エラーのサンプルです。");
}
}// コンパイル時に以下のエラーメッセージが表示されます:
// CS0061: アクセシビリティに一貫性がありません。基本インターフェイス 'BaseInterface' のアクセシビリティはインターフェイス 'DerivedInterface' よりも低く設定されています。コンパイラメッセージの解析
上記のコード例では、BaseInterface は internal に設定されており、DerivedInterface は public となっています。
コンパイラは、派生インターフェイスの public なアクセスレベルに合わせるために、基本インターフェイスのアクセス修飾子の整合性が保たれていないと認識し、エラーCS0061を返します。
このエラーは、インターフェイス継承の際に特に注意するべきポイントであり、アクセスレベルは厳密に一致させる必要があります。
修正コード例の検証
修正前後の比較
修正方法は、派生インターフェイスのアクセスレベルを基本インターフェイスに合わせるか、または基本インターフェイスを必要に応じて広くする方法があります。
以下に、両方の修正例を示します。
修正方法1：派生インターフェイスの修正
// 基本インターフェイスを internal として定義
internal interface BaseInterface { }
// 派生インターフェイスも internal に修正(整合性が取れています)
internal interface DerivedInterface : BaseInterface { }
public class Program
{
public static void Main(string[] args)
{
System.Console.WriteLine("修正後のサンプルコード：アクセス修飾子が整合しています。");
}
}修正後のサンプルコード：アクセス修飾子が整合しています。修正方法2：基本インターフェイスの修正
// 基本インターフェイスを public に修正
public interface BaseInterface { }
// 派生インターフェイスは public のまま(整合性が取れています)
public interface DerivedInterface : BaseInterface { }
public class Program
{
public static void Main(string[] args)
{
System.Console.WriteLine("修正後のサンプルコード：両方とも public に変更しています。");
}
}修正後のサンプルコード：両方とも public に変更しています。アクセス修正による動作確認
上記の修正コード例は、アクセスレベルの整合性が保たれているため、コンパイルが正常に完了します。
実行時に、サンプルコード内の Console.WriteLine のメッセージが表示されることで、エラーが解消されていることを確認できます。
アクセス修飾子設計の注意点
インターフェイス設計の基本原則
適切なアクセスレベルの選定基準
インターフェイスを定義する際は、その利用範囲に合わせて適切なアクセス修飾子を選ぶことが大切です。
- 自アセンブリ内のみで利用する場合は
internalを選択します。 - 他のアセンブリや外部に公開する場合は
publicを選択します。
この原則を元に、継承関係にあるインターフェイスも同様に設計する必要があります。
インターフェイス継承時の留意点
継承関係にあるインターフェイスでは、派生インターフェイスのアクセスレベルは基本インターフェイス以上でなければなりません。
そのため、既存の基本インターフェイスのアクセスレベルを変更する場合や、新たに派生インターフェイスを作成する場合は、以下の点に注意する必要があります。
- 基本インターフェイスのアクセスレベルに合わせる
- 派生インターフェイスの必要な利用範囲を考慮する
エラー防止のための実装方法
修正手順の確認
エラーCS0061を防止するためには、以下の手順に沿って実装を進めるとよいです。
- 基本インターフェイスのアクセスレベルを明確にする。
- 派生インターフェイスを定義する際、基本インターフェイスと同じアクセスレベルに設定する。
- コードレビューやコンパイル時のエラーチェックを通して、アクセス修飾子の不一致がないか確認する。
保守性向上のための対策
アクセス修飾子の不一致は、後々の保守性に影響を与える可能性があります。
以下の対策を講じると良いです。
- コーディング規約を策定し、インターフェイス設計の際のアクセスレベルの決定基準を明文化する。
- 定期的なコードレビューで、アクセス修飾子の不整合をチェックする。
- ツールや静的解析を利用して、自動的にアクセスレベルのチェックを行い、エラーの早期発見を促す。
これらの対策を講じることで、エラーCS0061の発生リスクを低減させ、より堅牢なソフトウェア開発が可能となります。
まとめ
この記事では、インターフェイス継承において発生するCS0061エラーの原因と、その修正方法について学びます。
internal と public の違いや、基本インターフェイスと派生インターフェイス間の整合性の重要性を理解し、実際のコード例で問題の発生と解決の手順を確認することで、健全なアクセス修飾子設計のポイントを把握できます。