.NET Frameworkでのバージョンアップグレード後のアセンブリの不一致

更新日:2026年6月9日

Translated

View the article in English

.NET FrameworkプロジェクトでIronPDFをアップグレードした後、アプリケーションは実行時にこの例外を投げます。

System.IO.FileLoadException: Could not load file or assembly 'IronPdf, Version=X.Y.Z.W,
Culture=neutral, PublicKeyToken=...' or one of its dependencies. The located assembly's
manifest definition does not match the assembly reference.
(Exception from HRESULT: 0x80131040)

NuGetパッケージのアップグレードにより新しいアセンブリバージョンがインストールされますが、古いバージョンはプロジェクトのruntimes出力ディレクトリにキャッシュとして残ります。 .NET FrameworkはNuGetキャッシュを参照する前に、これらのローカルフォルダからアセンブリを解決するため、古いキャッシュされたDLLが新しくインストールされたパッケージと衝突し、バインディングエラーを引き起こします。

解決策

ステップ 1: Visual StudioのNuGetパッケージマネージャーを使用して（ツール > NuGetパッケージマネージャー > ソリューションのNuGetパッケージを管理）、IronPDFおよびすべてのIron関連パッケージ（IronPdf.Native.Chrome.Windowsなど）をアンインストールします。

ステップ 2: プロジェクト出力ディレクトリからbin/Release）フォルダを削除します。

ステップ 3: NuGetパッケージマネージャーを通じてIronPDFを再インストールします。

Visual Studioのクリーンアップが不十分な場合、コマンドラインを通じてグローバルNuGetキャッシュをクリアし、クリーンな復元を強制します。

dotnet nuget locals all --clear
dotnet restore --force

dotnet nuget locals all --clear
dotnet restore --force

SHELL

サーバー展開の場合: 再公開する前にサーバーのディレクトリからすべての古いIronPDF DLLを削除します。新しいディレクトリにデプロイし、IISを上書きファイルではなく、新しい場所を指すように更新します。

また参照: IronPDFアセンブリバージョン不一致例外リファレンスおよびNuGetパッケージのデプロイ失敗.

Curtis Chau

今すぐエンジニアリングチームとチャット

テクニカルライター

Curtis Chauは、カールトン大学でコンピュータサイエンスの学士号を取得し、Node.js、TypeScript、JavaScript、およびReactに精通したフロントエンド開発を専門としています。直感的で美しいユーザーインターフェースを作成することに情熱を持ち、Curtisは現代のフレームワークを用いた開発や、構造の良い視覚的に魅力的なマニュアルの作成を楽しんでいます。

開発以外にも、CurtisはIoT（Internet of Things）への強い関心を持ち、ハードウェアとソフトウェアの統合方法を模索しています。余暇には、ゲームをしたりDiscordボットを作成したりして、技術に対する愛情と創造性を組み合わせています。

準備はできましたか？

Nuget ダウンロード 20,088,359 | バージョン: 2026.7 リリースされたばかり