CS801～2000

C#コンパイラエラーCS1930：LINQクエリにおける重複した範囲変数の原因と解決方法について解説

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

CS1930エラーは、C#のLINQクエリにおいて同じ名前の範囲変数が複数回宣言された場合に発生します。

クエリ式内ではfrom句やlet句で導入された各範囲変数がスコープ内に存在するため、重複する識別子は使えません。

対策としては、各句で異なる名前を使用し、識別子の重複を避ける必要があります。

目次から探す

エラー発生の原因
- LINQクエリにおける範囲変数の仕組み
- 重複した宣言のメカニズムと発生条件
コード例による現象確認
- エラーが発生するコード例
- 発生箇所の特定と解析
エラー解決の方法
- 識別子を一意に設定する対策
- 修正前後の比較とポイント
注意点と補足事項
- 範囲変数のスコープ管理の重要性
- 他のLINQクエリとの相違点
まとめ

エラー発生の原因

LINQクエリにおける範囲変数の仕組み

LINQクエリでは、配列やコレクションなどのシーケンスの各要素を処理するために、範囲変数が利用されます。

たとえば、from句で宣言された変数は、指定されたシーケンス内の各要素を順次参照します。

また、let句によって新たな値を導入する場合も範囲変数が作成され、クエリ全体のスコープ内で有効となります。

ここで重要なのは、クエリ式が完了するまで、各範囲変数はそのクエリのスコープ内に保持されるため、同じ識別子の変数を複数回用いることはできません。

範囲変数はクエリ全体の中で宣言されるため、名前の衝突が発生すると、コンパイラは混乱してしまいます。

重複した宣言のメカニズムと発生条件

同一のクエリ式内で、複数のfrom句やlet句で同じ名前の変数を使用すると、範囲変数が重複して宣言されたと見なされます。

たとえば、from句でnumという変数が定義されている場合、同じクエリ内でlet句においてもnumという名前を利用すると、スコープ内に既に定義されたnumと衝突します。

この場合、コンパイラは重複した範囲変数の宣言としてエラーCS1930を発生させます。

エラーが生じる条件は、主に以下の場合です。

・同じクエリ式内の複数の句で同一の識別子を使用する

・外部スコープからの変数とクエリ内での範囲変数が名前衝突する場合

コード例による現象確認

エラーが発生するコード例

実際のコード例を通して、どのような状況でエラーが発生するのかを見ていきます。

from句での範囲変数の宣言

以下は、from句で範囲変数numが宣言される例です。

この部分だけでは問題は発生しませんが、クエリ内でnumという名前が再度使用されるとエラーが発生します。

using System;
using System.Linq;
class Program
{
    static void Main()
    {
        // 配列numsを宣言し、各要素に対して処理を行います
        int[] nums = { 0, 1, 2, 3, 4, 5 };
        // from句での範囲変数numの宣言
        // この宣言だけだとエラーは発生しません
        var query = from num in nums
                    select num;
        // 結果を出力する
        foreach (var item in query)
        {
            Console.WriteLine(item);
        }
    }
}

let句での範囲変数の宣言

次に、同じクエリ内でlet句により、既にfrom句で定義された変数と同じ名前を使用するとエラーが発生します。

これはコンパイラエラーCS1930の代表例です。

using System;
using System.Linq;
class Program
{
    static void Main()
    {
        // 配列numsを用意し、各要素ごとに処理を行います
        int[] nums = { 0, 1, 2, 3, 4, 5 };
        // ここでfrom句とlet句の両方で同じ範囲変数名"num"を使用するためエラーが発生します
        var query = from num in nums
                    let num = 3  // Error CS1930: 範囲変数 'num' は既に宣言されています
                    select num;
        // 結果の出力(実際にはコンパイルエラーとなるため、実行されません)
        foreach (var item in query)
        {
            Console.WriteLine(item);
        }
    }
}

// コンパイルエラー: CS1930 範囲変数 'num' は既に宣言されています。

発生箇所の特定と解析

エラーは、LINQクエリの各句が全体として一つのスコープに属していることに起因しています。

from句で定義された変数は、クエリ全体で有効なため、let句で同じ名前を使って新たな変数を導入しようとすると、前の変数が既に存在しているとしてエラーが発生します。

コンパイラはエラーメッセージにより、どの変数が重複しているのかを具体的に示してくれますので、これを参考に修正が必要です。

エラー解決の方法

識別子を一意に設定する対策

エラーを解決するためには、各句で使用する範囲変数の名前を一意に設定する必要があります。

具体的には、from句とlet句で別々の名前を使用するか、別の識別子を選択します。

命名規則の確認

ここでは、プロジェクト内で統一された命名規則を採用することで、同名の変数が意図せず使用されることを防ぐ方法について説明します。

たとえば、from句で使用する変数はシンプルな命名とし、let句での導入値は処理内容に沿った意味のある名前を使用するとよいでしょう。

コード修正手順の解説

重複エラーが発生した場合、以下の手順で修正を試みます。

コンパイラエラーの内容を確認し、どの変数名に重複があるかを特定します。
クエリ内で再宣言している箇所(通常はlet句)に、新たな識別子を付与します。
変更後の変数名に基づいて、参照箇所も必要に応じて修正します。

以下は、修正前と修正後のコードを比較した例です。

修正前のコード

using System;
using System.Linq;
class Program
{
    static void Main()
    {
        int[] nums = { 0, 1, 2, 3, 4, 5 };
        // from句で宣言したnumとlet句で宣言したnumが衝突するためエラーとなります
        var query = from num in nums
                    let num = 3  // 重複エラー
                    select num;
        foreach (var item in query)
        {
            Console.WriteLine(item);
        }
    }
}

修正後のコード

using System;
using System.Linq;
class Program
{
    static void Main()
    {
        int[] nums = { 0, 1, 2, 3, 4, 5 };
        // let句では異なる変数名fixedNumを使用することで、衝突を回避します
        var query = from num in nums
                    let fixedNum = 3  // 識別子を一意に変更
                    select fixedNum;
        foreach (var item in query)
        {
            Console.WriteLine(item);
        }
    }
}

修正前後の比較とポイント

修正前は、from句とlet句の両方でnumという同じ名前を使用していたため、クエリのスコープ内で同一識別子の重複が発生し、エラーを招いていました。

修正後は、let句で新たにfixedNumという別の名前を導入することで、重複が解消され、プログラムが正しくコンパイルされるようになります。

ポイントとしては、クエリ全体のスコープ内で変数名の一意性を意識することと、命名規則を明確に定めることが重要です。

注意点と補足事項

範囲変数のスコープ管理の重要性

LINQクエリにおいて範囲変数はクエリ全体で有効となるため、変数のスコープ管理が非常に重要です。

誤って同じ名前の範囲変数を複数回宣言してしまうと、コンパイル時にエラーが発生し、コードの信頼性にも影響を及ぼします。

スコープ管理を意識して、変数の命名を適切に行うことがトラブル回避に繋がります。

他のLINQクエリとの相違点

LINQのクエリ内での変数定義は、通常のプログラム変数とは作用範囲が異なります。

クエリ式では、各句が同一のスコープで処理されるため、別々のメソッドやブロックで宣言する場合とは違い、同じ識別子の使用が許されません。

また、メソッドシンタックスでの書き方の場合は、ラムダ式や匿名関数のスコープが関係してくるため、範囲変数と異なる取り扱いとなります。

これらの点を理解することで、より正確な記述が可能になります。

まとめ

本記事では、LINQクエリの範囲変数の仕組みと、それらの重複宣言により発生するコンパイラエラーCS1930の原因を解説しました。

具体例として、from句とlet句での同一識別子使用によるエラー事例を示し、各変数を一意に設定する命名規則やコード修正手順を具体的に説明しています。

これにより、LINQクエリにおける変数スコープ管理の重要性と、エラー解決方法が理解できる内容となりました。