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

Mis à jour:9 juin 2026

Translated

View the article in English

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)

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

SHELL

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 ...

Prêt à commencer ?

Nuget Téléchargements 20,088,359 | Version : 2026.7 vient de sortir