CS801～2000

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

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

CS1948は、C#のコンパイル時に発生するエラーです。

ジェネリックメソッドの型パラメーターとLINQクエリなどで使う範囲変数が同じ名前になっていると出ます。

両者が同じ識別子であるため、コンパイラーがどちらを参照するか判断できずエラーとなります。

対応策として、どちらかの名称を変更することで解消できます。

目次から探す

エラーCS1948の発生原因
- 型パラメーターと範囲変数の命名衝突
- 同一スコープ内での識別子重複
エラーが発生するコード例
- コード例の紹介
エラーCS1948の対策方法
- 識別子名称の変更による対策
- スコープ管理と命名規則の見直し
まとめ

エラーCS1948の発生原因

このエラーは、ジェネリックメソッドの型パラメーターとLINQクエリ内の範囲変数が同じ名前になっている場合に発生します。

両者は同一のスコープ内で扱われるため、識別子が重複してしまい、コンパイラがどちらを参照すべきか判断できなくなります。

型パラメーターと範囲変数の命名衝突

ジェネリックメソッドでは、型パラメーターはメソッド全体のスコープに影響を及ぼします。

そのため、同じ名前の識別子を別の用途(例えば、LINQクエリ内の範囲変数)で使用すると、コンパイル時に混乱が生じ、エラーCS1948が発生します。

ジェネリックメソッド内の型パラメーター

ジェネリックメソッドで宣言された型パラメーター(例：T)は、そのメソッド内のすべてのブロックで有効です。

このため、メソッド内で同じ名前の変数を別途宣言することはできません。

たとえば、以下のコードは型パラメーターのTを使用しているため、別の目的で同じ名前を使うとエラーが発生します。

LINQクエリ内の範囲変数

LINQクエリのfrom句では、コレクションの要素を順次処理するための範囲変数を宣言します。

もし、この範囲変数にジェネリックメソッドで既に使用されている型パラメーターと同じ名前を付けると、二重定義の状態となり、コンパイラーはどちらのTを参照しているか判断できず、エラーを報告します。

同一スコープ内での識別子重複

C#では、同一のスコープ内で同じ名前の識別子を複数回宣言することが禁止されています。

ジェネリックメソッドの型パラメーターとLINQクエリの範囲変数が同一スコープに存在すると、識別子の重複となるため、CS1948エラーが発生します。

これを防ぐために、異なる名前を使用する必要があります。

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

エラーCS1948がどのように発生するか、具体的なコード例を通して確認します。

コード例の紹介

以下のサンプルコードは、ジェネリックメソッドでの型パラメーターTとLINQクエリの範囲変数Tが重複している例です。

コード内のコメントでエラーが発生する箇所を示しています。

エラー発生時の具体例

using System;
using System.Linq;
class Test
{
    public void TestMethod<T>(T t)
    {
        // 以下のLINQクエリで型パラメーター T と同じ名前を範囲変数として使用しているため、エラーCS1948が発生します。
        var x = from T in Enumerable.Range(1, 100)
                select T;
        Console.WriteLine(string.Join(", ", x));
    }
    static void Main(string[] args)
    {
        Test test = new Test();
        test.TestMethod(10);
    }
}

// コンパイルエラー例: エラー CS1948: 範囲変数 'T' に、メソッド型パラメーターと同じ名前を指定することはできません。

コンパイラーメッセージの解析

コンパイラから次のようなエラーメッセージが出されます。

「範囲変数 ‘T’ に、メソッド型パラメーターと同じ名前を指定することはできません」

このメッセージは、型パラメーターTとLINQクエリの範囲変数Tが衝突していることを示しており、命名の重複が原因であると説明しています。

エラーCS1948の対策方法

このエラーを解決するには、型パラメーターと範囲変数の名前を変更し、同一のスコープ内で重複が発生しないようにする必要があります。

識別子名称の変更による対策

名前を変更することで、コンパイラがどちらの識別子を参照すべきか明確になり、エラーを解消できます。

型パラメーターの名称変更

型パラメーター自体の名前を変更する方法です。

例えば、以下のコードでは型パラメーターの名前をUに変更しています。

using System;
using System.Linq;
class Test
{
    public void TestMethod<U>(U u)
    {
        // LINQクエリ内の範囲変数として 'T' を使用していても、型パラメーターは 'U' となるため、エラーは解消されます。
        var x = from T in Enumerable.Range(1, 100)
                select T;
        Console.WriteLine(string.Join(", ", x));
    }
    static void Main(string[] args)
    {
        Test test = new Test();
        test.TestMethod(10);
    }
}

// 正常にコンパイルおよび実行され、1から100までの数字が出力されます。

範囲変数の名称変更

もうひとつの方法は、LINQクエリ内の範囲変数の名前を変更することです。

以下のコードは、範囲変数の名前をnumに変更し、型パラメーターTとの衝突を回避しています。

using System;
using System.Linq;
class Test
{
    public void TestMethod<T>(T t)
    {
        // 範囲変数名を 'num' に変更することで、型パラメーター 'T' と衝突しなくなります。
        var x = from num in Enumerable.Range(1, 100)
                select num;
        Console.WriteLine(string.Join(", ", x));
    }
    static void Main(string[] args)
    {
        Test test = new Test();
        test.TestMethod(10);
    }
}

// 正常にコンパイルおよび実行され、1から100までの数字が出力されます。

スコープ管理と命名規則の見直し

識別子の重複を防ぐためには、スコープ管理と命名規則の見直しも有効です。

同一のスコープ内で意味が重複しない名称を付けることで、コンフリクトのリスクを減らし、コードの可読性も向上させることができます。

重複宣言の防止方法

同じスコープ内で複数の識別子が重複しないようにするためには、以下のポイントに注意してください。

ジェネリックメソッドやラムダ式、LINQクエリなどで使用する変数名は、一意であることを確認します。
複数のスコープが入れ子になっている場合も、より内側のスコープで上位の識別子と同じ名前を使用しないようにします。
チーム内で命名規則を統一し、再利用性やメンテナンス性の高いコード設計を心がけます。

これにより、エラーCS1948だけでなく、その他の命名による衝突や予期せぬ動作を未然に防ぐことができます。

まとめ

この記事では、ジェネリックメソッド内で定義された型パラメーターとLINQクエリ内の範囲変数が同じ名前になると発生するコンパイラエラーCS1948の原因を解説しています。

具体例を通して、識別子重複がなぜ問題となるのかを理解し、対策として型パラメーターまたは範囲変数の名称変更、さらにはスコープ管理と命名規則の見直しが有効な方法である点が分かります。