SaveAs() FileNotFoundException on .NET 10

Curtis Chau
Curtis Chau
Updated: 3 de julho de 2026

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'
Text

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" />
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");

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.

Observe: Uma 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 é 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

Pronto para começar?

Nuget Downloads 2,362,812Versão:2026.11recém-lançado