CS401～800

C# コンパイラエラー CS0738：インターフェイス実装の戻り値型不一致について解説

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

CS0738エラーは、クラスが実装すべきインターフェイスのメンバーの戻り値型と一致しない実装を行った場合に発生します。

例えば、インターフェイスで整数型を返すメソッドを、クラスでvoid型として実装するとエラーになります。

戻り値型を正しく変更することで解決できます。

目次から探す

原因の解説
- インターフェイス実装の基本原則
- CS0738エラーの意味
発生ケースと具体例
- インターフェイス定義の例
- クラス実装側の誤った例
エラー解決手順
- 戻り値型修正の方法
- デバッグのヒント
実装上の留意点
- インターフェイス実装時の注意点
まとめ

原因の解説

インターフェイス実装の基本原則

戻り値型の一致チェック

インターフェイスに定義されたメソッドは、必ず指定された戻り値型を持つ必要があります。

クラスがインターフェイスを実装する際、インターフェイス側で設定された戻り値型と、クラス側の実装が一致していることが求められます。

例えば、インターフェイスで戻り値がintと定義されている場合、クラス側のメソッドもintを返さなければなりません。

このルールは、コードの一貫性と信頼性を確保するために非常に重要です。

実装例にみる型不一致パターン

以下のサンプルコードは、インターフェイスの戻り値型がintであるにも関わらず、クラス側でvoidを返しているため、CS0738エラーが発生する例です。

using System;
interface ITest
{
    int TestMethod();
}
public class Test : ITest
{
    // エラー: 戻り値型が void であるため、インターフェイスの int と一致しません
    public void TestMethod()
    {
        // 戻り値を返していません
    }
    public static void Main()
    {
        // コンパイルエラーが解消される前は実行できません
        Console.WriteLine("CS0738エラーサンプル");
    }
}

CS0738エラーの意味

エラーメッセージの構造

CS0738エラーは、クラスの実装するメソッドの戻り値型が、インターフェイスで宣言された戻り値型と一致していない場合に発生します。

エラーメッセージには、実装しようとしているインターフェイスの名前やメソッド名、そして期待される戻り値型と実際の戻り値型が明示的に記載されるため、どの部分が不一致なのかが分かりやすくなっています。

例えば、メッセージに「“’TestMethod’ は、一致する ‘ITest’ の戻り値の型を持たないため～」と記載されている場合、クラス側の実装を見直す必要があることを示しています。

期待される実装とのギャップ

C#のインターフェイス実装では、宣言と実装が厳格に一致する必要があります。

インターフェイス側がint TestMethod()と定義している場合、クラス側も同様にintを返す必要があります。

もし、クラスで異なる型(例えばvoid)が使用されると、インターフェイスと実装との間に明確なギャップが生じ、コンパイル時にCS0738エラーが発生します。

このエラーは、プログラムの動作に予期しない影響を与える前に、問題箇所を特定する手助けとなります。

発生ケースと具体例

インターフェイス定義の例

正しい戻り値型設定のポイント

正しい実装では、インターフェイスで定義された戻り値型と、クラス側の実装が同一である必要があります。

以下のサンプルコードは、インターフェイスの定義に合わせてクラス側のメソッドが正しく実装されている例です。

using System;
interface ITest
{
    int TestMethod();
}
public class Test : ITest
{
    // 正しい実装: 戻り値型が int と一致しています
    public int TestMethod()
    {
        return 100; // 任意の整数を返す
    }
    public static void Main()
    {
        Test testInstance = new Test();
        Console.WriteLine(testInstance.TestMethod());
    }
}

クラス実装側の誤った例

voidとintの不一致ケース

不一致の代表例として、クラス側でvoidを戻り値型として定義してしまうパターンが挙げられます。

以下のサンプルコードでは、インターフェイスがintを要求しているのに対して、クラスの実装がvoidとなっており、CS0738エラーが発生します。

using System;
interface ITest
{
    int TestMethod();
}
public class Test : ITest
{
    // CS0738エラー: 戻り値型 void は int と一致しません
    public void TestMethod()
    {
        Console.WriteLine("戻り値を返していません");
    }
    public static void Main()
    {
         // コンパイルエラーのため、Mainは実行されません
         Test testInstance = new Test();
         testInstance.TestMethod();
    }
}

エラー解決手順

戻り値型修正の方法

コード修正の具体的手順

CS0738エラーを解消するには、以下の手順でコードを修正します。

まず、インターフェイスに定義されている戻り値型を確認します。
次に、クラスで実装しているメソッドの戻り値型がインターフェイスの定義と一致しているか確認します。
一致していない場合は、クラス側のメソッドの戻り値型を正しいもの(この場合はint)に変更します。
最後に、修正後にコンパイルしてエラーが解消されたかを再確認します。

以下は修正後の正しいサンプルコードです。

using System;
interface ITest
{
    int TestMethod();
}
public class Test : ITest
{
    // 修正済み: 戻り値型を int に合わせています
    public int TestMethod()
    {
        return 200; // 任意の整数を返す
    }
    public static void Main()
    {
         Test testInstance = new Test();
         Console.WriteLine(testInstance.TestMethod());
    }
}

修正後の確認ポイント

コード修正後は、以下の点を再確認してください。

メソッドの戻り値型がインターフェイスの定義と完全に一致していること。
他のメンバーも同様に、引数やアクセス修飾子などが正しく設定されているか。
修正が反映された状態でコンパイルが正常に終了するかどうかを確認する。

デバッグのヒント

コンパイラメッセージの読み解き

CS0738エラーのメッセージは、具体的な不一致の内容を示しています。

たとえば、メッセージの中に「void と int」という表記があれば、実装側の戻り値型が原因であることを示しています。

エラーメッセージに記載されるインターフェイス名やメソッド名を手がかりに、問題の箇所を迅速に特定することが重要です。

また、IDEのエラーメッセージをクリックすることで、該当するコード部分に直接ジャンプできるため、デバッグがより効率的になります。

実装上の留意点

インターフェイス実装時の注意点

明示的な実装の活用例

明示的なインターフェイス実装を用いると、同じメソッド名を持つ複数の実装が必要な場合や、インターフェイス専用の実装を行いたい場合に有効です。

以下のサンプルコードは、明示的なインターフェイス実装によって、インターフェイスのメソッドを独立して定義している例です。

using System;
interface ITest
{
    int TestMethod();
}
public class Test : ITest
{
    // 明示的な実装: インターフェイス専用としてメソッドを定義
    int ITest.TestMethod()
    {
        return 300;
    }
    public void CallTestMethod()
    {
        // クラス自身からは呼び出せないため、インターフェイスにキャストして呼び出す
        ITest testInterface = this;
        Console.WriteLine(testInterface.TestMethod());
    }
    public static void Main()
    {
         Test testInstance = new Test();
         testInstance.CallTestMethod();
    }
}

他の関連エラーとの違い

CS0738エラーは、主に戻り値型の不一致に起因するエラーですが、インターフェイス実装に関連するエラーは他にも存在します。

例えば、アクセス修飾子の不一致や、引数の型・数の違い、プロパティの実装不足などが挙げられます。

これらのエラーとの違いを理解することで、各エラーが示す問題点をより正確に特定でき、適切な修正が行いやすくなります。

まとめ

この記事では、CS0738エラーの原因と対策について解説しています。

インターフェイスの定義と実装において戻り値型の一致が求められる理由、型不一致パターンや具体的なエラー発生例を示し、コード修正の方法とデバッグのヒントを紹介しました。

正しい実装例や明示的なインターフェイス実装方法を理解することで、類似エラーの迅速な解決に役立てる内容となっています。