C#コンパイラエラー CS0127：void型メソッドにおけるreturn文誤用の原因と対策について解説

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

CS0127は、void型のメソッドやアクセサ内で、return文を用いて値を返す記述がある場合に発生するコンパイラエラーです。

void型は値を返さないため、return文で返す値を削除して修正する必要があります。

目次から探す

エラーCS0127の発生原因
エラー修正と対策
- 正しいreturn文の使用法
- ソースコード修正の手順
実装例と検証
- 誤ったコード例の紹介
- 正しいコード例の解説
まとめ

エラーCS0127の発生原因

void型メソッドの基本

void型の役割と性質

C#におけるvoid型は、メソッドが何も値を返さないことを明示する型です。

メソッドの返り値の型にvoidを指定することで、そのメソッドは処理を実行した後に値を戻さない設計になっているため、処理結果を受け取る必要がありません。

例えば、ログ出力や状態更新など、返却値を必要としない場合に用いられます。

return文の意味と使い方

return文は、メソッドの実行を途中で終了するために使用します。

返り値が必要なメソッドの場合、return文を使って計算結果やオブジェクトを呼び出し元に返すことができます。

一方でvoid型のメソッドでは、処理途中で早期終了を行う際にreturn;(空のreturn)を使うことができます。

ただし、void型のメソッドでreturnに値を付与すると、コンパイラエラーCS0127が発生します。

return文誤用の具体例

アクセサ内でのreturn文の使用例

C#ではプロパティのgetアクセサは値を返すためにreturn文を用いますが、setアクセサは暗黙的にvoid型のため、値を返すreturn文を記述することはできません。

例えば、以下のコードではset内でreturn 0;と記述されており、これがエラーの原因となっています。

一般的な誤用パターンの検証

一般的に次のようなケースが誤用として挙げられます。

void型メソッド内で値を返そうとしてreturn 値;を記述してしまう例
プロパティやイベントのアクセサ内で意図せず値を返す記述が行われ、エラーが発生する例

これらのパターンでは、戻り値が不要な場所で無用な値の返却が試みられているため、コンパイラがエラーを報告します。

コンパイラの動作メカニズム

エラー発生時の処理フロー

コンパイラはソースコードを解析する際、各メソッドの返り値の型とreturn文を照合します。

void型メソッドに対して値を返そうとするreturn文が存在すると、C#の仕様に反しているため、エラーCS0127を発生させます。

エラー発生時には、コンパイラは以下のような処理フローを辿ります。

メソッド定義の返り値の型を確認
各return文の存在と、返却値があるかどうかを検証
void型で値を返す記述があれば、エラーとして処理を中断し、エラーメッセージを表示

このようなチェックにより、プログラムが意図しない挙動を示すことを未然に防いでいます。

エラー修正と対策

正しいreturn文の使用法

値返却不要なケースの確認

void型メソッドやsetアクセサなど、返り値を必要としないケースでは、値を指定したreturn文を記述する必要はありません。

もし早期終了を行いたい場合は、単にreturn;と記述するだけで十分です。

これにより、正しくコンパイラに意図が伝わり、エラーを防ぐことができます。

修正前後のコードの違い

修正前はvoid型メソッドで値を返そうとしているため、次のようになります。

public void UpdateStatus()
{
    // 不要な値を返してしまっている
    return 1;  // CS0127エラー発生
}

修正後は、値を返さずに単にメソッドを終了させるように記述します。

public void UpdateStatus()
{
    // 値を返さずに早期終了する記述
    return;
}

この差分により、コンパイラエラーが解消されます。

ソースコード修正の手順

変更ポイントの特定方法

エディタやコンパイラが出力するエラーメッセージを確認し、どのメソッドやアクセサでreturn文に余分な値が含まれているかを特定します。

具体的には、setアクセサ内やその他void型を返すメソッド内でreturn文を検索し、返却値が指定されている箇所を重点的に見直します。

修正作業の流れ

エラーメッセージに記載された箇所を確認する。
該当するreturn文から、値を取り除くか、必要に応じてメソッドの返り値の型を変更する。
修正後、再度コンパイルを行いエラーが解消されたことを確認する。

この手順に沿ってコードを修正することで、エラーを効率的に解消することが可能です。

実装例と検証

誤ったコード例の紹介

誤用によるエラー発生例

下記のサンプルコードは、setアクセサ内で誤って値を返しているため、コンパイラエラーCS0127が発生する例です。

using System;
namespace ErrorExample
{
    public class DemoClass
    {
        // プロパティの定義。getアクセサでは値を返すが、setアクセサはvoid型である
        public int SampleProperty
        {
            get
            {
                return 42; // 正しい返却処理
            }
            set
            {
                // CS0127エラー：void型のsetアクセサで値を返している(間違った記述)
                return 0;  // ここがエラーの原因
            }
        }
        public static void Main(string[] args)
        {
            // 実行は可能だが、コンパイル時にエラーが発生するため実行できない
            Console.WriteLine("エラーサンプルの実行開始");
        }
    }
}

// コンパイルエラー:
// error CS0127: 'DemoClass.SampleProperty.set': void型のメソッドまたはアクセサでは、'return' キーワードの後にオブジェクト式を指定できません。

エラー原因の詳細解析

上記のコードでは、setアクセサが暗黙的にvoid型で定義されているにもかかわらず、return 0;と記述されているため、コンパイラは値を返そうとする試みをエラーとして検出します。

この誤った記述は、アクセサの返り値の性質に反しているため、必ず修正する必要があります。

正しいコード例の解説

修正後の動作確認方法

以下は、誤ったコードを修正した正しいコード例です。

setアクセサから値を返さずに、単に処理を終了するreturn;を使用しています。

これにより、エラーCS0127は発生しなくなります。

using System;
namespace CorrectExample
{
    public class DemoClass
    {
        // プロパティの定義。getアクセサは値を返し、setアクセサはvoid型であるため返値は記述しない
        public int SampleProperty
        {
            get
            {
                return 42; // 正しい返却処理
            }
            set
            {
                // 値を返さずに処理を終了する記述に修正
                return;
            }
        }
        public static void Main(string[] args)
        {
            // 正しいコード例の実行。コンパイルエラーは発生しない。
            DemoClass demo = new DemoClass();
            demo.SampleProperty = 10;  // setアクセサを実行
            Console.WriteLine("正しいコードの実行が完了しました。");
        }
    }
}

正しいコードの実行が完了しました。

コンパイルチェックのポイント

修正後のコードでは、以下のポイントに注意してコンパイルチェックを行います。

void型のメソッドおよびアクセサ内で、return文に値が含まれていないかを確認。
各アクセサやメソッドが正しい型の返却を行っているかを確認。
コンパイルエラーが発生しないことを確認し、実際に実行して出力結果が期待通りとなることをチェック。

まとめ

本記事では、C#のコンパイラエラーCS0127の原因と対策について解説しています。

void型メソッドやsetアクセサ内において、不要な返却値を指定すると発生するエラーの背景から、正しいreturn文の使用法と具体的な修正手順まで、誤用例と正しいコード例を交えて説明しました。

これにより、エラーの原因を特定し、適切な修正方法を理解することができます。