EPPlus Wiki Rss Feed

New Comment on "Roadmap"

ChrisGrundy — Wed, 27 Mar 2013 22:51:24 GMT

I am also very interested in knowing an approximate time frame for 3.2. I tried to port EPPlus to iPad (Via Xamarin) and I run into problems due to the System.IO.Packaging dependencies. Bu I am almost certain that once you replace that with DotNetZip (Which I have already ported to iOS), EEPlus would be right at home in monoTouch.

New Comment on "Roadmap"

baclay — Wed, 13 Mar 2013 20:53:54 GMT

Do you have an ETA on when 3.2 would be available? I desperately need the Calc engine to recalc the worksheet.

Updated Wiki: test

JanKallman — Thu, 14 Feb 2013 19:43:14 GMT

Updated Wiki: test

JanKallman — Thu, 14 Feb 2013 19:35:54 GMT

Updated Wiki: test

JanKallman — Thu, 14 Feb 2013 19:35:26 GMT

Updated Wiki: Home

JanKallman — Thu, 14 Feb 2013 19:33:10 GMT

Create advanced Excel 2007/2010 spreadsheets on the server

EPPlus is a .net library that reads and writes Excel 2007/2010 files using the Open Office Xml format (xlsx).

EPPlus supports:

Cell Ranges
Cell styling (Border, Color, Fill, Font, Number, Alignments)
Charts
Pictures
Shapes
Comments
Tables
Protection
Encryption
Pivot tables
Data validation
Conditional formatting
VBA
Many more...

Overview

This project started with the source from ExcelPackage. It was a great project to start from.

It had the basic functionality needed to read and write a spreadsheet.

Advantages over other:

Totally rewritten using dictionaries
Can now load 50 000 cells in seconds
Complete integration with .NET

Examples

To see how this works let’s do a short walkthrough of sample 6 that creates a report on a directory in the file system.
The spreadsheet is created without any template.
First sheet is a list of subdirectories and files, with an icon, name, size, and dates. The second sheet contains some statistics...

EPPlus also supports enumeration of cells....

EPPlus and Linq

Heres an example how you can use EPPlus in a webapplication...

Web Applications

Here's a few screenshots from the sample project...

Screenshots

License

The project is licensed under the GNU Library General Public License (LGPL).

Updated Wiki: Home

JanKallman — Thu, 14 Feb 2013 19:32:53 GMT

Create advanced Excel 2007/2010 spreadsheets on the server

EPPlus is a .net library that reads and writes Excel 2007/2010 files using the Open Office Xml format (xlsx).

EPPlus supports:

Cell Ranges
Cell styling (Border, Color, Fill, Font, Number, Alignments)
Charts
Pictures
Shapes
Comments
Tables
Protection
Encryption
Pivot tables
Data validation
Conditional formatting
VBA
Many more...

Overview

This project started with the source from ExcelPackage. It was a great project to start from.

It had the basic functionality needed to read and write a spreadsheet.

Advantages over other:

Totally rewritten using dictionaries
Can now load 50 000 cells in seconds
Complete integration with .NET

Examples

EPPlus also supports enumeration of cells....

EPPlus and Linq

Heres an example how you can use EPPlus in a webapplication...

Web Applications

Here's a few screenshots from the sample project...

Screenshots

Donations

License

The project is licensed under the GNU Library General Public License (LGPL).

Updated Wiki: FAQ

JanKallman — Thu, 14 Feb 2013 19:29:54 GMT

FAQ

Translations

Versão em Português FAQ (PT-BR)

What are the requirements for this library?

.Net Framwork 3.5 or higher. This library utilize the System.IO.Packaging namespace.

What features are supported in version 3.1.2

Cell access using ranges (values, formulas, Formula R1C1 format...)
Cell styling (Numberformat, Font, Fill, Border, Alignments and more)
Merging cells
Names ranges
In-cell Richtext
Comments
Pictures
Shapes
Charts (Except Bubble-, Radar-, Stock- and Surface charts)
Hyperlinks
Workbook properties
Header & Footers
Printer settings (like margins, orientation, papersize, printarea, titels)
Freeze panes
Grouping and ungrouping
Encryption (AES128, 192 & 256).
Workbook protection
Worksheet protection
Tables (build in styles)
Enumeration of the cells collection. This makes it possible to use Linq-queries.
Array formulas
Pivot tables
Data validation
Conditional formatting
VBA

What is NOT supported by the library (these are the most obvious features)?

Drawing objects
- Lines, smart art
- Charts Bubble-, Radar-, Stock- and Surface charts.
- Embedded Objects
handling of External links (you can reference an external workbook using formulas)
Themes
Chart & Macro worksheets
Form & ActiveX controls

How do I install this library
Unzip the package and copy the EPPlus.dll to a directory of your choice, then simply add a reference to it in your project.

How do I get started?
Download the sample project and step through the different samples in the console application. The samples show most things you can use the library for. There is also a simple web sample that shows different ways to send your generated workbooks to the client.
The sample project is created in Visual Studio 2010.

How do I address a range?
This works pretty much as it works in Excel. Here are a few samples...

worksheet.Cells["A1"].Value = 1;	//Set the value of cell A1 to 1
worksheet.Cells[1,1].Value = 1;	//Set the value of cell A1 to 1

worksheet.Cells["A1:B3"].Style.NumberFormat.Format = "#,##0"; //Sets the numberformat for a range
worksheet.Cells[1,1,3,2].Style.NumberFormat.Format = "#,##0"; //Same as above,A1:B3

worksheet.Cells["A1:B3,D1:E57"].Style.NumberFormat.Format = "#,##0"; //Sets the numberformat for a range containing two addresses.
worksheet.Cells["A:B"].Style.Font.Bold = true; //Sets font-bold to true for column A & B
worksheet.Cells["1:1,A:A,C3"].Style.Font.Bold = true; //Sets font-bold to true for row 1,column A and cell C3
worksheet.Cells["A:XFD"].Style.Font.Name = "Arial"; //Sets font to Arial for all cells in a worksheet.

//Sets the background color for the selected range (default is A1). 
//A range is selected using the by using the worksheet.Select method
worksheet.Cells.Style.Fill.PatternType = ExcelFillStyle.Solid;
worksheet.Cells.Style.Fill.BackgroundColor.SetColor(Color.LightGreen);

My number formats does not work
If you add numeric data as strings (like the original Excelpackage do), Excel will treat the data as a string and it will not be formated. Do not use the ToString method when setting numeric values.

string s="1000"
int i=1000;
worksheet.Cells["A1"].Value=s; //Will not be formated
worksheet.Cells["A2"].Value=i; //Will be formated
worksheet.Cells["A1:A2"].Style.NumberFormat.Format="#,##0";

I get an error that Excel has found unreadable content when I open my generated document?
Check your Formulas and Numberformats. Formulas and numberformats are not validated by the library so if you enter anything wrong the package will be corrupt. Use the English formula names. Formula parameters are separated by commas (,), string parameters use double quotes (").

worksheet.Cells["A1"].Formula="CONCATENATE(\"string1_\",\"test\")";

Numberformats:
Use culture independent number formats: dot (.) for decimal, comma (thousand).
The easiest way to check a format or a formula is to create an Excel file --> Do the formatting / Add the formulas --> Save it as XLSX ---> Rename the file *.zip. Extract the file and have a look at the number formats in the \xl\styles.xml file and formulas in \xl\worksheets\sheet#.xml.

I don't know what number format code to use
Do the same procedure as above and look at the formats in the styles.xml file

I have a lot of data I want to load. What should I think of to get the best performance?
If you have more than, let's say 5 000 cells in the sheet and experience performance problems, have this in mind...
Always load cells from top to bottom left to right. That means that if you add a formula on the data you load, it's faster to add it for every row than to add it for a range after you have loaded the data (for ex. this will take a while,Worksheet.Cells"C1:C100000".Formula="A1+B1").
If you want to use a shared formula, like the sample, make sure you create the cells in sequence (use something like worksheet.Cellsrow,forumlaColumn.Value=null to create the cell. Then you can add the formula after you have finished loading your data.
Avoid using the InsertRow and DeleteRow methods.

How do I add a chart to my worksheet?
Use the drawings collection...

var chart = sheet.Drawings.AddChart("chart1", eChartType.AreaStacked);
//Set position and size
chart.SetPosition(0, 630);
chart.SetSize(800, 600);
//Add one serie. 
var serie = chart.Series.Add(Worksheet.Cells["A1:A4"],Worksheet.Cells["B1:B4"]);

How can I add a series with a different chart type to my chart?
Here's how you do...

ExcelChart chart = worksheet.Drawings.AddChart("chtLine", eChartType.LineMarkers);        
var serie1= chart.Series.Add(Worksheet.Cells["B1:B4"],Worksheet.Cells["A1:A4"]);
//Now for the second chart type we use the chart.PlotArea.ChartTypes collection...
var chartType2 = chart.PlotArea.ChartTypes.Add(eChartType.ColumnClustered);
var serie2 = chartType2.Series.Add(Worksheet.Cells["C1:C4"],Worksheet.Cells["A1:A4"]);

How do I add a secondary axis to my chart?
If you want to have a secondary axis on your chart you have to add a new charttype to the chart.
Something like this...

ExcelChart chart = worksheet.Drawings.AddChart("chtLine", eChartType.LineMarkers);        
var serie1= chart.Series.Add(Worksheet.Cells["B1:B4"],Worksheet.Cells["A1:A4"]);
var chartType2 = chart.PlotArea.ChartTypes.Add(eChartType.LineMarkers);
var serie2 = chartSerie2.Series.Add(Worksheet.Cells["C1:C4"],Worksheet.Cells["A1:A4"]);
chartType2.UseSecondaryAxis = true;

//By default the secondary X axis is hidden. If you what to show it, try this...
chartType2.XAxis.Deleted = false;
chartType2.XAxis.TickLabelPosition = eTickLabelPosition.High;

Can I use this library with Mono?
Good question! I haven't tried,so I have no idea. Please give me some feedback if you have tried.

Updated Wiki: Roadmap

JanKallman — Thu, 14 Feb 2013 19:29:01 GMT

Version 3.2

Formula parser, calc engine
Replacing the Package API with DotNetZip
New cellstore to imporve insert, delete performance and memory consumtion

Updated Wiki: Documentation

JanKallman — Thu, 14 Feb 2013 19:26:51 GMT

EPPlus Documentation

The best way to learn how to use this library is to download the sample project and step through the samples.
There is also an Sandcastle-build helpfile generated from the xml-comment file. The helpfile is incomplete (I still have a lot of commenting to do), but it can be helpful to explore the classes.

Problem or a Question? Try the FAQ

So where are we heading?... Roadmap

The Team:

	Currently working on	Base in
Jan Källman, Coordinator	New cellstore, Replace PackagingAPI with Dotnet Zip	Sweden
Mats Alm	Formula caluculation	Sweden

External Links

This is an nice article (with code samples) that shows some of the features in EPPlus...
http://zeeshanumardotnet.blogspot.com/2011/06/creating-reports-in-excel-2007-using.html

Updated Wiki: Documentation

JanKallman — Thu, 14 Feb 2013 19:26:01 GMT

EPPlus Documentation

Problem or a Question? Try the FAQ

So where are we heading?... Roadmap

The Team:

	Currently working on	Base in
Jan Källman, Coordinator	New cellstore, Replace PackagingAPI with Dotnet Zip	Sweden
Mats Alm	Formula caluculation	Sweden

External Links

This is an nice article (with code samples) that shows some of the features in EPPlus...
http://zeeshanumardotnet.blogspot.com/2011/06/creating-reports-in-excel-2007-using.html

Updated Wiki: Documentation

JanKallman — Thu, 14 Feb 2013 19:23:52 GMT

EPPlus Documentation

Problem or a Question? Try the FAQ

So where are we heading?... Roadmap

The Team:

	Currently working on	Base in
Jan Källman, Coordinator	New cellstore, Replace PackagingAPI with Dotnet Zip	Sweden
Mats Alm	Formula caluculation	Sweden

External Links

This is an nice article (with code samples) that shows some of the features in EPPlus...
http://zeeshanumardotnet.blogspot.com/2011/06/creating-reports-in-excel-2007-using.html

Updated Wiki: Documentation

JanKallman — Thu, 14 Feb 2013 19:22:51 GMT

EPPlus Documentation

Problem or a Question? Try the FAQ

So where are we heading?... Roadmap

The Team:

	Currently working on	Base in
Jan Källman, Coordinator	New cellstore, Replace PackagingAPI with Dotnet Zip	Sweden
Mats Alm	Formula caluculation	Sweden

Donations

If you like the project feel free to do a donation.

External Links

This is an nice article (with code samples) that shows some of the features in EPPlus...
http://zeeshanumardotnet.blogspot.com/2011/06/creating-reports-in-excel-2007-using.html

Updated Wiki: Documentation

JanKallman — Thu, 14 Feb 2013 19:21:52 GMT

EPPlus Documentation

Problem or a Question? Try the FAQ

So where are we heading?... Roadmap

The Team:

	Currently working on	Base in
Jan Källman, Coordinator	New cellstore, Replace PackagingAPI with Dotnet Zip	Sweden
Mats Alm	Formula caluculation	Sweden

Donations

If you like the project feel free to do a donation.

External Links

This is an nice article (with code samples) that shows some of the features in EPPlus...
http://zeeshanumardotnet.blogspot.com/2011/06/creating-reports-in-excel-2007-using.html

Updated Wiki: Documentation

JanKallman — Thu, 14 Feb 2013 19:21:21 GMT

EPPlus Documentation

Problem or a Question? Try the FAQ

So where are we heading?... Roadmap

The Team:

	Currently working on	Base in
Jan Källman, Coordinator	New cellstore, Replace PackagingAPI with Dotnet Zip	Sweden
Mats Alm	Formula caluculation	Sweden

Donations

If you like the project feel free to do a donation.

External Links

This is an nice article (with code samples) that shows some of the features in EPPlus...
http://zeeshanumardotnet.blogspot.com/2011/06/creating-reports-in-excel-2007-using.html

Updated Wiki: Documentation

JanKallman — Thu, 14 Feb 2013 19:20:07 GMT

EPPlus Documentation

Problem or a Question? Try the FAQ

So where are we heading?... Roadmap

The Team:

	Currently working on	Base in
Jan Källman, Coordinator	New cellstore, Replace PackagingAPI with Dotnet Zip	Sweden
Mats Alm	Formula caluculation	Sweden

Donations

If you like the project feel free to do a donation.

External Links

This is an nice article (with code samples) that shows some of the features in EPPlus...
http://zeeshanumardotnet.blogspot.com/2011/06/creating-reports-in-excel-2007-using.html

Updated Wiki: Documentation

JanKallman — Thu, 14 Feb 2013 19:18:47 GMT

EPPlus Documentation

Problem or a Question? Try the FAQ

So where are we heading?... Roadmap

The Team:

	Currently working on	Base in
Jan Källman, Coordinator	New cellstore, Replace PackagingAPI with Dotnet Zip	Sweden
Mats Alm	Formula caluculation	Sweden

Donations

If you like the project feel free to do a donation.

External Links

This is an nice article (with code samples) that shows some of the features in EPPlus...
http://zeeshanumardotnet.blogspot.com/2011/06/creating-reports-in-excel-2007-using.html

Updated Wiki: Documentation

JanKallman — Thu, 14 Feb 2013 19:18:02 GMT

EPPlus Documentation

Problem or a Question? Try the FAQ

So where are we heading?... Roadmap

The Team:

	Currently working on	Base in
Jan Källman, Coordinator	New cellstore, Replace PackagingAPI with Dotnet Zip	Sweden
Mats Alm	Formula caluculation	Sweden

Donations

If you like the project feel free to do a donation <form action="https://www.paypal.com/cgi-bin/webscr" enctype="application/x-www-form-urlencoded" method="post"><input name="cmd" type="hidden" value="_s-xclick" /> <input name="hosted_button_id" type="hidden" value="Y4HVS8C7LAJHJ" /> <input alt="PayPal — The safer, easier way to pay online." name="submit" src="https://www.paypalobjects.com/en_US/GB/i/btn/btn_donateCC_LG.gif" type="image" /> </form>

External Links

This is an nice article (with code samples) that shows some of the features in EPPlus...
http://zeeshanumardotnet.blogspot.com/2011/06/creating-reports-in-excel-2007-using.html

Updated Wiki: Documentation

JanKallman — Thu, 14 Feb 2013 19:02:03 GMT

EPPlus Documentation

Problem or a Question? Try the FAQ

So where are we heading?... Roadmap

The Team:

	Currently working on	Base in
Jan Källman, Coordinator	New cellstore, Replace PackagingAPI with Dotnet Zip	Sweden
Mats Alm	Formula caluculation	Sweden

External Links

This is an nice article (with code samples) that shows some of the features in EPPlus...
http://zeeshanumardotnet.blogspot.com/2011/06/creating-reports-in-excel-2007-using.html

New Comment on "FAQ"

tacotortilla — Wed, 09 Jan 2013 22:48:35 GMT

How do I remove an existing background color? This turns it black: worksheet.Cells.Style.Fill.BackgroundColor.SetColor(Color.Empty);