EPPlus Export List<T> to Excel

C# Excel EPPlus Export List<T> to Excel

A small code snippet to quickly export a List<T> as an Excel file using EPPlus.

This demo uses version the latest version that does not require a license (version From version 5 and upwards you will need a license for commercial usage.
The snippet takes a Generic List and converts it to a Byte Array. The header row is automatically created with a background color.

If the Object in the List contains a List<T> itself, then that columns is removed from the Excel since EPPlus cannot handle Nested Lists.

View source on GitHub

Code Snippets

using System;
using OfficeOpenXml;
using OfficeOpenXml.Style;
using System.Collections.Generic;
using System.Drawing;
using System.Globalization;
using System.Linq;

public static byte[] createExcel<T>(IEnumerable<T> list, string author, string title)
    using (ExcelPackage package = new ExcelPackage())
        //create the excel file and set some properties
        package.Workbook.Properties.Author = author;
        package.Workbook.Properties.Title = title;
        package.Workbook.Properties.Created = DateTime.Now;

        //create a new sheet
        package.Workbook.Worksheets.Add("Sheet 1");
        ExcelWorksheet ws = package.Workbook.Worksheets[1];
        ws.Cells.Style.Font.Size = 11;
        ws.Cells.Style.Font.Name = "Calibri";

        //put the data in the sheet, starting from column A, row 1
        ws.Cells["A1"].LoadFromCollection(list, true);

        //set some styling on the header row
        var header = ws.Cells[1, 1, 1, ws.Dimension.End.Column];
        header.Style.Font.Bold = true;
        header.Style.Fill.PatternType = ExcelFillStyle.Solid;

        //loop the header row to capitalize the values
        for (int col = 1; col <= ws.Dimension.End.Column; col++)
            var cell = ws.Cells[1, col];
            cell.Value = cell.Value.ToString().ToUpper();

        //loop the properties in list<t> to apply some data formatting based on data type and check for nested lists
        var listObject = list.First();
        var columns_to_delete = new List<int>();
        for (int i = 0; i < listObject.GetType().GetProperties().Count(); i++)
            var prop = listObject.GetType().GetProperties()[i];
            var range = ws.Cells[2, i + 1, ws.Dimension.End.Row, i + 1];

            //check if the property is a List, if yes add it to columns_to_delete
            if (prop.PropertyType.IsGenericType && prop.PropertyType.GetGenericTypeDefinition() == typeof(List<>))
                columns_to_delete.Add(i + 1);

            //set the date format
            if (prop.PropertyType == typeof(DateTime) || prop.PropertyType == typeof(DateTime?))
                range.Style.Numberformat.Format = DateTimeFormatInfo.CurrentInfo.ShortDatePattern;

            //set the decimal format
            if (prop.PropertyType == typeof(decimal) || prop.PropertyType == typeof(decimal?))
                range.Style.Numberformat.Format = "0.00";

        //remove all lists from the sheet, starting with the last column
        foreach (var item in columns_to_delete.OrderByDescending(x => x))

        //auto fit the column width

        //sometimes the column width is slightly too small (maybe because of font type).
        //So add some extra width just to be sure
        for (int col = 1; col <= ws.Dimension.End.Column; col++)
            ws.Column(col).Width += 3;

        //send the excel back as byte array
        return package.GetAsByteArray();