Desajuste de ensamblado después de la actualización de versión en .NET Framework

Actualizado:9 de junio de 2026

Translated

View the article in English

Después de actualizar IronPDF en un proyecto de .NET Framework, la aplicación lanza esta excepción en tiempo de ejecución:

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 actualización del paquete NuGet instala nuevas versiones de ensamblado, pero las versiones antiguas permanecen en caché en el bin/Debug (o bin/Release) del proyecto y en los directorios de salida runtimes. .NET Framework resuelve los ensamblados desde estas carpetas locales antes de consultar la caché de NuGet, por lo que las DLLs en caché obsoletas entran en conflicto con el paquete recién instalado y causan el fallo de vinculación.

Solución

Paso 1: Desinstale IronPDF y todos los paquetes relacionados con Iron (como IronPdf.Slim, IronPdf.Native.Chrome.Windows) usando el Administrador de Paquetes NuGet en Visual Studio (Herramientas > Administrador de Paquetes NuGet > Administrar Paquetes NuGet para la Solución).

Paso 2: Elimine la carpeta runtimes y la carpeta bin/Debug (o bin/Release) del directorio de salida de su proyecto.

Paso 3: Reinstale IronPDF a través del Administrador de Paquetes NuGet.

Si la limpieza de Visual Studio es insuficiente, limpie la caché global de NuGet a través de la línea de comandos y fuerce una restauración limpia:

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

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

SHELL

Para despliegues en servidor: remueva todas las DLLs antiguas de IronPDF del directorio del servidor antes de republicar. Despliegue en un directorio nuevo y actualice IIS para que apunte a la nueva ubicación en lugar de sobrescribir archivos en el lugar.

Ver también: referencia de excepción de desajuste de versión de ensamblado de IronPDF y fallo en el despliegue del paquete NuGet.

Curtis Chau

Chatea con el equipo de ingeniería ahora

Escritor Técnico

Curtis Chau tiene una licenciatura en Ciencias de la Computación (Carleton University) y se especializa en el desarrollo front-end con experiencia en Node.js, TypeScript, JavaScript y React. Apasionado por crear interfaces de usuario intuitivas y estéticamente agradables, disfruta trabajando con frameworks modernos y creando manuales bien ...

¿Listo para empezar?

Nuget Descargas 20,088,359 | Versión: 2026.7 recién publicada