レベル3

C# コンパイラ警告 CS1702 の原因と対策について解説

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

CS1702はC#の開発中に発生するコンパイラ警告です。

同じ名前のアセンブリが異なるビルド番号やリビジョン番号で参照された場合、自動的に統合されず、.configファイルで実行時ポリシーを指定する必要があるケースがございます。

目次から探す

CS1702 警告の基本知識
警告発生の原因
警告への対策方法
- .configファイルによる実行時ポリシー指定
- 対策実施の手順
実環境での対応例
- 対策前の問題点
- 対策後の動作確認
まとめ

CS1702 警告の基本知識

警告の定義と発生条件

CS1702 警告は、アセンブリ参照が重複している場合に発生します。

具体的には、プロジェクト内で複数のアセンブリが参照され、その中でバージョンの違い(例：ビルド番号やリビジョン番号の差異)がある場合に警告が表示されます。

この警告は、アプリケーション実行時にどのアセンブリを優先するかが明確でない状況を示しており、開発者が意図的に実行時ポリシーを指定する必要がある場合に発生します。

アセンブリ参照の仕組み

C# ではプロジェクトに必要なライブラリ(アセンブリ)を参照する際、バージョンやパブリックキーなどの情報を元に参照処理が行われます。

複数バージョンのアセンブリが存在する場合、コンパイラはどのバージョンを使用するかの判断材料として、バージョン番号やビルド・リビジョン番号を参照します。
指定されたバージョンが完全に一致していないと、実行時に統合が行われず、結果として CS1702 警告が発生することになります。

実行時ポリシーの概要

実行時ポリシーは、アプリケーションの挙動を決定するための設定情報を提供する仕組みです。

アプリケーションの設定ファイル(通常は app.config や web.config)に記載され、どのバージョンのアセンブリを使用するかや統合方法を指定できます。
これにより、開発者が意図するアセンブリ統合を強制して実行時の不整合を回避することが可能です。

警告発生の原因

異なるバージョンのアセンブリ参照

プロジェクトで複数のアセンブリを参照する際、各アセンブリのバージョン情報に差異があると CS1702 警告が発生します。

この場合、どのバージョンのアセンブリを使用するかが自動判断されないため、実行時に明示的な設定が求められます。

ビルド番号とリビジョン番号の違い

ビルド番号は、アセンブリの大まかなリリースを示します。
リビジョン番号は、バグ修正や小規模な変更を示すため、より細かなバージョン管理に用いられます。

これらの番号にズレがあると、完全一致とみなされず、統合が自動で行われなくなります。

自動統合が行われない理由

自動統合が行われない理由は、アセンブリのバージョン間の差異が仕様上明確に区別されるためです。

開発者が明示的に統合意図を示さない限り、誤ったバージョン統合を避けるために自動での統合は行われません。
実行時ポリシーの指定によって、どのアセンブリを優先すべきかを明確にする必要があります。

開発環境への影響

開発環境では、複数のライブラリやパッケージが混在し、依存関係が複雑になる場合があります。

CS1702 警告は、意図しないバージョンのアセンブリが混在する可能性を知らせるため、実行時の動作に影響を与えるリスクを低減するため、大事な警告です。
特に大規模なプロジェクトや複数の開発者が参画する環境では、バージョン管理に注意が必要です。

警告への対策方法

.configファイルによる実行時ポリシー指定

実行時ポリシーは、.config ファイルに記述して、特定のアセンブリ統合のルールを明示する方法があります。

例えば、app.config ファイルに using ディレクティブを追加することで、警告が発生しないように設定できます。

usingディレクティブの設定方法

設定ファイル内で runtime セクションに assemblyBinding を追加し、使用するアセンブリの情報を記述します。

以下はサンプルです。

<configuration>
  <runtime>
    <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
      <!-- アセンブリ統合のルールを定義 -->
      <dependentAssembly>
        <assemblyIdentity name="AssemblyName1" publicKeyToken="XXXXXXXXXX" culture="neutral" />
        <bindingRedirect oldVersion="1.0.0.0-1.0.0.5" newVersion="1.0.0.5" />
      </dependentAssembly>
    </assemblyBinding>
  </runtime>
</configuration>

設定時の注意点

assemblyIdentity や bindingRedirect の値が正しいか確認する必要があります。
複数のアセンブリで同様の設定が必要な場合、一貫性を保つために全体を見直す必要があります。

対策実施の手順

対策を進めるための手順は以下の通りです。

プロジェクトで参照しているアセンブリのバージョン情報を確認する。
警告が発生するアセンブリの組み合わせを特定する。
対象の app.config ファイルに assemblyBinding セクションを追加する。
using ディレクティブで統合を指定し、正しいバージョンが使用されるように設定する。
設定変更後、ビルドおよび実行テストを行い、警告が解消されることを確認する。

実環境での対応例

対策前の問題点

対策を実施する前は、プロジェクト内で複数のバージョンのアセンブリが混在しており、CS1702 警告が頻繁に発生していました。

アプリケーション動作時に予期せぬライブラリが使用される恐れがありました。
チーム間で統一のアセンブリバージョンが共有されず、開発環境によって挙動が異なることがありました。

対策後の動作確認

問題解消の確認方法

対策後は、.config ファイルによって明示的に統合作業を行うため、指定したバージョンのアセンブリが使用されることを確認できます。

具体的には、プロジェクトをビルドして実行した際に、CS1702 警告が表示されなくなり、正しいライブラリが動作していることを検証します。

以下にサンプルコードを示します。

サンプルコードでは、実際にコンパイルおよび実行が可能な状態になっており、Main関数が含まれています。

using System;
namespace AssemblyBindingDemo
{
    // サンプルクラス(使用するアセンブリのバージョンについての疑似処理)
    public class AssemblyLoader
    {
        public void LoadAssembly()
        {
            // このメソッドはアセンブリの読み込みをシミュレーションします。
            // 実際のプロジェクトでは、この箇所で必要なアセンブリが正しいバージョンでロードされます。
            Console.WriteLine("指定されたアセンブリバージョンで動作中");
        }
    }
    class Program
    {
        static void Main(string[] args)
        {
            // AssemblyLoader クラスのインスタンスを生成し、メソッドを呼び出します。
            AssemblyLoader loader = new AssemblyLoader();
            loader.LoadAssembly();
            Console.WriteLine("サンプルプログラムが正常に終了しました");
        }
    }
}

指定されたアセンブリバージョンで動作中
サンプルプログラムが正常に終了しました

対策後の確認ポイント

ビルド時に CS1702 警告が表示されないか確認する。
正しいアセンブリバージョンが読み込まれていることを実行時に検証する。
チーム全体で設定ファイルの内容が共有され、同じ環境で動作していることを確認する。

まとめ

本記事では、CS1702 警告の発生原因や仕組み、アセンブリ参照のバージョン差異がもたらす問題、及びそれに対する.configファイルを用いた実行時ポリシーの指定方法を解説しました。

警告発生の背景を理解し、対策手順やサンプルコードを通して、実環境での具体的な対応方法が把握できる内容となっています。