NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
NuGet
NuGet, #734 most downloaded on NuGet
ExcelDataReader extension for reading Microsoft Excel files into System.Data.DataSet.
Latest stable
3.9.0
Last release 26 days ago
27 Oct 2026
Release timing varies
gaps range from 9 days to 10 months
Nearly every release is documented
notes for 12 of 12 stable releases
Nothing withdrawn
no release was ever pulled
9 years old
28 releases · first in 2017
Drag across the ruler to compare, or tap a release to open it.
Support XML Spreadsheet 2003 files by @appel1 in #763, with comment handling fixes by @Shaisolaris in #769.
ResetWorksheet() to restart the current worksheet by @appel1 in #782.DBNull.Value; GetFieldType() returns typeof(DBNull), and typed getters throw InvalidCastException for empty cells. Nullable annotations have also been updated by @appel1 in #758.IDataReader.Depth now returns 0 instead of the current row index, matching the ADO.NET contract by @appel1 in #756.DateTime instead of DateTimeOffset by @appel1 in #755.AutodetectSeparators now accepts string[] instead of char[] by @appel1 in #774.SinglePassMode rejects out-of-order rows and revisits to completed rows by @appel1 in #771.ExcelReaderException; unsupported Extensible Encryption throws NotSupportedException by @appel1 in #781.ExcelDataReader.Log API.See the migration guide for details.
Full changelog: https://github.com/ExcelDataReader/ExcelDataReader/compare/v3.9.0...v4.0.0-beta1
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Add support for reading XLM (Macro Sheet) files by @hughbe in https://github.com/ExcelDataReader/ExcelDataReader/pull/724
Full Changelog: https://github.com/ExcelDataReader/ExcelDataReader/compare/v3.8.0...v3.9.0
Add opt-in EscapeChar support for backslash-escaped CSV quoted fields by @appel1 in https://github.com/ExcelDataReader/ExcelDataReader/pull/743
Full Changelog: https://github.com/ExcelDataReader/ExcelDataReader/compare/v3.9.0-develop00574...v3.9.0-rc1
Remove bad performance optimization experiment by @appel1 in https://github.com/ExcelDataReader/ExcelDataReader/pull/742
Full Changelog: https://github.com/ExcelDataReader/ExcelDataReader/compare/v3.9.0-develop00565...v3.9.0-develop00574
Fix build and tests on mac by @hughbe in https://github.com/ExcelDataReader/ExcelDataReader/pull/723
Full Changelog: https://github.com/ExcelDataReader/ExcelDataReader/compare/v3.8.0...v3.9.0-develop00565
Issue #642: Active Tab/Sheet Support by @john-blackline in https://github.com/ExcelDataReader/ExcelDataReader/pull/685
Full Changelog: https://github.com/ExcelDataReader/ExcelDataReader/compare/v3.7.0...v3.8.0
Fix: HorizontalAlignment.Centered breaking change by @appel1 in https://github.com/ExcelDataReader/ExcelDataReader/commit/d5d66407a7466beb9f1bd0510a38…
Full Changelog: https://github.com/ExcelDataReader/ExcelDataReader/compare/v3.8.0-develop00488...v3.8.0-develop00498
Issue 694: Fix timespan parsing for invalid iso values by @yfa-vagelis in https://github.com/ExcelDataReader/ExcelDataReader/pull/705
Full Changelog: https://github.com/ExcelDataReader/ExcelDataReader/compare/v3.8.0-develop00474...v3.8.0-develop00488
Highlights in ExcelDataReader v3.8.0-develop00474 since 3.7.0:
Highlights in ExcelDataReader v3.8.0-develop00474 since 3.7.0:
Handle the partial-byte-reads-in-stream breaking change in .NET6 by @PanosKousidis in https://github.com/ExcelDataReader/ExcelDataReader/pull/645
1 and true values when parsing the date1904 attribute by @eJJonatah in https://github.com/ExcelDataReader/ExcelDataReader/pull/650Full Changelog: https://github.com/ExcelDataReader/ExcelDataReader/compare/v3.6.0...v3.7.0
Highlights in ExcelDataReader 3.7.0-develop00415 since ExcelDataReader 3.7.0-develop00411:
Highlights in ExcelDataReader 3.7.0-develop00415 since ExcelDataReader 3.7.0-develop00411:
Highlights in ExcelDataReader 3.7.0-develop00411 since ExcelDataReader 3.7.0-develop00385:
Highlights in ExcelDataReader 3.7.0-develop00411 since ExcelDataReader 3.7.0-develop00385:
Highlights in ExcelDataReader 3.7.0-develop00385 since ExcelDataReader 3.7.0-develop00365:
Highlights in ExcelDataReader 3.7.0-develop00385 since ExcelDataReader 3.7.0-develop00365:
Highlights in ExcelDataReader 3.7.0-develop00371 since ExcelDataReader 3.7.0-develop00365:
Highlights in ExcelDataReader 3.7.0-develop00371 since ExcelDataReader 3.7.0-develop00365:
Highlights in ExcelDataReader 3.7.0-develop00365 since ExcelDataReader 3.7.0-develop00310:
Highlights in ExcelDataReader 3.7.0-develop00365 since ExcelDataReader 3.7.0-develop00310:
Highlights in ExcelDataReader 3.7.0-develop00310 since ExcelDataReader 3.7.0-develop00306:
Highlights in ExcelDataReader 3.7.0-develop00310 since ExcelDataReader 3.7.0-develop00306:
GetCellError() method returns error enum for a cellHighlights in ExcelDataReader 3.7.0-develop00306 since 3.6.0:
Highlights in ExcelDataReader 3.7.0-develop00306 since 3.6.0:
GetCellStyle method returns indent, horizontal alignment, hidden, locked for a cellHighlights in ExcelDataReader 3.6.0 since 3.5.0:
Highlights in ExcelDataReader 3.6.0 since 3.5.0:
AnalyzeInitialCsvRows configuration option can speed up reading large CSV filesHighlights in ExcelDataReader 3.5.0 since 3.4.2:
Highlights in ExcelDataReader 3.5.0 since 3.4.2:
GetNumberFormatIndex() method returns the index of the built-in or custom number format in a cellGetColumnWidth() method returns the width of a column, or 0 if collapsed or hiddenFilterSheet callback for AsDataSetLeaveOpen option leaves the stream open after the IExcelDataReader object is disposedHighlights in ExcelDataReader 3.4.2 since 3.4.1:
Highlights in ExcelDataReader 3.4.2 since 3.4.1:
Highlights in ExcelDataReader 3.4.1 since 3.4.0:
Highlights in ExcelDataReader 3.4.1 since 3.4.0:
Highlights in ExcelDataReader 3.4.0 since 3.3.0:
Highlights in ExcelDataReader 3.4.0 since 3.3.0:
MergeCells property returns merged cell ranges in the current sheetRowCount property returns number of rows in the current sheetFilterColumn callback option for AsDataSet()…formatting tokens [hh], [mm], or [ss]. This is a breaking change for users who attempted to work around the broken DateTime-based durations before
Highlights in ExcelDataReader 3.3.0 since 3.2.0:
TimeSpan values. GetValue() returns values of type TimeSpan when the number format contains duration formatting tokens [hh], [mm], or [ss]. This is a breaking change for users who attempted to work around the broken DateTime-based durations beforeIExcelDataReader.GetNumberFormatString() method returns the number format string for a valueReset() and AsDataSet() methods to compensate for slowness introduced by an XLSX compatibility fix in 3.2.0Highlights in ExcelDataReader 3.2.0 since 3.1.0:
Highlights in ExcelDataReader 3.2.0 since 3.1.0:
RowHeight property returns the height of the current rowRowFilter configuration callback option for AsDataSet()Highlights in ExcelDataReader 3.1.0 since 3.0.0:
Highlights in ExcelDataReader 3.1.0 since 3.0.0:
HeaderFooter property contains information about headers and footersCodeName property contains the current sheet's VBA code nameBreaking changes in ExcelDataReader 3.0.0 since 3.0.0-develop00086:
Breaking changes in ExcelDataReader 3.0.0 since 3.0.0-develop00086:
IDataReader.Get* reader methods no longer attempt to convert to the requested type. Throws InvalidCastException if the field value is not of the expected typeHighlights in ExcelDataReader 3.0.0-develop00086 since 3.0.0-develop00019:
Highlights in ExcelDataReader 3.0.0-develop00086 since 3.0.0-develop00019:
This is a major release with some breaking changes.
This is a major release with some breaking changes.
Highlights in ExcelDataReader 3.0.0-develop00019 since 2.1.2.3:
See #139 for the main PR.
One column per quarter.