C#コンパイラエラー CS1914について解説 – 静的フィールド初期化の誤用と対策

CS1914エラーは、C#で静的フィールドにオブジェクト初期化子を使って割り当てを試みた際に発生します。

オブジェクト初期化子はインスタンスの初期化用となるため、静的フィールドには適用できません。

対策として、静的フィールドをインスタンスフィールドに変更するか、初期化子から静的フィールドの割り当てを除外してください。

静的フィールドとオブジェクト初期化子の基礎知識

静的フィールドの特徴

目的と利用上の留意点

静的フィールドは、クラス自体に紐付けられる変数で、クラスの全てのインスタンスで共有されます。

これは、たとえば共通の設定情報やカウンターなど、インスタンスごとに異ならないデータを扱う場合に有効です。

ただし、静的フィールドに対する初期化や変更のタイミングは注意が必要です。

インスタンス生成とは独立して管理されるため、インスタンス初期化子のようにオブジェクトごとに設定することはできません。

また、複数のスレッドから同時にアクセスするケースでは、排他制御も考慮する必要があります。

オブジェクト初期化子の基本

初期化の仕組みと制限事項

オブジェクト初期化子は、クラスの新しいインスタンス生成時に、そのプロパティやフィールドの値を一度に設定するための簡潔な構文です。

たとえば、以下のような書き方でインスタンスのプロパティを初期化することができます。

// インスタンス初期化子を用いたコード例
public class SampleClass
{
    public string Message { get; set; }
}
class Program
{
    static void Main()
    {
        // インスタンス生成と同時にプロパティを設定
        SampleClass instance = new SampleClass() { Message = "サンプルメッセージ" };
        System.Console.WriteLine(instance.Message);
    }
}

インスタンス初期化子は、インスタンスのプロパティを対象としており、静的フィールドには使用できません。

これは、インスタンス初期化子が生成されるたびに適用されるのに対し、静的フィールドはクラス全体で一つしか存在しないためです。

この制限を理解しておけば、意図しない動作を防ぐことができます。

CS1914エラーの発生原因

エラー発生条件の詳細

静的フィールドへの割り当て禁止

CS1914エラーは、オブジェクト初期化子を使用して静的フィールドに値を割り当てようとする場合に発生します。

クラスのインスタンスを初期化するためのオブジェクト初期化子は、あくまでインスタンスメンバーに対してのみ適用される構文です。

そのため、静的メンバーに対してオブジェクト初期化子を記述すると、C#コンパイラが誤用を検知しエラーを出力します。

エラーメッセージの解説

表示されるメッセージ内容と背景

CS1914エラーでは、「静的フィールド ‘name’ をオブジェクト初期化子に割り当てることはできません」というエラーメッセージが表示されます。

このメッセージは、オブジェクト初期化子はインスタンスの初期化を対象としているため、静的フィールドを初期化する目的では設計されていない点を指摘しています。

エラーメッセージの背景には、クラスの構造上、静的フィールドはインスタンスごとではなくクラス単位で管理されるという考え方が存在します。

CS1914エラーの対策と修正方法

インスタンスフィールドへの変更手法

手順とメリット

CS1914エラーを回避するための一つの方法は、静的フィールドをインスタンスフィールドに変更することです。

この手法を使えば、オブジェクト初期化子で値を設定することができ、コードがシンプルになります。

ただし、変更する場合は各インスタンスで独自のフィールド値を持つようになるため、クラス全体で共通のデータを保持する必要がある場合には注意が必要です。

オブジェクト初期化子からの静的フィールド除外

コード例による修正方法

もう一つの対策は、静的フィールドの初期化をオブジェクト初期化子ではなく、静的コンストラクタやMain関数内での明示的な代入に変更することです。

これにより、意図しないオブジェクト初期化子の使用を避け、静的フィールドを正しく管理できます。

コード例と実践上の注意事項

エラー発生コードの具体例

問題点の識別

以下は、CS1914エラーが発生する典型的なサンプルコードです。

このコードでは、TestClassの静的フィールドNumberに対して、オブジェクト初期化子から値を割り当てようとしている点が問題です。

// エラー発生サンプルコード: CS1914が発生します
using System;
public class TestClass
{
    public string Message { get; set; }
    public static int Number { get; set; }
}
class Test
{
    static void Main()
    {
        // CS1914エラー: 静的フィールド Number をオブジェクト初期化子で初期化している
        TestClass instance = new TestClass() { Message = "こんにちは", Number = 12345 };
        Console.WriteLine(instance.Message);
        Console.WriteLine(TestClass.Number);
    }
}

// コンパイル時に「静的フィールド 'Number' をオブジェクト初期化子に割り当てることはできません」というエラーが発生します

修正後のコード例

変更点の詳細説明

以下のコード例は、CS1914エラーを回避した修正版です。

静的フィールドNumberは、オブジェクト初期化子から分離し、Main関数内で直接初期化しています。

// 修正後のコードサンプル: 修正によりエラーが解消されます
using System;
public class TestClass
{
    public string Message { get; set; }
    public static int Number { get; set; }
}
class Test
{
    static void Main()
    {
        // 静的フィールド Number をオブジェクト初期化子外で初期化します
        TestClass.Number = 12345;
        TestClass instance = new TestClass() { Message = "こんにちは" };
        Console.WriteLine(instance.Message);
        Console.WriteLine(TestClass.Number);
    }
}

こんにちは
12345

開発環境での動作確認ポイント

実装時の確認事項と注意点

実装後は、以下の点について確認することが重要です。

• 静的フィールドが意図したタイミングで初期化されているか
• オブジェクト初期化子と静的フィールドの初期化処理が正しく分離されているか
• 実行結果が期待通りの値を出力しているか

また、環境によってはコンパイラの警告や静的解析ツールがさらに詳細な指摘を出す場合があるため、エラーメッセージの背景を理解しながら確認すると、より確実に動作させることができるでしょう。

まとめ

本記事では、静的フィールドとオブジェクト初期化子の基本的な特徴を解説し、静的フィールドにオブジェクト初期化子を使用した場合に発生するCS1914エラーの原因とその対策を説明しました。

具体例を通してエラー発生箇所と修正方法を示し、開発環境での動作確認のポイントにも触れることで、エラー解消に必要な知識が得られる内容となりました。