Click here to Skip to main content
11,496,146 members (580 online)
Click here to Skip to main content

Generate Excel files without using Microsoft Excel

, 22 Jun 2011 CPOL 300.3K 16.8K 248
A C# class to create Excel files without requiring Microsoft Excel.
The site is currently in read-only mode for maintenance. Posting of new items will be available again shortly.

Introduction

Generating Excel files from web pages or other applications is a major subject in many articles. I'd like to present here a solution that does not require MS Excel to be installed on the target computer. This article shows how to create Microsoft Excel Binary Interchange File Format (BIFF) without using Microsoft Excel. BIFF is the native file format for Excel data, and can be viewed and modified in Microsoft Excel 97 or later.

Approaches and problems

The technique that is most frequently used to transfer data to an Excel workbooks is Automation. With Automation, you can call methods and properties that are specific to Excel tasks, but this solution has many drawbacks. Some of them are described in the Microsoft Knowledge Base. Additionally, you have to manage the lifetime of the temporary XLS files created on the server. Also, it is slow, because Excel runs in a separate process.

ExcelWriter class

The solution presented here is to write directly to a stream in Excel binary file format. For this purpose, I created very small C# class called ExcelWriter.

ExcelWriter class diagram
/// <summary>
/// Produces Excel file without using Excel
/// </summary>
public class ExcelWriter
{
    private Stream stream;
    private BinaryWriter writer;

    private ushort[] clBegin = { 0x0809, 8, 0, 0x10, 0, 0 };
    private ushort[] clEnd = { 0x0A, 00 };


    private void WriteUshortArray(ushort[] value)
    {
        for (int i = 0; i < value.Length; i++)
            writer.Write(value[i]);
    }

    /// <summary>
    /// Initializes a new instance of the <see cref="ExcelWriter"/> class.
    /// </summary>
    /// <param name="stream">The stream.</param>
    public ExcelWriter(Stream stream)
    {
        this.stream = stream;
        writer = new BinaryWriter(stream);
    }

    /// <summary>
    /// Writes the text cell value.
    /// </summary>
    /// <param name="row">The row.</param>
    /// <param name="col">The col.</param>
    /// <param name="value">The string value.</param>
    public void WriteCell(int row, int col, string value)
    {
        ushort[] clData = { 0x0204, 0, 0, 0, 0, 0 };
        int iLen = value.Length;
        byte[] plainText = Encoding.ASCII.GetBytes(value);
        clData[1] = (ushort)(8 + iLen);
        clData[2] = (ushort)row;
        clData[3] = (ushort)col;
        clData[5] = (ushort)iLen;
        WriteUshortArray(clData);
        writer.Write(plainText);
    }

    /// <summary>
    /// Writes the integer cell value.
    /// </summary>
    /// <param name="row">The row number.</param>
    /// <param name="col">The column number.</param>
    /// <param name="value">The value.</param>
    public void WriteCell(int row, int col, int value)
    {
        ushort[] clData = { 0x027E, 10, 0, 0, 0 };
        clData[2] = (ushort)row;
        clData[3] = (ushort)col;
        WriteUshortArray(clData);
        int iValue = (value << 2) | 2;
        writer.Write(iValue);
    }

    /// <summary>
    /// Writes the double cell value.
    /// </summary>
    /// <param name="row">The row number.</param>
    /// <param name="col">The column number.</param>
    /// <param name="value">The value.</param>
    public void WriteCell(int row, int col, double value)
    {
        ushort[] clData = { 0x0203, 14, 0, 0, 0 };
        clData[2] = (ushort)row;
        clData[3] = (ushort)col;
        WriteUshortArray(clData);
        writer.Write(value);
    }

    /// <summary>
    /// Writes the empty cell.
    /// </summary>
    /// <param name="row">The row number.</param>
    /// <param name="col">The column number.</param>
    public void WriteCell(int row, int col)
    {
        ushort[] clData = { 0x0201, 6, 0, 0, 0x17 };
        clData[2] = (ushort)row;
        clData[3] = (ushort)col;
        WriteUshortArray(clData);
    }

    /// <summary>
    /// Must be called once for creating XLS file header
    /// </summary>
    public void BeginWrite()
    {
        WriteUshortArray(clBegin);
    }

    /// <summary>
    /// Ends the writing operation, but do not close the stream
    /// </summary>
    public void EndWrite()
    {
        WriteUshortArray(clEnd);
        writer.Flush();
    }
}

Using the code

The ExcelWriter sample is a console application that writes an XLS file to the name and location specified. The XLS file that is created is simply an empty spreadsheet. Then, you can start to write cell values by calling the WriteCell method with the row number, column number, and a cell value as parameters:

namespace XLSExportDemo
{
    class Program
    {
        static void Main(string[] args)
        {
            FileStream stream = new FileStream("demo.xls", FileMode.OpenOrCreate);
            ExcelWriter writer = new ExcelWriter(stream);
            writer.BeginWrite();
            writer.WriteCell(0, 0, "ExcelWriter Demo");
            writer.WriteCell(1, 0, "int");
            writer.WriteCell(1, 1, 10);
            writer.WriteCell(2, 0, "double");
            writer.WriteCell(2, 1, 1.5);
            writer.WriteCell(3, 0, "empty");
            writer.WriteCell(3, 1);
            writer.EndWrite();
            stream.Close();
        }
    }
}

The picture below shows the final result of this sample:

The ExcelWriter class supports numeric and text values for the cells, and can be used for exporting data from the database to an XLS file, or for producing an XLS stream from a website on the fly.

I hope this article gives you a head start in working with Excel files from .NET and C#.

History

  • 03 March 2009 - Initial submission.

License

This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)

Share

About the Author

Serhiy Perevoznyk
Architect
Belgium Belgium
No Biography provided
Follow on   Twitter   Google+

Comments and Discussions

 
AnswerRe: How to create 2nd Excel sheet using your method? Pin
KapilDesai28-Aug-12 22:48
memberKapilDesai28-Aug-12 22:48 
QuestionVery Easy Pin
texgfalco30-Jun-11 14:32
membertexgfalco30-Jun-11 14:32 
AnswerRe: Very Easy Pin
Serhiy Perevoznyk1-Jul-11 10:37
memberSerhiy Perevoznyk1-Jul-11 10:37 
GeneralMy vote of 5 Pin
Jamal Alqabandi28-Jun-11 0:59
memberJamal Alqabandi28-Jun-11 0:59 
Questionnoob Pin
Barbo23-Jun-11 4:29
memberBarbo23-Jun-11 4:29 
AnswerRe: noob Pin
AORD22-May-12 13:10
memberAORD22-May-12 13:10 
GeneralMy vote of 5 Pin
Omar Gamil22-Jun-11 22:38
memberOmar Gamil22-Jun-11 22:38 
GeneralAlternative way to create Excel files without the need of Excel beeing installed [modified] Pin
aron.sinoai16-Jun-11 13:02
memberaron.sinoai16-Jun-11 13:02 
You can create nicely formatted Excel files very easily using this library, by reusing parts from a secondary Excel file (even entire worksheets):
http://officehelper.codeplex.com/documentation
Microsoft Office does not need to be installed on the target machine!

modified 24-Feb-12 11:27am.

GeneralHow to do CELL Format Pin
Member 390017225-May-11 21:55
memberMember 390017225-May-11 21:55 
GeneralRe: How to do CELL Format Pin
Serhiy Perevoznyk22-Jun-11 10:34
memberSerhiy Perevoznyk22-Jun-11 10:34 
GeneralHow can we format a cell like make it bold or give a background color using your write cell function? Pin
Samar pratap28-Apr-11 9:01
memberSamar pratap28-Apr-11 9:01 
GeneralRe: How can we format a cell like make it bold or give a background color using your write cell function? Pin
Member 390017225-May-11 22:01
memberMember 390017225-May-11 22:01 
GeneralRe: How can we format a cell like make it bold or give a background color using your write cell function? Pin
Serhiy Perevoznyk22-Jun-11 10:35
memberSerhiy Perevoznyk22-Jun-11 10:35 
GeneralCodepage problems Pin
TiMiNOd9-Apr-11 3:32
memberTiMiNOd9-Apr-11 3:32 
GeneralRe: Codepage problems Pin
TiMiNOd9-Apr-11 4:26
memberTiMiNOd9-Apr-11 4:26 
GeneralRe: Codepage problems Pin
Serhiy Perevoznyk22-Jun-11 10:39
memberSerhiy Perevoznyk22-Jun-11 10:39 
GeneralNice Pin
CikaPero29-Mar-11 0:57
memberCikaPero29-Mar-11 0:57 
GeneralMy vote of 5 Pin
Jesper Bihrmann2-Feb-11 4:05
memberJesper Bihrmann2-Feb-11 4:05 
GeneralI didn't open excel file was generated by your code Pin
Helen.Yu14-Jan-11 14:40
memberHelen.Yu14-Jan-11 14:40 
QuestionHow to write a Cell with DateTime format? Pin
Mark Carranza12-Jan-11 20:59
memberMark Carranza12-Jan-11 20:59 
GeneralMy vote of 4 Pin
cimsunf29-Nov-10 5:23
membercimsunf29-Nov-10 5:23 
GeneralMy vote of 4 Pin
rlejason28-Nov-10 21:42
memberrlejason28-Nov-10 21:42 
GeneralNPOI.codeplex.com .NET library (open source) could be considered as alternative, has more and source code Pin
AlexandreN12-Nov-10 9:03
memberAlexandreN12-Nov-10 9:03 
GeneralRe: NPOI.codeplex.com .NET library (open source) could be considered as alternative, has more and source code Pin
Serhiy Perevoznyk13-Nov-10 1:31
memberSerhiy Perevoznyk13-Nov-10 1:31 
GeneralSuggested change to code sample Pin
sdesciencelover9-Nov-10 5:30
membersdesciencelover9-Nov-10 5:30 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

| Advertise | Privacy | Terms of Use | Mobile
Web01 | 2.8.150520.1 | Last Updated 22 Jun 2011
Article Copyright 2009 by Serhiy Perevoznyk
Everything else Copyright © CodeProject, 1999-2015
Layout: fixed | fluid