Zusammenstellungsfehlanpassung nach Versions-Upgrade im .NET Framework

Curtis Chau

Updated: 10. Juni 2026

Download IronPDF

• NuGet Download
• DLL Download
• Windows Installer

• ---

• Start Free Trial

Copy for LLMs

• Copy for LLMs

  Copy page as Markdown for LLMs
  # Zusammenstellungsfehlanpassung nach Versions-Upgrade im .NET Framework Nach dem Upgrade von IronPDF in einem .NET Framework-Projekt wirft die Anwendung zur Laufzeit diese Ausnahme: ```txt 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) ``` Das Upgrade des NuGet-Pakets installiert neue Zusammenstellungsversionen, jedoch bleiben die alten Versionen im Projektcache in den Verzeichnissen `bin/Debug` (oder `bin/Release`) und `runtimes` erhalten. .NET Framework löst Zusammenstellungen aus diesen lokalen Ordnern, bevor es den NuGet-Cache konsultiert. Daher stehen die veralteten gecachten DLLs im Konflikt mit dem neu installierten Paket und verursachen das Bindungsproblem. ## Lösung **Schritt 1:** Deinstallieren Sie IronPDF und alle Iron-bezogenen Pakete (wie z.B. `IronPdf.Slim`, `IronPdf.Native.Chrome.Windows`) über den NuGet-Paket-Manager in Visual Studio (Extras > NuGet-Paket-Manager > NuGet-Pakete für die Lösung verwalten). **Schritt 2:** Löschen Sie den Ordner `runtimes` und den Ordner `bin/Debug` (oder `bin/Release`) aus dem Ausgabeordner Ihres Projekts. **Schritt 3:** Installieren Sie IronPDF erneut über den NuGet-Paket-Manager. Wenn die Bereinigung in Visual Studio unzureichend ist, leeren Sie den globalen NuGet-Cache über die Befehlszeile und erzwingen Sie eine saubere Wiederherstellung: ```bash dotnet nuget locals all --clear dotnet restore --force ``` **Für Serverbereitstellungen:** Entfernen Sie alle alten IronPDF-DLLs aus dem Serververzeichnis, bevor Sie erneut veröffentlichen. Veröffentlichen Sie in ein frisches Verzeichnis und aktualisieren Sie IIS, um auf den neuen Speicherort zu verweisen, anstatt Dateien am selben Ort zu überschreiben. Siehe auch: [IronPDF Zusammenstellungsfehlanpassung Ausnahme Referenz](https://ironpdf.com/troubleshooting/ironpdf-assembly-version-mismatch-exception/) und [fehlgeschlagene NuGet-Paketbereitstellung](https://ironpdf.com/troubleshooting/failed-to-deploy-nuget-package/).

• ---

• Open in ChatGPT

  Ask ChatGPT about this page
• Open in Gemini

  Ask Gemini about this page
• Open in Grok

  Ask Grok about this page
• Open in Perplexity

  Ask Perplexity about this page

Share

• Share on Facebook
• Share on X (Twitter)
• Share on LinkedIn

• ---

• Email article

Nach dem Upgrade von IronPDF in einem .NET Framework-Projekt wirft die Anwendung zur Laufzeit diese Ausnahme:

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)

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)

Das Upgrade des NuGet-Pakets installiert neue Zusammenstellungsversionen, jedoch bleiben die alten Versionen im Projektcache in den Verzeichnissen bin/Debug (oder bin/Release) und runtimes erhalten. .NET Framework löst Zusammenstellungen aus diesen lokalen Ordnern, bevor es den NuGet-Cache konsultiert. Daher stehen die veralteten gecachten DLLs im Konflikt mit dem neu installierten Paket und verursachen das Bindungsproblem.

Lösung

Schritt 1: Deinstallieren Sie IronPDF und alle Iron-bezogenen Pakete (wie z.B. IronPdf.Slim, IronPdf.Native.Chrome.Windows) über den NuGet-Paket-Manager in Visual Studio (Extras > NuGet-Paket-Manager > NuGet-Pakete für die Lösung verwalten).

Schritt 2: Löschen Sie den Ordner runtimes und den Ordner bin/Debug (oder bin/Release) aus dem Ausgabeordner Ihres Projekts.

Schritt 3: Installieren Sie IronPDF erneut über den NuGet-Paket-Manager.

Wenn die Bereinigung in Visual Studio unzureichend ist, leeren Sie den globalen NuGet-Cache über die Befehlszeile und erzwingen Sie eine saubere Wiederherstellung:

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

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

Für Serverbereitstellungen: Entfernen Sie alle alten IronPDF-DLLs aus dem Serververzeichnis, bevor Sie erneut veröffentlichen. Veröffentlichen Sie in ein frisches Verzeichnis und aktualisieren Sie IIS, um auf den neuen Speicherort zu verweisen, anstatt Dateien am selben Ort zu überschreiben.

Siehe auch: IronPDF Zusammenstellungsfehlanpassung Ausnahme Referenz und fehlgeschlagene NuGet-Paketbereitstellung.

Curtis Chau

Jetzt mit dem Ingenieurteam chatten

Technischer Autor

Curtis Chau hat einen Bachelor-Abschluss in Informatik von der Carleton University und ist spezialisiert auf Frontend-Entwicklung mit Expertise in Node.js, TypeScript, JavaScript und React. Leidenschaftlich widmet er sich der Erstellung intuitiver und ästhetisch ansprechender Benutzerschnittstellen und arbeitet gerne mit modernen Frameworks sowie der Erstellung gut strukturierter, optisch ansprechender Handbücher.

...

Weiterlesen