Back in 2017 I created a blog series on EPPlus Create Excels with C# and EPPlus: A tutorial because it used to be such a great project. But then it went commercial 😀
So time to create a new blog series, now using the MIT licensed OpenXML!
ClosedXML/ClosedXML ClosedXML is a .NET library for reading, manipulating and writing Excel 2007+ (.xlsx, .xlsm) files. It aims to provide an intuitive and user-friendly interface to dealing with the underlying OpenXML API. (⭐ 5.2k)
The blog series and this code repository is pretty much a 1 to 1 convertion from EPPlus to ClosedXML.
dotnet add package ClosedXML| EPPlus | ClosedXML |
|---|---|
| Basics | |
| new ExcelPackage() | new XLWorkbook() |
| Workbook.Worksheets.Add("str") | AddWorksheet("str") |
| With Sheet | |
| Cells[1, 1] | Cell(1, 1) |
| Cell["A2"] | Cell("A2") |
| Formula | FormulaA1 |
| Text | GetString() |
| Styling with Cell.Style | |
| Font.Color.SetColor(Color.Ivory) | Style.Font.SetFontColor(XLColor.Ivory) |
| Style.Font.FontColor = XLColor.Ivory | |
| Fill.PatternType = ExcelFillStyle.Solid | Fill.SetPatternType(XLFillPatternValues.Solid) |
| Fill.BackgroundColor.SetColor(Color.Navy) | Fill.SetBackgroundColor(XLColor.Navy) |
| Misc | |
| LoadFromCollection | InsertTable |
| Cells.AutoFitColumns() | Columns().AdjustToContents() |
ClosedXML.Report: Fill a template Excel by using placeholders.
WebApi:
ClosedXML has separate projects for this which provide an extension method. There is also one for ASP.NET and MVC.
Adding a picture:
using var wb = new XLWorkbook();
var ws = wb.AddWorksheet("Sheet1");
var imagePath = @"c:\path\to\your\image.jpg";
var image = ws.AddPicture(imagePath)
.MoveTo(ws.Cell("B3"))
.Scale(0.5); // optional: resize picture
wb.SaveAs("file.xlsx");