バージョン管理とアセンブリ
.NET Frameworkには、厳密なアセンブリ識別機構が盛り込まれており、Visual Studioで作成した実行ファイルやアセンブリは、それらが依存するアセンブリを名前とバージョンおよびその他の情報を使って判別します。
この仕組みは、DLL Hellを解消するためのもので、間違ったバージョンのアセンブリを参照することによる誤動作を避け、本来のバージョンのアセンブリを確実に参照することを目的としています。この機構により、Visual Studioで作成した実行ファイルやアセンブリは、それらが依存するアセンブリと同名のアセンブリが存在していても、アセンブリバージョンが一致しなければ動作しません。
アセンブリのメンバに変更がない場合や十分な互換性が保たれる場合は、ファイルバージョンだけを変更します。この場合、既存のプロジェクトのソースコードを変更する必要はありません。
なお、互換性が保たれない場合で、大幅な機能追加などが含まれる場合には、製品の識別のために名前空間やアセンブリ名を変更する場合もあります。
Windowsフォームアセンブリ
Web（ASP.NET）アセンブリ
WPFアセンブリ
この仕組みは、DLL Hellを解消するためのもので、間違ったバージョンのアセンブリを参照することによる誤動作を避け、本来のバージョンのアセンブリを確実に参照することを目的としています。この機構により、Visual Studioで作成した実行ファイルやアセンブリは、それらが依存するアセンブリと同名のアセンブリが存在していても、アセンブリバージョンが一致しなければ動作しません。
バージョン管理ポリシー
JPAddressのアセンブリでは、メンバの変更や機能拡張により互換性が保たれないと判断した場合、アセンブリバージョンとファイルバージョンの両方を変更します。この場合、修正版適用後にプロジェクトをリビルドする必要があります。アセンブリのメンバに変更がない場合や十分な互換性が保たれる場合は、ファイルバージョンだけを変更します。この場合、既存のプロジェクトのソースコードを変更する必要はありません。
なお、互換性が保たれない場合で、大幅な機能追加などが含まれる場合には、製品の識別のために名前空間やアセンブリ名を変更する場合もあります。
| 変更の程度 | アセンブリバージョン | ファイルバージョン | ソースの変更 | 再ビルド |
|---|---|---|---|---|
| 互換性が保たれない変更 | 更新される | 更新される | 必要 | 必要 |
| 互換性が保たれる変更 | 更新されない | 更新される | 不要 | 必要 |
バージョンの確認
プロジェクトで使用しているアセンブリのアセンブリバージョンとファイルバージョンは以下の手順で確認できます。- Visual Studioを起動し対象となるプロジェクトを開きます。
- フォームの［デザイン］ページでJPAddressのコンポーネントを選択します。
- プロパティウィンドウで [バージョン情報] のリンクをクリックしてください。
- 表示されたダイアログの「製品の詳細情報：」にバージョンが表示されます。
JPAddressのアセンブリ
依存関係にあるアセンブリを正しく動作させるには、それらのアセンブリバージョンが互いに適合していることが必要です。たとえば、GrapeCity.Win.JPAddress.dll と GrapeCity.Win.JPAddress.Design.dll は、互いに関連しています。そのため、これらのアセンブリバージョンとファイルバージョンは揃える必要があります。Windowsフォームアセンブリ
| 更新日 | ファイル名 | アセンブリ ver. | ファイル ver. |
|---|---|---|---|
| 2021年7月28日 | GrapeCity.Win.JPAddress.dll GrapeCity.Win.JPAddress.Design.dll GrapeCity.Win.JPAddress.NetCore.dll |
2.0.4002.2012 | 2.0.4005.2012 |
| 2020年2月25日 | GrapeCity.Win.JPAddress.dll GrapeCity.Win.JPAddress.Design.dll GrapeCity.Win.JPAddress.NetCore.dll |
2.0.4001.2012 | 2.0.4004.2012 |
| 2019年7月25日 | GrapeCity.Win.JPAddress.dll GrapeCity.Win.JPAddress.Design.dll |
2.0.4001.2012 | 2.0.4004.2012 |
| 2019年4月17日 | GrapeCity.Win.JPAddress.dll GrapeCity.Win.JPAddress.Design.dll |
2.0.4000.2012 | 2.0.4003.2012 |
| 2018年6月27日 | GrapeCity.Win.JPAddress.dll GrapeCity.Win.JPAddress.Design.dll |
2.0.4000.2012 | 2.0.4002.2012 |
| 2017年12月14日 | GrapeCity.Win.JPAddress.dll GrapeCity.Win.JPAddress.Design.dll |
2.0.4000.2012 | 2.0.4001.2012 |
| 2017年7月26日 | GrapeCity.Win.JPAddress.dll GrapeCity.Win.JPAddress.Design.dll |
2.0.4000.2012 | 2.0.4000.2012 |
Web（ASP.NET）アセンブリ
| 更新日 | ファイル名 | アセンブリ ver. | ファイル ver. |
|---|---|---|---|
| 2024年4月24日 | GrapeCity.Web.JPAddress.dll |
2.0.4006.2012 | 2.0.4006.2012 |
| 2022年5月18日 | GrapeCity.Web.JPAddress.dll |
2.0.4005.2012 | 2.0.4005.2012 |
| 2021年7月28日 | GrapeCity.Web.JPAddress.dll |
2.0.4002.2012 | 2.0.4004.2012 |
| 2019年7月25日 | GrapeCity.Web.JPAddress.dll |
2.0.4001.2012 | 2.0.4003.2012 |
| 2019年4月17日 | GrapeCity.Web.JPAddress.dll |
2.0.4000.2012 | 2.0.4002.2012 |
| 2018年6月27日 | GrapeCity.Web.JPAddress.dll |
2.0.4000.2012 | 2.0.4001.2012 |
| 2017年7月26日 | GrapeCity.Web.JPAddress.dll |
2.0.4000.2012 | 2.0.4000.2012 |
WPFアセンブリ
| 更新日 | ファイル名 | アセンブリ ver. | ファイル ver. |
|---|---|---|---|
| 2021年7月28日 | GrapeCity.Windows.JPAddress.dll GrapeCity.Windows.JPAddress.VisualStudio.Design.11.0.dll GrapeCity.Windows.JPAddress.VisualStudio.Design.15.0.dll |
2.0.4003.2012 | 2.0.4004.2012 |
| 2020年10月16日 | GrapeCity.Windows.JPAddress.dll GrapeCity.Windows.JPAddress.VisualStudio.Design.11.0.dll GrapeCity.Windows.JPAddress.VisualStudio.Design.15.0.dll |
2.0.4002.2012 | 2.0.4003.2012 |
| 2020年2月25日 | GrapeCity.Windows.JPAddress.dll GrapeCity.Windows.JPAddress.VisualStudio.Design.11.0.dll GrapeCity.Windows.JPAddress.VisualStudio.Design.15.0.dll |
2.0.4001.2012 | 2.0.4002.2012 |
| 2019年7月25日 | GrapeCity.Windows.JPAddress.dll GrapeCity.Windows.JPAddress.VisualStudio.Design.11.0.dll GrapeCity.Windows.JPAddress.VisualStudio.Design.15.0.dll |
2.0.4001.2012 | 2.0.4002.2012 |
| 2019年4月17日 | GrapeCity.Windows.JPAddress.dll GrapeCity.Windows.JPAddress.VisualStudio.Design.11.0.dll GrapeCity.Windows.JPAddress.VisualStudio.Design.15.0.dll |
2.0.4000.2012 | 2.0.4001.2012 |
| 2018年2月7日 | GrapeCity.Windows.JPAddress.dll GrapeCity.Windows.JPAddress.VisualStudio.Design.11.0.dll GrapeCity.Windows.JPAddress.VisualStudio.Design.15.0.dll |
2.0.4000.2012 | 2.0.4000.2012 |
 |
通常は、アセンブリのバージョンを意識する必要はありませんが、作成したアプリケーションが配布先の環境で動作しない場合や、意図的にアセンブリを入れ替える場合は、プロジェクトが参照しているアセンブリのバージョンを確認してください。 |