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,237,574Versã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.
Biblioteca NuGet C# para PDF
Instalar com NuGet

Versão: 2026.9

PM > Install-Package IronXL.Excel
nuget.org/packages/IronXL.Excel/
  1. No Solution Explorer, clique com o botão direito do mouse em Referências e selecione Gerenciar Pacotes NuGet.
  2. Selecione Procurar e pesquise "IronXL".
  3. Selecione o pacote e instale.
DLL de PDF em C#
Baixar DLL

Versão: 2026.9

  1. Baixe e descompacte o IronXL em um local como ~/Libs dentro do diretório da sua solução.
  2. No Solution Explorer do Visual Studio, clique com o botão direito do mouse em Referências. Selecione Procurar e digite "IronXL.dll".

Licenças a partir de US$ 749

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.

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