IRONSOFTWAREHOME

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");
C#

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

Pronto para começar?

Nuget Downloads 2,263,141Versão:2026.9recém-lançado

Obtenha sua chave de avaliação gratuita de 30 dias instantaneamente.
Não é necessário cartão de crédito nem criação de conta.
Key in blue circle

Obtenha sua chave de avaliação gratuita de 30 dias instantaneamente.

Your trial license will be sent to your email address

Sem limitações. 100% desbloqueado. Sem cartão de crédito.

OR
bullet_checkedNão é necessário cartão de crédito nem criação de conta.Sem limitações. 100% desbloqueado. Sem cartão de crédito.
  • Logo Aetna
  • Logo NASA
  • Logo GE
  • Logo Porsche
  • Logo USDA
  • Logo Qatar
Join Millions of Engineers who’ve tried Iron Suite
Agende sua demonstração ao vivo gratuita.
Booking Badge

Aprovado por milhões de engenheiros em todo o mundo.

Logotipos dos clientes da Iron Software
Agende sua consulta sem compromisso.
Preencha o formulário abaixo ou envie um e-mail para sales@ironsoftware.com
Os seus dados serão sempre mantidos em sigilo.
Aprovado por milhões de engenheiros em todo o mundo.
Logotipos dos clientes da Iron Software
Obtenha sua chave de avaliação gratuita de 30 dias instantaneamente.
Não é necessário cartão de crédito nem criação de conta.