Incompatibilité d'assemblage après mise à niveau de la version dans .NET Framework

Curtis Chau

Updated: 10 juin 2026

Download IronPDF

• NuGet Download
• DLL Download
• Windows Installer

• ---

• Start Free Trial

Copy for LLMs

• Copy for LLMs

  Copy page as Markdown for LLMs
  # Incompatibilité d'assemblage après mise à niveau de la version dans .NET Framework Après avoir mis à niveau IronPDF dans un projet .NET Framework, l'application déclenche cette exception à l'exécution : ```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) ``` La mise à niveau du package NuGet installe de nouvelles versions d'assemblage, mais les anciennes versions restent en cache dans `bin/Debug` (ou `bin/Release`) et les répertoires de sortie `runtimes` du projet. .NET Framework résout les assemblages depuis ces dossiers locaux avant de consulter le cache NuGet, donc les DLL en cache obsolètes entrent en conflit avec le package nouvellement installé et causent l'échec du lien. ## Solution **Étape 1 :** Désinstallez IronPDF et tous les packages liés à Iron (tels que `IronPdf.Slim`, `IronPdf.Native.Chrome.Windows`) en utilisant le Gestionnaire de Packages NuGet dans Visual Studio (Outils > Gestionnaire de Packages NuGet > Gérer les Packages NuGet pour la Solution). **Étape 2 :** Supprimez le dossier `runtimes` et le dossier `bin/Debug` (ou `bin/Release`) de votre répertoire de sortie du projet. **Étape 3 :** Réinstallez IronPDF via le Gestionnaire de Packages NuGet. Si le nettoyage de Visual Studio est insuffisant, videz le cache global NuGet via la ligne de commande et forcez une restauration propre : ```bash dotnet nuget locals all --clear dotnet restore --force ``` **Pour les déploiements sur serveur :** retirez toutes les anciennes DLL IronPDF du répertoire serveur avant de republier. Déployez dans un nouveau répertoire et mettez à jour IIS pour pointer vers le nouvel emplacement plutôt que de remplacer les fichiers en place. Voir aussi : [référence de l'exception d'incompatibilité de version d'assemblage IronPDF](https://ironpdf.com/troubleshooting/ironpdf-assembly-version-mismatch-exception/) et [échec du déploiement du package NuGet](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

Après avoir mis à niveau IronPDF dans un projet .NET Framework, l'application déclenche cette exception à l'exécution :

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)

La mise à niveau du package NuGet installe de nouvelles versions d'assemblage, mais les anciennes versions restent en cache dans bin/Debug (ou bin/Release) et les répertoires de sortie runtimes du projet. .NET Framework résout les assemblages depuis ces dossiers locaux avant de consulter le cache NuGet, donc les DLL en cache obsolètes entrent en conflit avec le package nouvellement installé et causent l'échec du lien.

Solution

Étape 1 : Désinstallez IronPDF et tous les packages liés à Iron (tels que IronPdf.Slim, IronPdf.Native.Chrome.Windows) en utilisant le Gestionnaire de Packages NuGet dans Visual Studio (Outils > Gestionnaire de Packages NuGet > Gérer les Packages NuGet pour la Solution).

Étape 2 : Supprimez le dossier runtimes et le dossier bin/Debug (ou bin/Release) de votre répertoire de sortie du projet.

Étape 3 : Réinstallez IronPDF via le Gestionnaire de Packages NuGet.

Si le nettoyage de Visual Studio est insuffisant, videz le cache global NuGet via la ligne de commande et forcez une restauration propre :

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

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

Pour les déploiements sur serveur : retirez toutes les anciennes DLL IronPDF du répertoire serveur avant de republier. Déployez dans un nouveau répertoire et mettez à jour IIS pour pointer vers le nouvel emplacement plutôt que de remplacer les fichiers en place.

Voir aussi : référence de l'exception d'incompatibilité de version d'assemblage IronPDF et échec du déploiement du package NuGet.

Curtis Chau

Discutez maintenant avec l'équipe d'ingénierie

Rédacteur technique

Curtis Chau détient un baccalauréat en informatique (Université de Carleton) et se spécialise dans le développement front-end avec expertise en Node.js, TypeScript, JavaScript et React. Passionné par la création d'interfaces utilisateur intuitives et esthétiquement plaisantes, Curtis aime travailler avec des frameworks modernes et créer des manuels bien structurés et visuellement attrayants.

...

Lire la suite