IronXL.Excel 2022.8.8357

The ID prefix of this package has been reserved for one of the owners of this package by NuGet.org. Prefix Reserved
There is a newer version of this package available.
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
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="IronXL.Excel" Version="2022.8.8357" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add IronXL.Excel --version 2022.8.8357
#r "nuget: IronXL.Excel, 2022.8.8357"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// 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

Nuget Installs Passed windows macOS linux docker aws microsoftazure livechat

IronXL - The C# Excel Library

IronXL NuGet Trial Banner Image

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

IronXL Cross Platform Compatibility Support Image

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

IronXL 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

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 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. 
.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. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
  • .NETStandard 2.0

    • No dependencies.

NuGet packages (2)

Showing the top 2 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

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
2024.4.4 3,068 4/4/2024
2024.3.20 5,995 3/11/2024
2024.2.25 11,198 1/29/2024
2024.1.21 10,439 12/29/2023
2023.12.19 9,272 12/1/2023
2023.11.12 10,994 10/27/2023
2023.10.8 7,704 10/6/2023
2023.9.29 10,492 8/31/2023
2023.8.19 16,415 7/31/2023
2023.7.4 21,627 7/6/2023
2023.6.4 24,004 5/29/2023
2023.5.4 23,942 5/1/2023
2023.4.13 35,599 3/29/2023
2023.2.5 25,633 2/27/2023
2023.1.14 15,852 1/31/2023
2022.12.11262 20,241 12/29/2022
2022.12.10926 19,834 12/8/2022
2022.11.10251 53,233 11/2/2022
2022.9.9454 27,125 9/29/2022
2022.8.8357 7,883 8/23/2022
2022.7.7362 36,764 7/13/2022
2022.6.6825 16,355 6/23/2022
2022.3.0 88,502 3/10/2022
2021.12.0 34,611 12/21/2021
2021.11.0 12,750 10/29/2021
2021.9.0 29,465 8/24/2021
2020.12.2 93,339 12/8/2020
2020.9.1 16,831 9/21/2020
2020.9.0 5,830 9/3/2020
2020.6.0 21,090 6/2/2020
2020.5.0 4,374 5/1/2020
2019.5.2 29,162 9/10/2019
2019.5.0 3,912 7/22/2019
2019.3.2.1 4,674 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).