Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

1. Include the SoftArtisans.OfficeWriter.ExcelWriter namespace in the code behind.

Csharp
818
1
using SoftArtisans.OfficeWriter.ExcelWriter;
Vbnet
1
1

Imports SoftArtisans.OfficeWriter.ExcelWriter

2. Instantiate the ExcelApplication object

Csharp
929
2
ExcelApplication oXLAPP = new ExcelApplication();
Vbnet
2
2

Unlike the ExcelTemplate object, which represents a single file, the ExcelApplication works as a file generation engine. The ExcelApplication object can be used to create, open, and save multiple workbooks.

3. Create a new workbook with ExcelApplication.Create()

Csharp
10310
3
Workbook oWB = oXLAPP.Create(ExcelApplication.FileFormat.Excel2007);
Vbnet
3
3

ExcelWriter has the ability to create Excel 2003 (XLS) files and Excel 2007 (XLSX) files, but cannot convert between formats. The file format must be declared when the workbook is created and the file extension of the output file must match when the file is saved.

...

4. Access the first worksheet through the Workbook.Worksheets collection

Csharp
11411
4
Worksheet oWKST = oWB.Worksheets[0];
Vbnet
4
4

You can access worksheets by name (e.g. "Sheet1") or by index (shown above), but ExcelWriter will throw an exception if you attempt to access a worksheet that does not exist.

5. Write the value from the web form into a cell

Csharp
12512
5
string value = DataValueBox.Text.Trim();
 oWKST.Cells[0,0].Value = value;
Vbnet
5
5

It is important to note that ExcelWriter indices are all 0-indexed, unlike Excel indices, which are 1-indexed. This is importing when working with cells, rows, columns, and worksheet positions in ExcelWriter. You can also reference cells by name; in this case, it would be "A1".

6. Save the workbook

Csharp
13613
6
oXLAPP.Save(oWB, Page.Response, "Output.xlsx", false);
Vbnet
6
6

ExcelApplication.Save has the same output options as ExcelTemplate: save to disk, save to memory stream, stream back to the client inline, and stream back to the client as an attachment. In this case, we're streaming the workbook back to the client as an attachment.
Remember that the file extension must match the file format specified when the workbook was created.

...

SCREEN SHOT

Final Code

Csharp
43743
7

using SoftArtisans.OfficeWriter.ExcelWriter;
ExcelApplication oXLAPP = new ExcelApplication();
ExcelApplication oXLAPP = new ExcelApplication();
Worksheet oWKST = oWB.Worksheets[0];
string value = DataValueBox.Text.Trim();
oWKST.Cells[0,0].Value = value;
oXLAPP.Save(oWB, Page.Response, "Output.xlsx", false);

Vbnet
8
8