SaveAs() FileNotFoundException on .NET 10

This article was translated from English: Does it need improvement?
Translated
View the article in English

Chamar WorkBook.SaveAs() em um projeto .NET 10 pode fazer o Visual Studio exibir um FileNotFoundException para IronXL.XmlSerializers. Na maioria dos casos, essa é uma exceção detectada pelo depurador, não uma falha real de tempo de execução, e o arquivo Excel ainda é escrito. Use as etapas abaixo para confirmar qual delas você está vendo e para impedir que o depurador interrompa ao encontrá-la.

System.IO.FileNotFoundException: Could not load file or assembly 'IronXL.XmlSerializers'

A mensagem vem da tentativa de serialização XML do .NET de localizar um assembly de serializador opcional que não existe. O tempo de execução lida com o erro internamente e continua, então o workbook ainda é salvo. Com o Meu Código Apenas desativado, o depurador interrompe no momento em que essa exceção interna é levantada, fazendo um evento tratado parecer um crash.

Solução

1. Reproduza com um fluxo de trabalho mínimo

Crie um novo aplicativo Web ASP.NET Core direcionado ao .NET 10 e instale IronXL.Excel versão 2026.6.1.

<PackageReference Include="IronXL.Excel" Version="2026.6.1" />
<PackageReference Include="IronXL.Excel" Version="2026.6.1" />
XML

Escreva um único valor e salve-o para confirmar o comportamento.

using IronXL;

WorkBook workbook = WorkBook.Create();
WorkSheet sheet = workbook.DefaultWorkSheet;
sheet["A1"].Value = "Hello, World";
workbook.SaveAs("output.xlsx");
using IronXL;

WorkBook workbook = WorkBook.Create();
WorkSheet sheet = workbook.DefaultWorkSheet;
sheet["A1"].Value = "Hello, World";
workbook.SaveAs("output.xlsx");
Imports IronXL

Dim workbook As WorkBook = WorkBook.Create()
Dim sheet As WorkSheet = workbook.DefaultWorkSheet
sheet("A1").Value = "Hello, World"
workbook.SaveAs("output.xlsx")
$vbLabelText   $csharpLabel

2. Ative o Meu Código Apenas

Abra as opções do depurador do Visual Studio e ative Meu Código Apenas. Quando está desativado, o depurador interrompe nas exceções que a biblioteca lida internamente; ativá-lo permite que essas exceções tratadas passem sem interromper sua sessão.

3. Confirme que o arquivo foi gerado

Verifique se output.xlsx foi escrito no seu caminho de saída. Um arquivo bem-sucedido indica que a interrupção foi uma exceção de primeira instância, não uma falha de execução.

ObserveUma FileNotFoundException de primeira instância ligada à serialização XML do .NET pode aparecer mesmo quando a geração do arquivo é bem-sucedida.

Dicas de Depuração

Não há um pacote NuGet IronXL.XmlSerializers independente. Não tente adicionar um para limpar a mensagem; isso não resolverá nada e o assembly não é destinado a ser instalado separadamente.

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

Leia mais
Pronto para começar?
Nuget Downloads 2,174,917 | Versão: 2026.7 recém-lançado
Still Scrolling Icon

Ainda está rolando a tela?

Quer provas rápidas? PM > Install-Package IronXL.Excel
executar um exemplo Veja seus dados se transformarem em uma planilha.