CS2001～

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

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

CS2034 エラーは、C# のコンパイル時に発生します。

/reference オプションにはファイル名を1つだけ指定する必要がありますが、複数のエイリアスや DLL を一度に指定してしまうとエラーとなります。

複数参照する場合は、各参照を個別に記述するよう修正してください。

目次から探す

エラー CS2034 の原因
- /reference オプションの誤った使い方
- コンパイラが誤認識する事例
エラー CS2034 の対処方法
- 正しい /reference オプションの使用法
- エイリアス宣言の正しい記述方法
再現例と修正例の解説
- 誤ったコード例の検証
- 修正後のコード例の提示
まとめ

エラー CS2034 の原因

/reference オプションの誤った使い方

/reference オプションの指定方法に誤りがあると、コンパイラエラー CS2034 が発生します。

指定するDLLファイルが1つのオプション内に複数記述されると、正しくエイリアスが割り当てられなくなります。

このセクションでは、DLLファイル指定方法とエイリアス宣言の複数指定ミスについて説明します。

DLLファイルの指定方法の誤り

/reference オプションには、1つのDLLファイルとエイリアスを指定するのが基本です。

たとえば、次のような記述は誤りです。

// エラー例: 複数のDLLを1つの /reference 指定内で一括指定するとエラーになります。
/r:A1=cs2034a1.dll;A2=cs2034a2.dll

上記のようにセミコロンで区切ると、コンパイラは1つのオプション内に複数のDLLファイルがあると認識してしまい、エラー CS2034 が発生します。

正しくは、各DLLファイルごとに個別の /reference オプションで指定する必要があります。

エイリアス宣言の複数指定ミス

エイリアス宣言を複数記述する場合も、正しい指定方法を守らなければエラーが発生します。

以下のコードはエイリアスの宣言例ですが、コマンドラインでの指定方法が誤っているとエラーになります。

// CS2034 エラーが発生するコード例
extern alias A1;
extern alias A2;
using System;

たとえば、上記のソースコードに対して次のようなコマンドラインでコンパイルした場合にエラーが出ます。

// エラー例: まとめてエイリアスとDLL指定を行っているためエラー
/r:A1=cs2034a1.dll;A2=cs2034a2.dll

正しい方法では、それぞれのエイリアスに対して個別の /reference オプションを利用します。

コンパイラが誤認識する事例

環境によっては、プロジェクトファイルの設定やコマンドラインの記述方法によって、意図せずコンパイラが複数のエイリアス宣言を1つの /reference オプションと認識する場合があります。

たとえば、プロジェクトファイル内の重複した参照設定や、誤ったパラメータの区切りにより、正しい記述であってもエラーが発生するケースがあります。

こうした場合は、参照設定を見直して、各DLLが個別に認識されるようにすることが必要です。

エラー CS2034 の対処方法

正しい /reference オプションの使用法

このセクションでは、/reference オプションを正しく利用するための方法を具体的に解説します。

DLLファイルごとに個別にオプションを指定することで、エイリアスとの紐付けが正しく行われ、CS2034 エラーが解消されます。

個別指定の方法

各DLLごとに個別の /reference オプションを使用して指定する方法は次の通りです。

// 正しい指定方法: それぞれのDLLファイルごとに個別のオプションを使用します。
/r:A1=cs2034a1.dll
/r:A2=cs2034a2.dll

この方法で指定することで、コンパイラは各エイリアスに対して正しいDLLファイルが対応することを認識でき、エラーが解消されます。

複数参照指定の具体例

Visual Studio のプロジェクトファイル(.csproj)で複数の参照を設定する場合も、各DLLごとに個別に指定します。

以下は、正しい参照設定の例です。

<ItemGroup>
  <Reference Include="cs2034a1">
    <Aliases>A1</Aliases>
    <HintPath>$(SolutionDir)libs\cs2034a1.dll</HintPath>
  </Reference>
  <Reference Include="cs2034a2">
    <Aliases>A2</Aliases>
    <HintPath>$(SolutionDir)libs\cs2034a2.dll</HintPath>
  </Reference>
</ItemGroup>

この設定により、各参照が個別に認識され、エイリアスも正しく割り当てられます。

エイリアス宣言の正しい記述方法

エイリアス宣言を正しく記述することで、同一名前空間内の別々のDLLから提供されるクラスの区別が容易になります。

ここでは、正しい記述方法とその注意点について説明します。

記述例による解説

以下は、エイリアス宣言を正しく記述したサンプルコードです。

extern alias 宣言は、他の using 宣言の前に記述する必要があります。

// 正しいエイリアス宣言の記述例
extern alias A1;
extern alias A2;
using System;
// サンプルコード: エイリアスを利用して外部DLLの機能を区別する例
class Program
{
    static void Main(string[] args)
    {
        // エイリアス A1 と A2 を使用してDLLから異なる機能を利用する場合の処理例
        System.Console.WriteLine("エイリアスを正しく利用しています。");
    }
}

このように記述することで、同じプロジェクト内で複数DLLから同一クラス名が存在する場合でも、正しく区別して使用することができます。

注意すべきポイント

エイリアス宣言に関して注意すべき点は以下の通りです。

各DLLの参照は個別の /reference オプションで指定する。
extern alias 宣言は、他の using 宣言よりも先に記述する。
プロジェクトファイルやビルドコマンドで、エイリアスとDLLファイルの対応関係が正しく設定されているか確認する。

再現例と修正例の解説

誤ったコード例の検証

ここでは、エラー CS2034 が発生する誤ったコード例を提示し、どの部分でエラーが起こっているかを確認します。

誤った参照指定が原因で、コンパイラがエイリアスを正しく認識できない例です。

エラー発生箇所の特定

次のサンプルコードは、誤った /reference オプション指定によりエラーが発生するケースを示しています。

// CS2034 エラーが発生する誤ったコード例
// コンパイルコマンド例: /r:A1=cs2034a1.dll;A2=cs2034a2.dll
extern alias A1;
extern alias A2;
using System;
class Program
{
    static void Main(string[] args)
    {
        // 誤った参照設定により、DLL間の区別ができずにエラーが発生します。
        System.Console.WriteLine("誤った参照設定によりエラーが発生します。");
    }
}

上記コードは、1つの /reference オプション内で2つのDLLを指定しているため、コンパイラがエイリアスを正しく認識できず、エラー CS2034 が報告されます。

// 出力結果例 (実際にはコンパイルエラーが発生します)
error CS2034: extern alias 宣言が1つの /reference オプションに対して複数記述されています。

修正後のコード例の提示

修正手順の具体例

コードを修正するための手順は以下の通りです。

それぞれのDLLファイルを個別の /reference オプションに分ける。
プロジェクトファイルやコマンドラインで、各エイリアスに対応するDLLが正しく指定されていることを確認する。
extern alias 宣言を利用する際は、他の using 宣言より前に記述する。

修正後の評価ポイント

修正後のコード例は次の通りです。

個別の /reference 指定を行い、エイリアス宣言も正しい位置に記述されています。

// 修正後のコード例
// コンパイルコマンド例:
// /r:A1=cs2034a1.dll
// /r:A2=cs2034a2.dll
extern alias A1;
extern alias A2;
using System;
class Program
{
    static void Main(string[] args)
    {
        // 正しくエイリアスが認識されるため、問題なく実行できます。
        Console.WriteLine("正しい参照設定によりエラーが解消されました。");
    }
}

正しい参照設定によりエラーが解消されました。

まとめ

本記事では、CS2034 エラーの原因として、/reference オプションで複数のDLLやエイリアスを一括指定する誤りがあることを解説します。

正しくは各DLLごとに別々のオプションを使用する必要があります。

誤った参照設定の具体例と、正しい設定方法をサンプルコードとともに説明しており、エラー発生箇所の特定と修正手順が理解できます。