CS2001～

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

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

CS8148はC#のコンパイラエラーです。

基本クラスのメソッドをオーバーライドする際、戻り値にrefを付けるかどうかの指定が一致していないと発生します。

例えば、基本クラスが値を返す場合に、派生クラスでref付きの戻り値を指定するとエラーとなります。

実装を見直し、基本クラスに合わせることで解消してください。

目次から探す

エラー発生の原因解析
- C#におけるオーバーライドのルール
- 戻り値の種類と整合性の必要性
CS8148エラーの具体例
- 基本クラスの実装事例
- 派生クラスにおける実装ミス
エラー修正の方法
- 基本クラスに合わせた修正手法
- 修正後の検証と確認
まとめ

エラー発生の原因解析

C#におけるオーバーライドのルール

C#では、継承関係にあるクラス間でメソッドをオーバーライドする際、基本クラスと派生クラスのメソッドシグネチャが完全に一致する必要があります。

これは、メソッド名、パラメーター、修飾子、戻り値の型すべてに適用されるルールです。

たとえば、基本クラスのメソッドが値として戻り値を返す場合、派生クラスで同じメソッドをオーバーライドする際に、refを使って参照渡しの戻り値に変更することはできません。

戻り値の種類と整合性の必要性

戻り値の種類には、値として返す「値戻り」と、変数自体の参照を返す「参照戻り」があります。

オーバーライドを行う際、基本クラスが値戻りの実装であれば、派生クラスも同じく値戻りで実装する必要があります。

両者の整合性が取れない場合、コンパイラはエラーを報告します。

値戻りと参照戻りの違い

値戻りは、戻り値そのもののコピーを返す仕組みです。

対して参照戻りは、変数自体への参照を返し、呼び出し側でその参照を通して直接値を書き換えることが可能になります。

たとえば、ある整数の値を返す場合は以下のように記述されます。

$return; number;$

一方、参照で返そうとする場合は、変数自体のアドレスを返す形となり、シンタックスにも注意が必要です。

CS8148エラーの具体例

基本クラスの実装事例

基本クラスでは、通常の値戻りによりメソッドを定義するのが一般的です。

たとえば、以下のコードは基本クラスで整数を値として返す実装例です。

基本クラスの実装例：

using System;
namespace ExampleNamespace
{
    public class BaseClass
    {
        // 整数を値として返すメソッド
        public virtual int GetNumber()
        {
            return 0;
        }
    }
    class Program
    {
        static void Main()
        {
            BaseClass baseInstance = new BaseClass();
            Console.WriteLine("BaseClass GetNumber: " + baseInstance.GetNumber());
        }
    }
}

BaseClass GetNumber: 0

派生クラスにおける実装ミス

派生クラスで基本クラスのメソッドをオーバーライドする際、シグネチャが一致しない場合にエラーが発生します。

特に、戻り値の型が異なる場合、C#コンパイラはエラーCS8148を出力します。

refキーワードの適用不一致によるエラー発生

以下の例では、基本クラスが値戻りとして実装されているにもかかわらず、派生クラスでrefキーワードを使い参照戻りとしようとするため、エラーが発生します。

なお、下記サンプルではエラーとなる部分の実装例をコメントアウトして記述し、実際に実行可能なコードとしては正しい実装を含めています。

using System;
namespace ExampleNamespace
{
    // 基本クラスの実装
    public class BaseClass
    {
        // 整数を値として返す
        public virtual int GetNumber()
        {
            return 0;
        }
    }
    // 以下はCS8148エラーが発生する実装例(コメントアウト)
    /*
    public class DerivedClass : BaseClass
    {
        private int number = 10;
        // 基本クラスが値戻りであるため、この参照戻りの定義はエラーとなる
        public override ref int GetNumber()
        {
            return ref number;
        }
    }
    */
    // 正しい実装例として、基本クラスのシグネチャに合わせる
    public class CorrectDerivedClass : BaseClass
    {
        private int number = 10;
        // 値として返す形に統一する
        public override int GetNumber()
        {
            return number;
        }
    }
    class Program
    {
        static void Main()
        {
            BaseClass instance = new CorrectDerivedClass();
            Console.WriteLine("CorrectDerivedClass GetNumber: " + instance.GetNumber());
        }
    }
}

CorrectDerivedClass GetNumber: 10

エラー修正の方法

基本クラスに合わせた修正手法

エラーCS8148が発生する原因は、基本クラスと派生クラスで戻り値の型に不整合がある場合です。

修正するには、派生クラスのメソッドシグネチャを基本クラスに合わせ、戻り値が値戻りとして定義されるように変更します。

これにより、コンパイルエラーが解消され、オーバーライドしたメソッドが正しく実行されるようになります。

メソッドシグネチャの統一

正しい実装例は、基本クラスのメソッドシグネチャに合わせて、派生クラスも値戻りの実装に統一する方法です。

以下のコードは、基本クラスと派生クラスで統一した実装例です。

サンプルコードではMain関数を含め、実行可能な状態になっています。

using System;
namespace ExampleNamespace
{
    // 基本クラスの実装
    public class BaseClass
    {
        // 整数を値として返す
        public virtual int GetNumber()
        {
            return 0;
        }
    }
    // 派生クラス：基本クラスのシグネチャに合わせ値戻りで実装
    public class DerivedClass : BaseClass
    {
        private int number = 25;
        // 基本クラスと同じく整数を値として返す
        public override int GetNumber()
        {
            return number;
        }
    }
    class Program
    {
        static void Main()
        {
            BaseClass baseInstance = new BaseClass();
            BaseClass derivedInstance = new DerivedClass();
            Console.WriteLine("BaseClass GetNumber: " + baseInstance.GetNumber());
            Console.WriteLine("DerivedClass GetNumber: " + derivedInstance.GetNumber());
        }
    }
}

BaseClass GetNumber: 0
DerivedClass GetNumber: 25

修正後の検証と確認

エラー修正後は、基本クラスと派生クラスのメソッドシグネチャが一致しているかを再確認する必要があります。

正しいシグネチャでオーバーライドが行えると、コンパイル時にエラーが解消され、実行時も正常な動作が期待できます。

コンパイルと実行時のチェックポイント

エラー修正後のコードをコンパイルする際、以下の点を確認してください。

基本クラスおよび派生クラスの戻り値の型が一致していること
overrideキーワードが正しく使用されていること
サンプルコードに含まれるMain関数が正しく動作し、期待通りの出力が得られること

上記のポイントをチェックすることで、オーバーライドに関連するエラーや動作の不一致を防ぐことができます。

まとめ

本記事では、C#のオーバーライドルールに基づき、基本クラスと派生クラス間で戻り値の種類が一致しないと発生するCS8148エラーの原因を解説しました。

特に、値戻りと参照戻りの違いや、refキーワードの適用不一致が引き起こすエラーの実例を紹介。

基本クラスに合わせたメソッドシグネチャの統一修正方法と、コンパイルおよび実行時の検証手順についても説明しており、これによりエラー解消と安定したコード実装の理解が深まります。