CS0～400

C#のコンパイラエラーCS0159の原因と対処法について解説

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

C#のコンパイラエラーCS0159は、goto文で指定したラベルが存在しない場合に発生します。

goto文を使う際は、ジャンプ先のラベルが必ずスコープ内に定義されている必要があります。

例えば、switch文内で未定義のcaseラベルや、コード全体で存在しないラベルを指定すると、このエラーが出ます。

エラーを解消するには、対象のラベルを正しく定義しているか確認してください。

目次から探す

エラーの基本理解
- エラー定義
- goto文とラベルの関係
エラー原因の詳細解析
- ラベル未定義のケース
エラー対処法の解説
- コード修正の基本対応
エラー防止のポイント
まとめ

エラーの基本理解

エラー定義

コンパイラエラー CS0159 は、goto文で指定したラベルがその範囲内に定義されていない場合に発生します。

例えば、goto NOWHERE; と記述した際に、NOWHERE というラベルが存在しなければエラーとなります。

また、switch文内で goto case を使う場合、指定したケースが存在しないと同様にエラーとなります。

エラーの原因となる記述は、ラベルの見落としやスペルミスなどの場合が多いです。

goto文とラベルの関係

goto文は、指定したラベルへジャンプするために使われますが、ジャンプ先のラベルは同じブロック内または有効なスコープ内に存在していなければなりません。

以下の点に注意してください。

ラベルは、必ずコード内で定義されている必要があります。
switch 文の場合、各 case も内部的にはラベルとして扱われるため、存在しないケースへジャンプすることはできません。
プログラムの読みやすさや保守性のため、不要な goto 文の使用は避けるほうがよいとされています。

エラー原因の詳細解析

ラベル未定義のケース

ラベルが定義されていない状態で goto文を記述すると、エラー CS0159 が発生します。

よくある例として、goto文で参照しているラベル名の誤記や、ラベル自体を記述し忘れる場合が挙げられます。

switch文内でのラベルスコープの問題

switch文内で goto case を使用する場合、指定するケースが必ず存在している必要があります。

たとえば、以下のサンプルコードでは、存在しないケースにジャンプしようとしてエラーが発生します。

using System;
public class Program
{
    public static void Main(string[] args)
    {
        int value = 0;
        switch (value)
        {
            case 1:
                // 存在しないケース3へジャンプしようとするためエラーとなる
                // goto case 3;
                Console.WriteLine("Case 1 executed.");
                break;
            case 2:
                Console.WriteLine("Case 2 executed.");
                break;
        }
        // 存在しないラベルNOWHEREへジャンプしようとするためエラーとなる
        // goto NOWHERE;
        Console.WriteLine("Switch block completed.");
    }
}

Switch block completed.

上記のコードは、エラー原因を示すためにエラーとなる部分をコメントアウトしています。

実際の開発時には、存在しないケースやラベルへジャンプしないように注意が必要です。

その他の記述ミスによるエラー発生

デリミタ{}や;の記述ミス、またはラベル名のタイプミスも CS0159 発生の原因となります。

プログラムを書く際は、エディタの構文チェック機能を有効にして、ラベルやジャンプ先の名称に間違いがないか確認することが重要です。

エラー対処法の解説

コード修正の基本対応

CS0159 エラーが発生した場合、最初に行うべきはジャンプ先のラベルが正しく定義されているかの確認です。

コメントアウトされたエラー箇所や、エディタが示すエラー行を見直し、ラベル名やケース番号の修正、または不要な goto文の削除を検討してください。

必要なラベルの正しい定義方法

ラベルは、対応するコードブロック内に正しく記述する必要があります。

正しい例として、以下のサンプルコードがあります。

using System;
public class Program
{
    public static void Main(string[] args)
    {
        int value = 1;
        switch (value)
        {
            case 1:
                Console.WriteLine("Case 1 executed.");
                // 正しく定義されたラベルへジャンプする
                goto EndLabel;
            case 2:
                Console.WriteLine("Case 2 executed.");
                break;
        }
        EndLabel:
        Console.WriteLine("End label reached.");
    }
}

Case 1 executed.
End label reached.

上記のコードでは、EndLabel が正しく定義されており、goto EndLabel; で問題なくジャンプできます。

このように、ジャンプ先のラベルを明確に定義する方法を確認してください。

不要なgoto文の整理

場合によっては、goto文自体の利用を見直すことが望ましいです。

goto文を用いると、コードの流れが追いにくくなるため、条件分岐(if文や switch文)やループ文で代替できる場合はそちらを採用するようにしましょう。

たとえば、以下のサンプルコードでは、goto文を使用せずに適切な処理分岐を行っています。

using System;
public class Program
{
    public static void Main(string[] args)
    {
        int value = 1;
        if (value == 1)
        {
            Console.WriteLine("Case 1 executed.");
        }
        else if (value == 2)
        {
            Console.WriteLine("Case 2 executed.");
        }
        else
        {
            Console.WriteLine("Default case executed.");
        }
        Console.WriteLine("Control flow completed without goto.");
    }
}

Case 1 executed.
Control flow completed without goto.

このように、明示的なジャンプを避けることで、コードの可読性と保守性が向上します。

エラー防止のポイント

開発時のチェック事項

エラー防止のための基本ポイントとして、以下の点に注意してください。

ラベルやケースが正しく定義されているか確認する
コード内の goto 文の使用が必要かどうか再検討する
エディタの警告やエラー表示を無視せず、内容を理解する

コードレビューでの確認ポイント

コードレビュー時には、以下のポイントに留意することが重要です。

goto 文のジャンプ先がスコープ内に正しく存在しているか
不要な goto 文が残っていないか
他の制御文で代替可能な箇所はないかを確認する

デバッグ時の注意点

デバッグ時には、エラーメッセージが指摘している行やジャンプ先のラベルの存在を重点的に確認してください。

また、goto文を使用している場合、プログラムの実行フローが飛躍していないか、デバッガでステップ実行して動作を確認することが大切です。

エディタやIDEのデバッグツールを活用して、実行時のスコープや変数の状態を把握するようにしましょう。

まとめ

本記事では、CS0159 エラーの原因と対処法について、goto文とラベルの関係、特にswitch文内でのラベルスコープの問題やその他の記述ミスを中心に解説しました。

正しいラベル定義や不要なgoto文の整理により、エラーの解消とコードの保守性向上が図れる点が理解できます。