CS801～2000

C# コンパイラエラー CS1604 について解説：読み取り専用変数への不正な割り当ての原因と対策

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

コンパイラエラー CS1604は、読み取り専用の変数に値を割り当てようとした際に発生するエラーです。

初期化済みの変数に再代入するとこのエラーが出ますので、対象の変数に対して変更操作が行われていないか確認してください。

目次から探す

エラー発生原因の詳細
- 読み取り専用変数の特性
- 再代入操作によるエラー発生
エラー回避方法の提案
デバッグと検証手法
- エラーログの確認方法
- 開発環境での検証手順
まとめ

エラー発生原因の詳細

読み取り専用変数の特性

変数宣言と初期化のルール

C#では、変数を宣言するときに読み取り専用であることを明示するために、readonlyキーワードやconstキーワードを使用します。

たとえば、constを用いた宣言の場合、変数の初期化と同時に値を設定する必要があり、その後の変更は許可されません。

以下はその例です。

using System;
class Program {
    static void Main(string[] args) {
        const int readOnlyValue = 10; // 初期化時に値を設定する必要がある
        // readOnlyValue = 20; // この再代入はエラーになる
        Console.WriteLine("読み取り専用変数 readOnlyValue の値: " + readOnlyValue);
    }
}

読み取り専用変数 readOnlyValue の値: 10

このように、変数宣言時に初期化し、その後変更ができないルールがあるため、意図せず再代入しようとするとコンパイラエラーが発生します。

読み取り専用属性の仕組み

readonlyキーワードをメンバ変数に使用する場合は、クラスのコンストラクタ内でのみ値を設定することができます。

これにより、クラスのインスタンス生成後に値が変更されないように設計されています。

例えば、以下のコードはその仕組みを示しています。

using System;
class Sample {
    public readonly int immutableValue; // 読み取り専用変数
    public Sample(int value) {
        immutableValue = value; // コンストラクタ内で初期化可能
    }
    public void AttemptChange() {
        // immutableValue = 100; // この行を有効にすると再代入エラー CS1604 が発生する
    }
}
class Program {
    static void Main(string[] args) {
        Sample sample = new Sample(5);
        Console.WriteLine("読み取り専用変数 immutableValue の値: " + sample.immutableValue);
    }
}

読み取り専用変数 immutableValue の値: 5

この仕組みにより、変数の不変性が保証され、意図しない変更によるバグを防止する効果があります。

再代入操作によるエラー発生

不正な代入のコード例

読み取り専用に設定された変数に対して値の変更を試みると、コンパイラはエラーCS1604を返します。

以下は不正な代入を行った例です。

using System;
class Program {
    static void Main(string[] args) {
        const int fixedValue = 50;
        // 以下は不正な代入のためエラーが発生するコード例
        // fixedValue = 100;
        Console.WriteLine("fixedValue の現在の値: " + fixedValue);
    }
}

fixedValue の現在の値: 50

このコードでは、constで宣言されたfixedValueに再代入しようとしたため、コンパイラエラーが発生します。

再代入が引き起こす問題点

読み取り専用変数への再代入を試みると、プログラムの信頼性が損なわれる可能性があります。

以下の点に注意が必要です。

変数の値が予期せず変わることにより、ロジックの矛盾が生じる
大規模なプログラムでは、参照先の変数が変更されると他の処理にも影響が出る恐れがある
コンパイル時にエラーが発生するため、早期に問題を発見しやすい

これにより、データの一貫性が保たれ、プログラム全体の安定性向上につながります。

エラー回避方法の提案

適切な変数宣言の見直し

読み取り専用と通常変数の使い分け

エラーを回避するためには、変数の用途に応じてconstやreadonlyを正しく利用し、必要に応じて通常の変数に切り替えることが有効です。

例えば、以下のように値が変更されることが想定される場合は、読み取り専用変数ではなく通常の変数を使用します。

using System;
class Program {
    static void Main(string[] args) {
        int mutableValue = 5; // 通常変数の宣言
        Console.WriteLine("初期値: " + mutableValue);
        mutableValue = 10; // 再代入可能
        Console.WriteLine("変更後の値: " + mutableValue);
    }
}

初期値: 5
変更後の値: 10

このように、変数が変更される可能性がある場合は通常の変数を使い、変更が不要であればconstやreadonlyを使うことで、エラーを未然に防ぐことができます。

再代入の必要性の再検討

コード設計時に再代入が本当に必要かどうかを見直すことで、意図しないエラーの発生を防ぐことができます。

値の変更が不要であるならば、最初から読み取り専用変数として宣言し、変更を防ぐ設計にすることが望ましいです。

このような設計思想は、プログラムの信頼性と可読性の向上に寄与します。

コード修正の具体例

修正前後のコード比較

以下は読み取り専用変数に対する不正な再代入を修正するためのコード例です。

修正前

using System;
class Program {
    static void Main(string[] args) {
        const int fixedNumber = 20;
        // fixedNumber = 30; // エラー CS1604: 読み取り専用変数への再代入
        Console.WriteLine("fixedNumber の値: " + fixedNumber);
    }
}

修正後

using System;
class Program {
    static void Main(string[] args) {
        int mutableNumber = 20; // 再代入が必要な場合は通常変数に変更
        Console.WriteLine("初期値: " + mutableNumber);
        mutableNumber = 30; // 再代入が可能
        Console.WriteLine("再代入後の値: " + mutableNumber);
    }
}

初期値: 20
再代入後の値: 30

このように、必要な状況に応じて変数の種類を変更することで、読み取り専用変数に対する誤った再代入のエラーを回避できます。

安全な実装方法のポイント

安全な実装を行うためには、以下のポイントに注意してください。

変数の性質を明確にし、再代入の必要がある場合はconstやreadonlyではなく通常変数を使用する
コードレビューの際に、変数の用途と変更可能性が整合しているかチェックする
可能であれば、定数や不変な値は変更されないように設計することで、バグの発生を未然に防ぐ

これらのポイントを押さえることで、エラーが発生しにくい堅牢なプログラムを実装できます。

デバッグと検証手法

エラーログの確認方法

コンパイラの出力解析

C#のコンパイラはエラー発生時に詳細な出力を提供します。

出力されたエラーメッセージを注意深く解析することで、どの変数が読み取り専用と指定されているのか、再代入がなぜ不正なのかが明確になります。

たとえば、エラーメッセージに「読み取り専用であるため ‘variable’ に割り当てできません」という記述がある場合、その変数はconstやreadonlyで宣言されていることが分かります。

エラーメッセージの詳細検証

エラーメッセージに含まれる情報を元に、問題箇所がコードのどこにあるかを特定することが重要です。

次の手順でエラーメッセージを検証してください。

エラー番号(例: CS1604)に注目する
コンパイラが示す行番号やファイル名を確認する
該当箇所での変数宣言と再代入部分を見直す

このプロセスにより、エラーの根本原因を迅速に把握し、修正の方向性を決定できます。

開発環境での検証手順

エラー再現の手順

エラーが再現可能な最小限のコードを作成することで、問題の特定が容易になります。

具体的には、以下のような手順で検証してください。

問題のあるコードを切り出して新規プロジェクトに貼り付ける
コンパイルしてエラーが発生するか確認する
エラーが出る箇所にコメントを追加して、エラーメッセージを記録する

この手法により、エラーが正確に再現でき、修正前後の比較検証がしやすくなります。

修正効果の検証方法

エラー修正後は、以下の手順で修正効果を検証してください。

修正前後のコードをそれぞれコンパイルし、エラーが解消されたことを確認する
テストコードを実行して、期待される出力結果が得られるかどうか確認する
必要に応じて、複数のシナリオで動作テストを行う

たとえば、以下のコード例でエラー修正の効果を確かめることができます。

using System;
class Program {
    static void Main(string[] args) {
        int number = 10; // 元の読み取り専用ではなく通常の変数に変更
        Console.WriteLine("初期値: " + number);
        number = 15; // 再代入可能
        Console.WriteLine("再代入後の値: " + number);
    }
}

初期値: 10
再代入後の値: 15

このテストにより、再代入が正常に動作することと、エラーが解消されたことを確認できるため、修正の効果が実証されます。

まとめ

本記事では、読み取り専用変数への不正な再代入によって発生するエラーCS1604について解説しています。

変数の宣言・初期化ルールやreadonlyおよびconstの仕組み、エラーが発生する具体例を示し、正しい変数選択とコード修正手法、デバッグ手順を紹介しています。

これにより、コードの信頼性を高めるための適切な変数管理の重要性が理解できます。