IRONSOFTWAREHOME

FileNotFoundException for IronXL.XmlSerializers on .NET 10

Curtis Chau
Curtis Chau
Updated: August 21, 2026

Calling WorkBook.SaveAs() in a .NET 10 project can surface a FileNotFoundException for IronXL.XmlSerializers in Visual Studio. In most cases this is a first-chance exception caught by the debugger, not a real runtime failure, and the Excel file is still generated.

FileNotFoundException: IronXL.XmlSerializers
Text

The message comes from .NET XML serialization, which probes for an optional serializer assembly that is not present. IronXL handles that internally, but with Just My Code disabled the debugger breaks immediately on an exception the library already catches, making a harmless first-chance event look like a crash.

Solution

1. Reproduce with a minimal workflow

Create a new ASP.NET Core Web Application targeting .NET 10 and install IronXL.Excel 2026.6.1.

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

Then run a basic save: create a workbook, write Hello, World into cell A1, and save the file as .xlsx to your output path.

2. Enable Just My Code

When an exception appears in Visual Studio, check the Just My Code setting under the debugger options. Enable it so the debugger stops breaking on exceptions that the library handles internally.

3. Confirm the file was generated

Check whether the .xlsx file exists at your output path. If it does, you are looking at a first-chance exception break in the debugger, not an actual runtime failure.

Notes

  • A first-chance FileNotFoundException related to .NET XML serialization can appear even when file generation succeeds.
  • There is no standalone IronXL.XmlSerializers NuGet package. Do not attempt to add one to resolve the message.
Curtis Chau
Technical Writer

Curtis Chau holds a Bachelor’s degree in Computer Science (Carleton University) and specializes in front-end development with expertise in Node.js, TypeScript, JavaScript, and React. Passionate about crafting intuitive and aesthetically pleasing user interfaces, Curtis enjoys working with modern frameworks and creating well-structured, visually appealing manuals.

...
Read More

Ready to Get Started?

Nuget Downloads 2,237,574Version:2026.9just released

Get your free 30-day Trial Key instantly.
No credit card or account creation required
C# NuGet Library for PDF
Install with NuGet

Version: 2026.9

PM > Install-Package IronXL.Excel
nuget.org/packages/IronXL.Excel/
  1. In Solution Explorer, right-click References, Manage NuGet Packages
  2. Select Browse and search "IronXL"
  3. Select the package and install
C# PDF DLL
Download DLL

Version: 2026.9

  1. Download and unzip IronXL to a location such as ~/Libs within your Solution directory
  2. In Visual Studio Solution Explorer, right click References. Select Browse, "IronXL.dll"

Licenses from $999

Key in blue circle

Get your free 30-day Trial Key instantly.

Your trial license will be sent to your email address

No limitations. 100% unlocked. No credit card.

bullet_checkedNo credit card or account creation requiredNo limitations. 100% unlocked. No credit card.
  • Logo Aetna
  • Logo NASA
  • Logo GE
  • Logo Porsche
  • Logo USDA
  • Logo Qatar
Join Millions of Engineers who’ve tried IronPDF
Book your free Live Demo
Booking Badge

Trusted by Millions of Engineers Worldwide

Iron Software's customer logos
Get Your No-Obligation Consult
Complete the form below or email sales@ironsoftware.com
Your details will always be kept confidential.
Trusted by Millions of Engineers Worldwide
Iron Software's customer logos
Get your free 30-day Trial Key instantly.
No credit card or account creation required