CS401～800

C# コンパイラエラー CS0470 の原因と解決方法について解説

2025-03-29更新日: 2025-03-29

CS0470は、C#でインターフェイスのアクセサを実装する際に発生するコンパイルエラーです。

インターフェイスに定義されたプロパティのゲッターやセッターを通常のメソッドで記述すると、仕様と異なるためエラーとなります。

修正のためは、明示的なインターフェイス実装を用いて正しい形式で記述する必要があります。

目次から探す

エラー発生の原因
- インターフェイス仕様とアクセサの役割
- 誤った実装方法の例
明示的インターフェイス実装の記述方法
- 正しいシンタックスの説明
- 注意すべき記述上のポイント
エラー処理と修正手順
- 修正前のエラーチェック
- 修正後の確認方法
まとめ

エラー発生の原因

このエラーは、インターフェイスのプロパティを実装する際に通常のメソッド実装を用いると発生することがあります。

たとえば、インターフェイスで宣言されたプロパティのアクセサ(getterやsetter)は、明示的な形で実装する必要がある場合が多いです。

正しく実装されないと、コンパイラがエラー CS0470 を出力します。

インターフェイス仕様とアクセサの役割

インターフェイスは、クラスや構造体が一定の機能を備えるための契約であり、その中で定義されるプロパティには特定のアクセサが求められます。

アクセサは、データの取得や設定の方法を定義しており、インターフェイスを実装する際にはその動作を揃える必要があります。

アクセサの基本動作と規定

インターフェイスに記述されたプロパティは、アクセサの動作が統一されています。

たとえば、以下のようなインターフェイスがあると仮定します。

interface IExample
{
    int SampleProperty { get; }
}

この場合、SampleProperty の getter は明示的に実装するか、自動プロパティなどで適切に実現する必要があります。

一般的なメソッドとして実装することは認められておらず、アクセサとしての規定に沿うよう記述する必要があります。

誤った実装方法の例

誤った実装は、C# の規定に反しているため、コンパイラエラー CS0470 が発生します。

主な原因は、インターフェイスのプロパティに対し通常のメソッド実装を行っている点にあります。

通常メソッド実装との違い

通常のメソッド実装はクラス内で自由に定義できるのに対し、インターフェイスのアクセサはプロパティとして定義される必要があります。

たとえば、以下のコードは誤った実装例です。

interface IExample
{
    int SampleProperty { get; }
}
class MyClass : IExample
{
    // 誤った実装：インターフェイスの getter を通常のメソッドとして実装している
    public int get_SampleProperty() { return 0; }
    // 正常なプロパティ実装：別のプロパティは通常の実装で問題ない
    public int AnotherProperty { get { return 1; } }
}
class Program
{
    static void Main(string[] args)
    {
        MyClass instance = new MyClass();
        System.Console.WriteLine(instance.AnotherProperty);
    }
}

上記の例では、get_SampleProperty というメソッドでプロパティを実装しているため、インターフェイスで要求されるアクセサとして認識されず、エラーが発生する原因となります。

明示的インターフェイス実装の記述方法

明示的なインターフェイス実装を用いると、インターフェイス仕様に則った形でプロパティのアクセサを正しく実装できます。

これにより、コンパイラエラー CS0470 を回避することが可能です。

正しいシンタックスの説明

明示的な実装では、クラス名やメソッド名にインターフェイス名を付加して記述します。

これにより、インターフェイスのプロパティやメソッドが独自の実装として認識されます。

以下に明示的インターフェイス実装の基本例を示します。

正常なプロパティ実装の例

次のコードは、正しいシンタックスでインターフェイスのプロパティを実装した例です。

interface IExample
{
    // インターフェイスでプロパティを宣言
    int SampleProperty { get; }
}
class CorrectClass : IExample
{
    // 明示的なインターフェイス実装
    int IExample.SampleProperty
    {
        get
        {
            // プロパティに対する計算または値の返却
            return 42; // 任意の処理結果
        }
    }
    // クラス独自のエントリポイント
    public static void Main(string[] args)
    {
        // IExample 型でインスタンスを扱う必要がある
        IExample instance = new CorrectClass();
        System.Console.WriteLine(instance.SampleProperty);
    }
}

この例では、IExample.SampleProperty の実装が明示的に記述されており、正しい表現であることが確認できます。

コード修正のポイント

既存のコードで誤った実装を修正する際は、以下の点に注意してください。

インターフェイスにあるプロパティやアクセサに対して、通常のメソッド実装ではなく明示的な実装を用いる。
クラス内で公開されるべき操作と、インターフェイスが要求する操作は明確に分離する。

以下に、誤った実装を正しく修正した例を示します。

interface IExample
{
    int SampleProperty { get; }
}
class FixedClass : IExample
{
    // 誤った実装部分を明示的な実装に修正
    int IExample.SampleProperty
    {
        get
        {
            // 正しい値を返す処理に変更
            return 100; // 任意の値または処理ロジック
        }
    }
    public static void Main(string[] args)
    {
        IExample exampleInstance = new FixedClass();
        System.Console.WriteLine(exampleInstance.SampleProperty);
    }
}

このように、誤ったインターフェイス実装を明示的な記法に変更することで、CS0470 エラーが回避されます。

注意すべき記述上のポイント

明示的インターフェイス実装を記述する際は、以下の点に注意してください。

明示的実装されたメンバーはクラスの外から直接アクセスできないため、インターフェイス型にキャストする必要がある。
同一クラス内で同名のメンバーを通常実装として公開する場合と明示的実装として定義する場合、名前の衝突に留意する。
コードの可読性向上のため、明示的実装と通常実装の使い分けを明確にする。

これらのポイントを意識することで、今後の開発時に同様のエラーを防止することができます。

エラー処理と修正手順

エラーが発生した場合、まずは詳細なエラーメッセージを確認し、修正手順に沿ってコードを見直すことが重要です。

CS0470 のエラーは明示的実装を用いることで解決されるため、正しい手順に従って修正を進めてください。

修正前のエラーチェック

エラーが出力された場合、まずはコンパイラのメッセージを確認することが第一歩です。

コンパイラは次のようなエラーメッセージを出力することが多いです。

コンパイラメッセージの解析

メソッド 'MethodName' は、型 'InterfaceName' のインターフェイス アクセサー 'AccessorName' を実装できません。明示的なインターフェイスの実装を使用します。

このエラーメッセージから、インターフェイスのアクセサーに対して不正な実装が行われていることがわかります。

エラーメッセージをもとに、どのプロパティやメソッドに問題があるのかを確認し、修正箇所を特定してください。

修正後の確認方法

修正作業が完了した後は、再度コンパイルしてエラーが解消されているか確認する必要があります。

正しい実装が行われたかを手順ごとにチェックすることが望ましいです。

コード変更点の確認

明示的インターフェイス実装を用いるようにコード変更点を確認してください。

具体的には、対象のプロパティやメソッドが以下のように記述されていることをチェックします。

ReturnType InterfaceName.MemberName
{
    get
    {
        // アクセサの処理
    }
}

コンパイル結果の検証

コード変更後、再度プロジェクトをコンパイルしてエラーが出力されないことを確認してください。

また、Main関数内で動作確認を行い、期待通りの出力が得られるかを検証することも重要です。

必要に応じて、デバッグ情報やログ出力を参考にして、正常な動作が確認できるかを見直してください。

以下に、修正後の検証用サンプルコードの例を示します。

interface IExample
{
    int SampleProperty { get; }
}
class VerifiedClass : IExample
{
    // 明示的インターフェイス実装を用いた正しい実装
    int IExample.SampleProperty
    {
        get
        {
            return 200; // エラーを回避した正しい値
        }
    }
    public static void Main(string[] args)
    {
        // IExample 型で扱うことで明示的実装されたメンバーにアクセス可能
        IExample instance = new VerifiedClass();
        System.Console.WriteLine(instance.SampleProperty);
    }
}

この検証例では、正しくコンパイルされた後に期待した出力が得られることで、修正が正確に反映されていることが確認できます。

まとめ

本記事では、インターフェイスのプロパティ実装において通常のメソッド実装が原因で発生するエラー CS0470 の原因と対策について説明しました。

明示的インターフェイス実装の正しい記述法や、コードの修正ポイント、エラー確認方法を実例とともに解説しました。

これにより、正しいシンタックスの理解とエラー回避の手順が明確になりました。