Erro de Compatibilidade de Assembly Após Atualização de Versão no .NET Framework

Curtis Chau

Updated: 10 de junho 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
  # Erro de Compatibilidade de Assembly Após Atualização de Versão no .NET Framework Após atualizar o IronPDF em um projeto do .NET Framework, a aplicação lança esta exceção em tempo de execução: ```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) ``` A atualização do pacote NuGet instala novas versões de assembly, mas as versões antigas permanecem em cache no `bin/Debug` do projeto (ou `bin/Release`) e nos diretórios de saída `runtimes`. .NET Framework resolve assemblies a partir dessas pastas locais antes de consultar o cache do NuGet, portanto, os DLLs em cache e obsoletos conflitam com o pacote recentemente instalado e causam a falha de vinculação. ## Solução **Passo 1:** Desinstale o IronPDF e todos os pacotes relacionados ao Iron (como `IronPdf.Slim`, `IronPdf.Native.Chrome.Windows`) usando o Gerenciador de Pacotes NuGet no Visual Studio (Ferramentas > Gerenciador de Pacotes NuGet > Gerenciar Pacotes NuGet para Solução). **Passo 2:** Exclua a pasta `runtimes` e a pasta `bin/Debug` (ou `bin/Release`) do diretório de saída do seu projeto. **Passo 3:** Reinstale o IronPDF via Gerenciador de Pacotes NuGet. Se a limpeza do Visual Studio for insuficiente, limpe o cache global do NuGet via linha de comando e force uma restauração limpa: ```bash dotnet nuget locals all --clear dotnet restore --force ``` **Para implantações em servidor:** remova todos os DLLs antigos do IronPDF do diretório do servidor antes de republicar. Implante em um novo diretório e atualize o IIS para apontar para o novo local em vez de sobrescrever arquivos no lugar. Veja também: [referência de erro de compatibilidade de versão de assembly do IronPDF](https://ironpdf.com/troubleshooting/ironpdf-assembly-version-mismatch-exception/) e [falha na implantação do pacote 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

Após atualizar o IronPDF em um projeto do .NET Framework, a aplicação lança esta exceção em tempo de execução:

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)

A atualização do pacote NuGet instala novas versões de assembly, mas as versões antigas permanecem em cache no bin/Debug do projeto (ou bin/Release) e nos diretórios de saída runtimes. .NET Framework resolve assemblies a partir dessas pastas locais antes de consultar o cache do NuGet, portanto, os DLLs em cache e obsoletos conflitam com o pacote recentemente instalado e causam a falha de vinculação.

Solução

Passo 1: Desinstale o IronPDF e todos os pacotes relacionados ao Iron (como IronPdf.Slim, IronPdf.Native.Chrome.Windows) usando o Gerenciador de Pacotes NuGet no Visual Studio (Ferramentas > Gerenciador de Pacotes NuGet > Gerenciar Pacotes NuGet para Solução).

Passo 2: Exclua a pasta runtimes e a pasta bin/Debug (ou bin/Release) do diretório de saída do seu projeto.

Passo 3: Reinstale o IronPDF via Gerenciador de Pacotes NuGet.

Se a limpeza do Visual Studio for insuficiente, limpe o cache global do NuGet via linha de comando e force uma restauração limpa:

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

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

Para implantações em servidor: remova todos os DLLs antigos do IronPDF do diretório do servidor antes de republicar. Implante em um novo diretório e atualize o IIS para apontar para o novo local em vez de sobrescrever arquivos no lugar.

Veja também: referência de erro de compatibilidade de versão de assembly do IronPDF e falha na implantação do pacote NuGet.

Curtis Chau

Converse agora mesmo com a equipe de engenharia.

Redator Técnico

Curtis Chau é bacharel em Ciência da Computação (Universidade Carleton) e se especializa em desenvolvimento front-end, com experiência em Node.js, TypeScript, JavaScript e React. Apaixonado por criar interfaces de usuário intuitivas e esteticamente agradáveis, Curtis gosta de trabalhar com frameworks modernos e criar manuais bem estruturados e visualmente atraentes.

...

Leia mais