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

Curtis Chau

Updated: 10 de junio de 2026

Download IronPDF

• NuGet Download
• DLL Download
• Windows Installer

• ---

• Start Free Trial

Copy for LLMs

• Copy for LLMs

  Copy page as Markdown for LLMs
  # Desajuste de ensamblado después de la actualización de versión en .NET Framework Después de actualizar IronPDF en un proyecto de .NET Framework, la aplicación lanza esta excepción en tiempo de ejecución: ```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 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: ```bash dotnet nuget locals all --clear dotnet restore --force ``` **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](https://ironpdf.com/troubleshooting/ironpdf-assembly-version-mismatch-exception/) y [fallo en el despliegue del paquete 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

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)

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

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 estructurados y visualmente atractivos.

...

Leer más