IronXL.Excel
2022.8.8357
Prefix Reserved
See the version list below for details.
dotnet add package IronXL.Excel --version 2022.8.8357
NuGet\Install-Package IronXL.Excel -Version 2022.8.8357
<PackageReference Include="IronXL.Excel" Version="2022.8.8357" />
paket add IronXL.Excel --version 2022.8.8357
#r "nuget: IronXL.Excel, 2022.8.8357"
// Install IronXL.Excel as a Cake Addin #addin nuget:?package=IronXL.Excel&version=2022.8.8357 // Install IronXL.Excel as a Cake Tool #tool nuget:?package=IronXL.Excel&version=2022.8.8357
IronXL - The C# Excel Library
Get Started | Features | Code Examples | Licensing | Free Trial
IronXL is a library developed and maintained by Iron Software that helps C# Software Engineers to read, generate and edit Excel (and other Spreadsheet files) in .NET applications & websites.
IronXL is a fast and natural approach to work with Excel and Other Spreadsheet files in C# within .NET. With no utilization of Office Excel Interopm IronXL works well with .NET Framework, .NET Core and Azure. All without extra dependencies or the need to install MS Office.
IronXL excels at:
- Import Data from XLS/XLSX/CSV/TSV.
- Export Work Sheets to XLS/XLSX/CSV/TSV/JSON.
- Encrypt and decrypt XLSX/XLSM/XLTX files with passwords.
- Work with Spreadsheets as System.Data.DataSet and System.Data.DataTable objects.
- Excel Formulas recalculated every time a sheet it edited.
- Intuitive Ranges setting with a WorkSheet["A1:B10"] syntax.
- Sort Ranges, Columns and Rows.
- Style Cells - Font, Size, Background pattern, Border, Alignment and Number formats.
Document Formats
- Load, Read and Edit Data: XLS, XLSX, XLST, XLSM, CSV and TSV
- Saving and Exporting: XLS, XLSX, XLST, XLSM, CSV, TSV and JSON
- System.Data Objects: Work with Excel Spreadsheets as System.Data.DataSet and System.Data.DataTable
Sheet Functions
- Formulas: Works with Excel formulas and formulas recalculated every time a sheet it edited
- Cell Data Formats: Text, Number, Formulas, Dates, Currency, Percentage, Scientific, Time and Custom Formats
- Sorting: Ranges, Columns and Rows
- Cell Styling: Font, Size, Background pattern, Border and Alignment
IronXL has cross platform support compatibility with:
- .NET 6 and .NET 5, .NET Core, Standard, and Framework
- Windows, macOS, Linux, Docker, Azure, and AWS
Additionally, our API reference and full licensing information can easily be found on our website.
Using IronXL
Installing the IronXL NuGet package is quick and easy, please install the package like this:
PM> Install-Package IronXL.Excel
Once installed, you can get started by adding using IronXL
to the top of your C# code. Here is an example to get started:
using IronXL;
using System.Linq;
//Supported spreadsheet formats for reading include: XLSX, XLS, CSV and TSV
WorkBook workbook = WorkBook.Load("test.xlsx");
WorkSheet sheet = workbook.WorkSheets.First();
//Select cells easily in Excel notation and return the calculated value
int cellValue = sheet["A2"].IntValue;
// Read from Ranges of cells elegantly.
foreach (var cell in sheet["A2:A10"])
{
Console.WriteLine("Cell {0} has value '{1}'", cell.AddressString, cell.Text);
}
//Calculate aggregate values such as Min, Max and Sum
decimal sum = sheet["A2:A10"].Sum();
//Linq compatible
decimal max = sheet["A2:A10"].Max(c => c.DecimalValue);
Features Table
Licensing & Support available
For code examples, tutorials and documentation visit https://ironsoftware.com/csharp/excel/
For support please email us at developers@ironsoftware.com
Documentation Links
- Code Examples : (https://ironsoftware.com/csharp/excel/examples/
- API Reference : https://ironsoftware.com/csharp/excel/object-reference/api/
- Tutorials : https://ironsoftware.com/csharp/excel/tutorials/how-to-read-excel-file-csharp/
- Licensing : https://ironsoftware.com/csharp/excel/licensing/
- Live Chat Support : https://ironsoftware.com/csharp/excel/#helpscout-support
You can email us at developers@ironsoftware.com for support directly from our code team. We offer licensing and extensive support for commercial deployment projects.
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net5.0 was computed. net5.0-windows was computed. net6.0 was computed. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 was computed. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. net9.0 was computed. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. |
.NET Core | netcoreapp2.0 was computed. netcoreapp2.1 was computed. netcoreapp2.2 was computed. netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
.NET Standard | netstandard2.0 is compatible. netstandard2.1 was computed. |
.NET Framework | net461 was computed. net462 was computed. net463 was computed. net47 was computed. net471 was computed. net472 was computed. net48 was computed. net481 was computed. |
MonoAndroid | monoandroid was computed. |
MonoMac | monomac was computed. |
MonoTouch | monotouch was computed. |
Tizen | tizen40 was computed. tizen60 was computed. |
Xamarin.iOS | xamarinios was computed. |
Xamarin.Mac | xamarinmac was computed. |
Xamarin.TVOS | xamarintvos was computed. |
Xamarin.WatchOS | xamarinwatchos was computed. |
-
.NETStandard 2.0
- No dependencies.
NuGet packages (3)
Showing the top 3 NuGet packages that depend on IronXL.Excel:
Package | Downloads |
---|---|
Usabit.Framework.Data
Framework to manage database connections and develop repositories pattern. |
|
MepApps.Svr.Internal
Mep Apps Inc. Cloud Internals |
|
DYMO.LabelAPI.Mac
Package Description |
GitHub repositories
This package is not used by any popular GitHub repositories.
Version | Downloads | Last updated |
---|---|---|
2025.2.5 | 1,980 | 2/3/2025 |
2025.1.1 | 6,135 | 1/3/2025 |
2024.12.1 | 11,320 | 12/3/2024 |
2024.11.16 | 7,789 | 11/11/2024 |
2024.10.2 | 20,386 | 10/3/2024 |
2024.9.3 | 9,662 | 9/9/2024 |
2024.8.5 | 31,809 | 7/30/2024 |
2024.7.1 | 13,310 | 7/5/2024 |
2024.6.1 | 15,522 | 6/4/2024 |
2024.5.5 | 20,155 | 5/2/2024 |
2024.4.4 | 24,905 | 4/4/2024 |
2024.3.20 | 14,874 | 3/11/2024 |
2024.2.25 | 29,765 | 1/29/2024 |
2024.1.21 | 22,156 | 12/29/2023 |
2023.12.19 | 12,926 | 12/1/2023 |
2023.11.12 | 19,644 | 10/27/2023 |
2023.10.8 | 14,610 | 10/6/2023 |
2023.9.29 | 15,774 | 8/31/2023 |
2023.8.19 | 22,577 | 7/31/2023 |
2023.7.4 | 31,582 | 7/6/2023 |
2023.6.4 | 34,977 | 5/29/2023 |
2023.5.4 | 34,159 | 5/1/2023 |
2023.4.13 | 55,795 | 3/29/2023 |
2023.2.5 | 30,079 | 2/27/2023 |
2023.1.14 | 21,514 | 1/31/2023 |
2022.12.11262 | 34,789 | 12/29/2022 |
2022.12.10926 | 20,565 | 12/8/2022 |
2022.11.10251 | 73,581 | 11/2/2022 |
2022.9.9454 | 32,422 | 9/29/2022 |
2022.8.8357 | 8,984 | 8/23/2022 |
2022.7.7362 | 43,409 | 7/13/2022 |
2022.6.6825 | 17,298 | 6/23/2022 |
2022.3.0 | 104,263 | 3/10/2022 |
2021.12.0 | 42,167 | 12/21/2021 |
2021.11.0 | 14,101 | 10/29/2021 |
2021.9.0 | 33,986 | 8/24/2021 |
2020.12.2 | 104,567 | 12/8/2020 |
2020.9.1 | 19,583 | 9/21/2020 |
2020.9.0 | 6,037 | 9/3/2020 |
2020.6.0 | 24,530 | 6/2/2020 |
2020.5.0 | 5,333 | 5/1/2020 |
2019.5.2 | 31,368 | 9/10/2019 |
2019.5.0 | 4,267 | 7/22/2019 |
2019.3.2.1 | 7,716 | 5/21/2019 |
* Adds a feature of encrypting and decrypting ".xlsx", ".xlsm" and ".xltx" files with a password. Use WorkBook.SaveAs(string fileName, string password) method to encrypt the WorkBook with provided password when saving it. Use WorkBook.Load(string filename, string password) method to decrypt file with provided password when loading the workbook. Password can also be specified with following:
- using WorkBook.Password property (workbook will be encrypted on save if this property is not null, and will not be encrypted if it is null)
- using SavingOptions object with SavingOptions.Password property, when calling WorkBook.SaveAs(string fileName, SavingOptions options) method
- using LoadingOptions object with LoadingOptions.Password property, when calling WorkBook.Load(string filename, LoadingOptions options) method
To check if the WorkBook object will be encrypted on save use WorkBook.IsEncrypted boolean property. Encryption can also be turned off by assigning WorkBook.IsEncrypted = false (Note: workbook cannot be encrypted by assigning WorkBook.IsEncrypted = true, this will throw an exception at runtime, asking to instead specify a password).
Setting passwords to a workbook of a type other than ".xlsx", ".xlsm" and ".xltx" will also throw an exception at runtime alerting user that the workbook could not be encrypted
* Adds support for .Net 6.0
* Removes dependency on System.Common.Drawing
* Removes support for .Net Framework 4.5. Minimum supported .Net Framework version is now 4.6.2
* Breaking change: WorkBook.SaveAs(string filename, string listDelimiter) method was renamed to WorkBook.SaveAsWithCustomDelimiter(string filename, string listDelimiter) to remove ambiguity between SaveAs(string filename, string listDelimiter) and SaveAs(string fileName, string password) methods
* Breaking change: IronXL.Drawing.Images.IImage.ToBitmap() method is removed, as System.Common.Drawing is no longer supported.
* Breaking change: IronXL.Drawing.Images.IImage.ToImage() method now returns a SixLabors.ImageSharp.Image object used as a replacement for removed System.Common.Drawing objects.
* Fixes a bug where a background color set to a cell or a range in XLSX workbook didn't render in Excel.
* Fixes a bug where Thai language locale throwed license exception
* Fixes a bug where each time a new cell was assigned a DateTime value in XLSX workbook a new cell style was created for each cell, overflowing the style table and breaking the resulting file if the number of cells was > 64000.
* Improves speed of creating large amounts of cells with a DateTime value and format. For example, creating a workbook with 80K DateTime value and format cells on a single worksheet used to take 25 seconds, and now takes less then 0.8 seconds (actual performance will depend on the environment the code is executed in).