.NET Framework には、厳密なアセンブリ識別機構が盛り込まれており、Visual Studio で作成した実行ファイルやアセンブリは、それらが依存するアセンブリを名前とバージョンおよびその他の情報を使って判別します。

この仕組みは、DLL Hell を解消するためのもので、間違ったバージョンのアセンブリを参照することによる誤動作を避け、本来のバージョンのアセンブリを確実に参照することを目的としています。この機構により、Visual Studio で作成した実行ファイルやアセンブリは、それらが依存するアセンブリと同名のアセンブリが存在していても、アセンブリバージョンが一致しなければ動作しません。

バージョン管理ポリシー

JPAddress のアセンブリでは、メンバの変更や機能拡張により互換性が保たれないと判断した場合、アセンブリバージョンとファイルバージョンの両方を変更します。この場合、修正版適用後にプロジェクトをリビルドする必要があります。

アセンブリのメンバに変更がない場合や十分な互換性が保たれる場合は、ファイルバージョンだけを変更します。この場合、既存のプロジェクトのソースコードを変更する必要はありません。

なお、互換性が保たれない場合で、大幅な機能追加などが含まれる場合には、製品の識別のために名前空間やアセンブリ名を変更する場合もあります。

バージョンの確認

プロジェクトで使用しているアセンブリのアセンブリバージョンとファイルバージョンは以下の手順で確認できます。

1. Visual Studioを起動し対象となるプロジェクトを開きます。

2. フォームの［デザイン］ページで JPAddress のコンポーネントを選択します。

3. プロパティウィンドウで [バージョン情報] のリンクをクリックしてください。

4. 表示されたダイアログの「製品の詳細情報：」にバージョンが表示されます。

JPAddress のアセンブリ

依存関係にあるアセンブリを正しく動作させるには、それらのアセンブリバージョンが互いに適合していることが必要です。たとえば、GrapeCity.Windows.JPAddress.dll と GrapeCity.Windows.JPAddress.Design.dll は、互いに関連しています。そのため、これらのアセンブリバージョンとファイルバージョンは揃える必要があります。

通常は、アセンブリのバージョンを意識する必要はありませんが、作成したアプリケーションが配布先の環境で動作しない場合や、意図的にアセンブリを入れ替える場合は、プロジェクトが参照しているアセンブリのバージョンを確認してください。