The C# Excel Library

Read Excel Files without Interop See All 37 Code Examples

using IronXL;
using System;
using System.Linq;

// Supported for XLSX, XLS, XLSM, XLTX, CSV and TSV
WorkBook workBook = WorkBook.Load("sample.xlsx");

// Select worksheet at index 0
WorkSheet workSheet = workBook.WorkSheets[0];

// Get any existing worksheet
WorkSheet firstSheet = workBook.DefaultWorkSheet;

// Select a cell and return the converted value
int cellValue = workSheet["A2"].IntValue;

// Read from ranges of cells elegantly.
foreach (var cell in workSheet["A2:A10"])
{
    Console.WriteLine("Cell {0} has value '{1}'", cell.AddressString, cell.Text);
}

// Calculate aggregate values such as Min, Max and Sum
decimal sum = workSheet["A2:A10"].Sum();

// Linq compatible
decimal max = workSheet["A2:A10"].Max(c => c.DecimalValue);

Install-Package IronXL.Excel

Excel Worksheets See All 37 Code Examples

using IronXL;

// Create new Excel spreadsheet
WorkBook workBook = WorkBook.Create(ExcelFileFormat.XLSX);

// Create worksheets (workSheet1, workSheet2, workSheet3)
WorkSheet workSheet1 = workBook.CreateWorkSheet("workSheet1");
WorkSheet workSheet2 = workBook.CreateWorkSheet("workSheet2");
WorkSheet workSheet3 = workBook.CreateWorkSheet("workSheet3");

// Set worksheet position (workSheet2, workSheet1, workSheet3)
workBook.SetSheetPosition("workSheet2", 0);

// Set active for workSheet3
workBook.SetActiveTab(2);

// Remove workSheet1
workBook.RemoveWorkSheet(1);

workBook.SaveAs("manageWorkSheet.xlsx");

Install-Package IronXL.Excel

Create Excel Files See All 37 Code Examples

using IronXL;

// Create new Excel WorkBook document
WorkBook workBook = WorkBook.Create();

// Convert XLSX to XLS
WorkBook xlsWorkBook = WorkBook.Create(ExcelFileFormat.XLS);

// Create a blank WorkSheet
WorkSheet workSheet = workBook.CreateWorkSheet("new_sheet");

// Add data and styles to the new worksheet
workSheet["A1"].Value = "Hello World";
workSheet["A1"].Style.WrapText = true;
workSheet["A2"].BoolValue = true;
workSheet["A2"].Style.BottomBorder.Type = IronXL.Styles.BorderType.Double;

// Save the excel file as XLS, XLSX, CSV, TSV, JSON, XML, HTML and streams
workBook.SaveAs("sample.xlsx");

Install-Package IronXL.Excel

Convert Spreadsheet File Types See All 37 Code Examples

using IronXL;
using System.IO;


// Import any XLSX, XLS, XLSM, XLTX, CSV and TSV
WorkBook workBook = WorkBook.Load("sample.xlsx");

// Export the excel file as XLS, XLSX, XLSM, CSV, TSV, JSON, XML
workBook.SaveAs("sample.xls");
workBook.SaveAs("sample.xlsx");
workBook.SaveAs("sample.tsv");
workBook.SaveAsCsv("sample.csv");
workBook.SaveAsJson("sample.json");
workBook.SaveAsXml("sample.xml");

// Export the excel file as Html, Html string
workBook.ExportToHtml("sample.html");
string htmlString = workBook.ExportToHtmlString();

// Export the excel file as Binary, Byte array, Data set, Stream
byte[] binary = workBook.ToBinary();
byte[] byteArray = workBook.ToByteArray();
System.Data.DataSet dataSet = workBook.ToDataSet(); // Allow easy integration with DataGrids, SQL and EF
Stream stream = workBook.ToStream();

Install-Package IronXL.Excel

Excel to SQL via System.Data.DataSet See All 37 Code Examples

using IronXL;
using System;
using System.Data;

// Supported for XLSX, XLS, XLSM, XLTX, CSV and TSV
WorkBook workBook = WorkBook.Load("sample.xlsx");

// Convert the whole Excel WorkBook to a DataSet
DataSet dataSet = workBook.ToDataSet();

foreach (DataTable table in dataSet.Tables)
{
    Console.WriteLine(table.TableName);

    // Enumerate by rows or columns first at your preference
    foreach (DataRow row in table.Rows)
    {
        for (int i = 0; i < table.Columns.Count; i++)
        {
            Console.Write(row[i]);
        }
    }
}

Install-Package IronXL.Excel

Excel to SQL and DataGrid via DataTable See All 37 Code Examples

using IronXL;
using System;
using System.Data;

// Supported for XLSX, XLS, XLSM, XLTX, CSV and TSV
WorkBook workBook = WorkBook.Load("sample.xlsx");

// Select default sheet
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Convert the worksheet to DataTable
DataTable dataTable = workSheet.ToDataTable(true);

// Enumerate by rows or columns first at your preference
foreach (DataRow row in dataTable.Rows)
{
    for (int i = 0; i < dataTable.Columns.Count; i++)
    {
        Console.Write(row[i]);
    }
}

Install-Package IronXL.Excel

Excel Conditional Formatting See All 37 Code Examples

using IronXL;
using IronXL.Styles;
using IronXL.Formatting.Enums;

WorkBook workBook = WorkBook.Load("sample.xlsx");
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Create conditional formatting rule
var rule = workSheet.ConditionalFormatting.CreateConditionalFormattingRule(ComparisonOperator.LessThan, "8");
// Set style options
rule.FontFormatting.IsBold = true;
rule.FontFormatting.FontColor = "#123456";
rule.BorderFormatting.RightBorderColor = "#ffffff";
rule.BorderFormatting.RightBorderType = BorderType.Thick;
rule.PatternFormatting.BackgroundColor = "#54bdd9";
rule.PatternFormatting.FillPattern = FillPattern.Diamonds;
// Apply formatting on specified region
workSheet.ConditionalFormatting.AddConditionalFormatting("A3:A8", rule);

// Create conditional formatting rule
var rule1 = workSheet.ConditionalFormatting.CreateConditionalFormattingRule(ComparisonOperator.Between, "7", "10");
// Set style options
rule1.FontFormatting.IsItalic = true;
rule1.FontFormatting.UnderlineType = FontUnderlineType.Single;
// Apply formatting on specified region
workSheet.ConditionalFormatting.AddConditionalFormatting("A3:A9", rule1);

workBook.SaveAs("applyConditionalFormatting.xlsx");

Install-Package IronXL.Excel

Protect Excel Files See All 37 Code Examples

using IronXL;

WorkBook workBook = WorkBook.Load("sample.xlsx");
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Open protected spreadsheet file
WorkBook protectedWorkBook = WorkBook.Load("sample.xlsx", "IronSoftware");

// Spreadsheet protection
// Set protection for spreadsheet file
workBook.Encrypt("IronSoftware");

// Remove protection for spreadsheet file. Original password is required.
workBook.Password = null;

// Worksheet protection
// Set protection for individual worksheet
workSheet.ProtectSheet("IronXL");

// Remove protection for particular worksheet. It works without password!
workSheet.UnprotectSheet();

workBook.Save();

Install-Package IronXL.Excel

Excel Formulas in C# See All 37 Code Examples

using IronXL;
using System.Linq;

WorkBook workBook = WorkBook.Load("sample.xlsx");
WorkSheet workSheet = workBook.DefaultWorkSheet;

// Set Formulas
workSheet["A1"].Formula = "Sum(B8:C12)";
workSheet["B8"].Formula = "=C9/C11";
workSheet["G30"].Formula = "Max(C3:C7)";

// Force recalculate all formula values in all sheets.
workBook.EvaluateAll();

// Get the formula's calculated value.  e.g. "52"
var formulaValue = workSheet["G30"].First().FormattedCellValue;

// Get the formula as a string. e.g. "Max(C3:C7)"
string formulaString = workSheet["G30"].Formula;

// Save changes with updated formulas and calculated values.
workBook.Save();

Install-Package IronXL.Excel

Edit Excel Metadata in C# See All 37 Code Examples

using IronXL;
using System;

WorkBook workBook = WorkBook.Load("sample.xlsx");

// Set author
workBook.Metadata.Author = "Your Name";
// Set comments
workBook.Metadata.Comments = "Monthly report";
// Set title
workBook.Metadata.Title = "July";
// Set keywords
workBook.Metadata.Keywords = "Report";

// Read the creation date of the excel file
DateTime? creationDate = workBook.Metadata.Created;

// Read the last printed date of the excel file
DateTime? printDate = workBook.Metadata.LastPrinted;

workBook.SaveAs("editedMetadata.xlsx");

Install-Package IronXL.Excel

Explore the code, install IronXL with NuGet

Cross Platform Support

Designed for C#, F#, & VB.NET running on .NET 7, 6, 5, Core, Standard, or Framework

IronXL Release Version 2023.2

Features & Upgrades

See what’s new

The C# Excel Library

A C# Excel Library that prioritizes accuracy, ease of use, and speed. Licenses from $749.

IronXL is the leading C# Excel library for generating and editing Excel documents in .NET. Its user friendly API allows developers to add Excel functionality to .NET projects in minutes.

The Excel API you need, without the Office Interop hassle.

IronXL Release Version 2023.2

Features & Upgrades

See what’s new

Compatibility

.NET Languages:

C#
VB.NET
F#

Platforms:

.NET 7, 6 & 5
.NET Core 2x & 3x
.NET Standard 2
.NET Framework 4.6.2+

App Types:

Console, Web, & Desktop

OS:

Microsoft Windows
macOS
Linux (Debian, CentOS, Ubuntu)
Docker (Windows, Linux, Azure)
Azure (VPS, Webapps, Websites, Functions)
AWS (EC2, Lambda)

IDEs:

Microsoft Visual Studio
Jetbrains ReSharper & Rider

Workbooks

Create or Load Spreadsheets:

XLS
XLSX, XLTX, XLSM
CSV
TSV

Save or Export Formats:

XLS
XLSX, XLST, XLSM
CSV
TSV
JSON
HTML
Binary
Byte Array

System.Data Objects:

Import and export as DataSet or DataTable

Edit Workbooks:

Password Encryption
Create and Remove Worksheets
Set Sheet Position
Set Active Tab

Worksheets

Edit Formulas:

Works with Excel formulas
Recalculation on sheet edit

Sort Data:

Range
Column
Row

Create and Edit Charts:

Area, Bar, Column, Lines, Pie, Scatter

Edit Layout:

Freeze Panes
Autosize Rows/Columns
Add and Remove Rows/Columns

Edit Worksheets:

Protect with Password
Group and Ungroup
Add, Remove, and Extract Images

Cell Ranges

Cell Range Functions:

Sort
Trim
Clear
Copy
Set Hyperlinks
Merge and Unmerge Cells

Style Cells:

Font and Size
Border and Alignment
Background Pattern
Conditional Formatting

Maths Functions:

Average and Sum
Min and Max

Set Cell Data Formats:

Text, Number, Formula, Date, Currency, Scientific, Time, Boolean, Custom Formats

Trusted by Over 2 Million Engineers Worldwide

World-Class Engineering,
24-Hour Support

Talk to an Expert

Ready to get started? Version: 2023.2 just released

View Licenses >