ExcelWriter offers two approaches to generating, processing and manipulating Excel documents: ExcelTemplate and ExcelApplication. This tutorial will walk you through assigning the contents of a cell using ExcelTemplate and ExcelApplication.
[Download the Hello, World sample code]
Getting started with ExcelWriter in .NET
After ExcelWriter is installed, the next step is to create a .NET project and add a reference to the ExcelWriter library. These steps have already been done for you in the Hello, World sample.
- Open Visual Studio and create a .NET project (this tutorial uses a web application).
- Add a reference to SoftArtisans.OfficeWriter.ExcelWriter.dll
- SoftArtisans.OfficeWriter.ExcelWriter.dll is located under Program Files > SoftArtisans > OfficeWriter > bin
Hello World with ExcelTemplate
ExcelWriter's ExcelTemplate approach allows you to write data to a template file that contains data markers. The data markers tell ExcelWriter where to bind specific sets of data. This tutorial will show you the basics on how to dynamically insert data into a worksheet using ExcelTemplate.
Setting up the template file
The template file for Hello, World can be found under \templates\Hello World.xlsx
.
We are going to bind a single string value to a cell in a template file. To do this, we will first need to add a data marker to the cell where we want the value to appear.
We've already added the single data marker %%=$DataValue
to the Hello World.xlsx
template file. All ExcelWriter data markers are prefaced with %%=
and the $
sign means that the data source for this data marker is 1-dimensional (e.g. 1-dimensional array or single value). DataValue
is the data marker ID we'll use to bind the data to this data marker.
SCREEN SHOT
Now the template file is done. Next is writing the code to bind the string value to the data marker.
This section refers to the code-behind for the ExcelTemplate Hello, World sample: ExcelTemplate_HelloWorld.aspx.cs
.
Hello World with ExcelApplication
Next Steps
Basic tutorials will walk through everything you need to know to generate reports. Advanced tutorials help take your reporting to the next level! The page Programmer's API Reference could not be found.[Help]
The page Help could not be found.