1. IronPDF
  2. 故障排除
  3. 在 .NET Framework 中版本升級後的組件不匹配

.NET Framework版本升級後的程式集不匹配

Curtis Chau
Curtis Chau
已更新:
This article was translated from English: Does it need improvement?
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
  立即與工程團隊聊天
技術作家

Curtis Chau擁有Carleton大學的電腦科學學士學位，專精於前端開發，擁有Node.js、TypeScript、JavaScript和React的專業知識。Curtis熱衷於建立直觀且美觀的使用者介面，喜愛使用現代框架並建立結構良好、視覺吸引力的手冊。

除了開發，Curtis對物聯網（IoT）有濃厚的興趣，探索創新的方法來整合硬體和軟體。在空閒時間，他喜歡玩遊戲和建立Discord機器人，結合他對技術的熱愛與創造力。

準備開始了嗎？
Nuget 下載 20,088,359 | 版本： 2026.7 剛剛發布
Still Scrolling Icon

還在捲動嗎？

想快速獲得證明嗎？ PM > Install-Package IronPdf
執行範例 看您的HTML變成PDF。