Click here to Skip to main content
14,106,748 members
Click here to Skip to main content
Add your own
alternative version


361 bookmarked
Posted 23 Nov 2007
Licenced CPOL

ZipStorer - A Pure C# Class to Store Files in Zip

, 16 Sep 2015
Rate this:
Please Sign up or sign in to vote.
Small C# class to store and extract uncompressed and deflated files in new or existing Zip files, without any external library

Zip_Storer - Click on image to enlarge


There are many techniques to produce Zip files in a .NET 2.0 environment, like the following:

  • Using the namespace
  • Invoking Shell API features
  • Using a third-party .NET library
  • Wrapping and marshalling a non-.NET library
  • Invoking a compression tool at command-line

I have tested most of them, each one has pros and cons, but sometimes I just needed a tiny library to store files in a Zip with basic compression or plain storing. I have built my own minimalistic class to create Zip files and store/retrieve files to/from it, firstly with uncompressed storing capabilities and now with Deflate algorithm. no other compression methods supported.

Moreover, notice that the new .NET 3.0 and 3.5 Frameworks come with the ZipPackage class, but it is not available for .NET 2.0 or Compact Framework applications. A restriction of ZipPackage is that you cannot avoid generating an extra file inside named [Content_Type].xml.


The following diagram depicts a Zip file structure; you will notice it is a bit redundant because of its double directory approach (local and central). This is because it is designed to support creation in a sequential-access-only device.

Screenshot - Zip_Structure.png

The contents of each section can vary depending on the Operating System and hardware platform. The original PKWare specification has been included with this article.

Using the Code

The ZipStorer class is the unique one needed to create the zip file. It contains a nested structure (ZipFileEntry) to collect each directory entry. The class has been declared inside the System.IO namespace. The following diagram describes all the ZipStorer class members:


There is no default constructor. There are two ways to construct a new ZipStorer instance, depending on specific needs: use either Create() or Open() static methods. To create a new Zip file, use the Create() method like this:

ZipStorer zip = ZipStorer.Create(filename, comment);  // file-oriented version
ZipStorer zip = ZipStorer.Create(stream, comment);  // stream-oriented version

It is required to specify the full path for the new zip file, or pass a valid stream, and optionally add a comment. To open an existing zip file for appending, the Open() method is required, like the following:

ZipStorer zip = ZipStorer.Open(filename, fileaccess);  // file-oriented version
ZipStorer zip = ZipStorer.Open(stream, fileaccess);  // stream-oriented version

Where fileaccess should be of type System.IO.FileAccess enumeration type. Also, as now ZipStorer is derived from IDisposable interface, the using keyword can be used to ensure proper disposing of the storage resource:

using (ZipStorer zip = ZipStorer.Create(filename, comment))
    // some operations with zip object
}   // automatic close operation here

To add files into an opened zip storage, there are two available methods:

public void AddFile(ZipStorer.Compress _method, string _pathname, string _filenameInZip,
string _comment);
public void AddStream(ZipStorer.Compress _method, string _filenameInZip, Stream _source,
    DateTime _modTime, string _comment);

The first method allows you to add an existing file to the storage. The first argument receives the compression method; it can be Store or Deflate enum values. The second argument admits the physical path name, the third one allows to change the path or file name to be stored in the Zip, and the last argument inserts a comment in the storage. Notice that the folder path in the _pathname argument is not saved in the Zip file. Use the _filenameInZip argument instead to specify the folder path and filename. It can be expressed with both slashes or backslashes.

The second method allows you to add data from any kind of stream object derived from the System.IO.Stream class. Internally, the first method opens a FileStream and calls the second method.

Finally, you have to close the storage with the Close() method. This will save the central directory information too. Alternatively, you can use Dispose() method.

Sample Application

The provided sample application will ask for files and store the path names in a ListBox, along with the operation type: creating or appending, and compression method. Once the Proceed button is pressed, the following code snippet will be executed:

ZipStorer zip;

if (this.RadioCreate.Checked)
    // Creates a new zip file
    zip = ZipStorer.Create(TextStorage.Text, "Generated by ZipStorer class");
    // Creates a new zip file
    zip = ZipStorer.Open(TextStorage.Text, FileAccess.Write);

    // Stores all the files into the zip file
    foreach (string path in listBox1.Items)
       zip.AddFile(this.checkCompress.Checked ? 
	ZipStorer.Compression.Deflate : ZipStorer.Compression.Store,
       	path, Path.GetFileName(path), "");

// Creates a memory stream with text
MemoryStream readme = new MemoryStream(
System.Text.Encoding.UTF8.GetBytes(string.Format("{0}\r\nThis file
    has been {1} using the ZipStorer class, by Jaime Olivares.",
DateTime.Now, this.RadioCreate.Checked ? "created" : "appended")));

// Stores a new file directly from the stream
zip.AddStream("readme.txt", readme, DateTime.Now, "Please read");

// Updates and closes the zip file

This code snippet shows how to add both physical files and a little readme text from a memory stream.

Notice that the sample has been produced with Visual Studio 2008. The solution cannot be loaded directly with Visual Studio 2005, but a new solution can be created and the project file attached to it without problems.

Extracting Stored Files

To extract a file, the zip directory shall be read first, by using the ReadCentralDir() method, and then the ExtractFile() method, like in the following minimal sample code:

// Open an existing zip file for reading
ZipStorer zip = ZipStorer.Open(@"c:\data\", FileAccesss.Read);

// Read the central directory collection
List<ZipStorer.ZipFileEntry> dir = zip.ReadCentralDir();

// Look for the desired file
foreach (ZipStorer.ZipFileEntry entry in dir)
    if (Path.GetFileName(entry.FilenameInZip) == "sample.jpg")
        // File found, extract it
        zip.ExtractFile(entry, @"c:\data\sample.jpg");

Removal of Entries

Removal of entries in a zip file is a resource-consuming task. The simplest way is to copy all non-removed files into a new zip storage. The RemoveEntries() static method will do this exactly and will construct the ZipStorer object again. For the sake of efficiency, RemoveEntries() will accept many entry references in a single call, as in the following example:

List<ZipStorer.ZipFileEntry> removeList = new List<ZipStorer.ZipFileEntry>();

foreach (object sel in listBox4.SelectedItems)

ZipStorer.RemoveEntries(ref zip, removeList);

Files or Streams?

The current release of ZipStorer supports both files and streams for creating and opening a zip storage. Several methods are overloaded for this dual support. The advantage of file-oriented methods is simplicity, since those methods will open or create files internally. On the other hand, stream-oriented methods are more flexible by allowing to manage zip storages in streams different than files. File-oriented methods will invoke internally to equivalent stream-oriented methods. Notice that not all streams will apply, because the library requires the streams to be randomly accessed (CanSeek = true). The RemoveEntries method will work only if the zip storage is a file.

// File-oriented methods:
        public static ZipStorer Create(string _filename, string _comment)
        public static ZipStorer Open(string _filename, FileAccess _access)
        public void AddFile(Compression _method, 
		string _pathname, string _filenameInZip, string _comment)
        public bool ExtractFile(ZipFileEntry _zfe, string _filename)
        public static bool RemoveEntries
		(ref ZipStorer _zip, List<zipfileentry> _zfes)  // No stream-oriented equivalent

// Stream-oriented methods:
        public static ZipStorer Create(Stream _stream, string _comment)
        public static ZipStorer Open(Stream _stream, FileAccess _access)
        public void AddStream(Compression _method, 
	string _filenameInZip, Stream _source, DateTime _modTime, string _comment)
        public bool ExtractFile(ZipFileEntry _zfe, Stream _stream)</zipfileentry>

Filename Encoding

Traditionally, the ZIP format supported DOS encoding system (a.k.a. IBM Code Page 437) for filenames in header records, which is a serious limitation for using non-occidental and even some occidental characters. Since 2007, the ZIP format specification was improved to support Unicode's UTF-8 encoding system.

ZipStorer class detects UTF-8 encoding by reading the proper flag in each file's header information. To enforce filenames to be encoded with UTF-8 system, set the EncodeUTF8 member of ZipStorer class to true. All new filenames added will be encoded with UTF8. Notice this doesn't affect stored file contents at all. Also be aware that Windows Explorer's embedded Zip format facility does not recognize well the UTF-8 encoding system, like it does WinZip or WinRAR.

Compatibility with ePUB & OCF

The ZipStorer library has been adjusted to comply with Open Container Format Specification (OCF), one of the standards required to produce ePUB Digital Books. There are some specific requirements to fulfill the OCF specification:

  • The storage shall have the .epub extension instead of .zip
  • The first file in storage must be non-compressed and shall be called mimetypes, containing the string application/epub+zip
  • Do not use comments in zip file entries or zip storage
  • The filenames shall be encoded in UTF8. Set the storage field EncodeUTF8 to true

Source Code

The source code is available now in github

ZipStorer can also be downloaded directly from nuget: 

Advantages and Usage

ZipStorer has the following advantages:

  • It is a short and monolithic C# class that can be embedded as source code in any project (1 source file of 33K, 700+ lines)
  • No external libraries, no extra DLLs in application deployments
  • No Interop calls, increments portability to Mono and other non-Windows platforms
  • Can also be implemented with .NET Compact Framework
  • Fast storing and extracting, because the code is simple and short
  • UTF8 Encoding support and ePUB compatibility

To implement this class into your own project, just add the ZipStorer.cs class file and start using it without any restriction.


  • November 23rd, 2007: First version
  • June 1st, 2008: Added append and extraction features
  • June 20th, 2008: Corrected some bugs in extraction portion
  • August 3rd, 2008: Corrected more bugs in extraction portion
  • October 3rd, 2008: Improved demo application with extraction code sample
  • August 22nd, 2009: Added compression capability
  • October 3rd, 2009: Added removal capability and other minor improvements
  • February 21st, 2010: Improved support to streams, and ePub compatibility
  • March 13th, 2010: Improved UTF-8 support and timestamp handling
  • August 17th, 2015: Added a version (contribution of gotorg@codeplex)
  • September 16th, 2015: Moved the source code to github


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


About the Author

Jaime Olivares
Peru Peru

Computer Electronics professional, Software Architect and senior Windows C++ and C# developer with experience in many other programming languages, platforms and application areas including communications, simulation systems, PACS/DICOM (radiology), GIS, 3D graphics and HTML5-based web applications.
Currently intensively working with Visual Studio and TFS.

You may also be interested in...

Comments and Discussions

GeneralSplendid Pin
ldyc11-Jun-08 14:51
memberldyc11-Jun-08 14:51 
Jaime Olivares2-Jun-08 19:02
memberJaime Olivares2-Jun-08 19:02 
Jaime Olivares4-Jun-08 9:05
memberJaime Olivares4-Jun-08 9:05 
QuestionHow to decompress? Pin
necati sekkeli24-Apr-08 0:55
membernecati sekkeli24-Apr-08 0:55 
GeneralRe: How to decompress? Pin
Jaime Olivares24-Apr-08 2:28
memberJaime Olivares24-Apr-08 2:28 
AnswerRe: How to decompress? Pin
Jaime Olivares2-Jun-08 12:19
memberJaime Olivares2-Jun-08 12:19 
GeneralLisence Pin
martin.olsen14-Apr-08 12:43
membermartin.olsen14-Apr-08 12:43 
GeneralRe: Lisence Pin
Jaime Olivares15-Apr-08 12:21
memberJaime Olivares15-Apr-08 12:21 
Hi Martin,
You can use it as you want.
I have assigned it the Code Project Open License.
Good luck.

Best regards,

GeneralWell done... Pin
dregsor4-Jan-08 7:53
memberdregsor4-Jan-08 7:53 
GeneralAdd to existing zip file Pin
MrGrrrrr30-Nov-07 20:57
memberMrGrrrrr30-Nov-07 20:57 
GeneralRe: Add to existing zip file Pin
Jaime Olivares1-Dec-07 2:01
memberJaime Olivares1-Dec-07 2:01 
GeneralRe: Add to existing zip file Pin
Jaime Olivares2-Jun-08 12:20
memberJaime Olivares2-Jun-08 12:20 
GeneralVery clever Pin
Simon Mourier26-Nov-07 21:22
memberSimon Mourier26-Nov-07 21:22 
GeneralRar Pin
Sk8tz26-Nov-07 19:20
professionalSk8tz26-Nov-07 19:20 
AnswerRe: Rar Pin
Jaime Olivares26-Nov-07 19:26
memberJaime Olivares26-Nov-07 19:26 
Generalwhy not use ICSharpCode.ZLib or 7zip Pin
dimzon26-Nov-07 3:01
memberdimzon26-Nov-07 3:01 
GeneralRe: why not use ICSharpCode.ZLib or 7zip Pin
Jaime Olivares26-Nov-07 5:06
memberJaime Olivares26-Nov-07 5:06 
QuestionWhy don't compress? Pin
Edward11123-Nov-07 17:14
memberEdward11123-Nov-07 17:14 
AnswerRe: Why don't compress? Pin
Jaime Olivares23-Nov-07 17:23
memberJaime Olivares23-Nov-07 17:23 
GeneralRe: Why don't compress? Pin
Alex Furmanski28-Nov-07 5:36
memberAlex Furmanski28-Nov-07 5:36 
GeneralRe: Why don't compress? Pin
Jaime Olivares28-Nov-07 5:40
memberJaime Olivares28-Nov-07 5:40 
GeneralRe: Why don't compress? Pin
Jaime Olivares3-Aug-09 13:18
memberJaime Olivares3-Aug-09 13:18 
GeneralFolders Pin
Dewey23-Nov-07 16:44
memberDewey23-Nov-07 16:44 
AnswerRe: Folders Pin
Jaime Olivares23-Nov-07 16:52
memberJaime Olivares23-Nov-07 16:52 
GeneralRe: Folders Pin
Programm3r2-Jan-08 23:15
memberProgramm3r2-Jan-08 23:15 

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

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

Permalink | Advertise | Privacy | Cookies | Terms of Use | Mobile
Web04 | 2.8.190518.1 | Last Updated 17 Sep 2015
Article Copyright 2007 by Jaime Olivares
Everything else Copyright © CodeProject, 1999-2019
Layout: fixed | fluid