FastZip - icsharpcode/SharpZipLib GitHub Wiki

This page shows how to create and extract zip files using the FastZip class.

How to create a Zip File

FastZip fastZip = new FastZip();

bool recurse = true;  // Include all files by recursing through the directory structure
string filter = null; // Dont filter any files at all
fastZip.CreateZip("fileName.zip", @"C:\SourceDirectory", recurse, filter);

Using the fileFilter parameter

If the file filter is not a null string, it is interpreted as a list of one or more regular expressions which is tested against each file name.

For example, a fileFilter value of 'txt' would match with 'Test.txt' but would also match with 'SometxtFile.doc'. To match with '.txt' you would need to add a a dot, but even then a filter of ".txt" would be interpreted as [any-character]txt. You need to add an escape character "" before the dot to specify it as a literal match. Note that if your literal string does not have an @ sign in front of it, you will need to use two consecutive \. For example "\\.txt" or @"\.txt" are the same (and "\.txt" will not compile).

Note that "\.txt" would still match a file such as "file.txtold" or "file.txt.old", so you can append the $ specifier which matches with the end of the string: e.g "\.txt$" to ensure you only match files with the last extension as .txt

FastZip fastZip = new FastZip();

bool recurse = true;  // Include all files by recursing through the directory structure
string filter = @"\.txt$"; // Only files ending in ".txt"
fastZip.CreateZip("fileName.zip", @"C:\SourceDirectory", recurse, filter);

The file filter and folder filter are actually lists.

Multiple regular expressions are separated with a semicolon (";"). Each one can be an inclusion or exclusion. Exclusions start with a minus sign ("-").
Inclusions may start with an optional plus sign ("+"). Some examples :

// Only files ending in ".txt" or ".log" ... except for any matching "NotThisFile"
string fileFilter = @"\.txt$;\.log$;-NotThisFile";

// Only files ending in ".txt" ... except for any matching "NotThisFile" or "Today"
string fileFilter = @"\.txt$;-NotThisFile;-Today";

Matching is not case-sensitive.

Each item in your filter is matched against the entire filename including drive and full folder path. Do not start an entry with a caret ("^") unless matching the full path string. To match a complete filename (within a folder), use a folder separator (a backslash). Because the backslash is also the escape character it must be entered twice.

// Matches a file called LogFile.txt but not SomeOtherLogFile.txt
string fileFilter = @"\\LogFile.txt$";

// Same as above but without the @ sign
string fileFilter = "\\\\LogFile.txt$";

Create a zip with FastZip using progress events

You can set events which will fire on each file. This gives you the opportunity to display a progress notification, and to decide whether to stop.

using System;
using System.IO;
using ICSharpCode.SharpZipLib.Core;
using ICSharpCode.SharpZipLib.Zip;
    
private int _uptoFileCount;
private int _totalFileCount;
    
public void TestFastZipCreate(string backupFolderPath) {
    
    	_totalFileCount = FolderContentsCount(backupFolderPath);
    
    	FastZipEvents events = new FastZipEvents();
    	events.ProcessFile = ProcessFileMethod;
    	FastZip fastZip = new FastZip(events);
    
    	fastZip.CreateEmptyDirectories = true;
    
    	string zipFileName = Directory.GetParent(backupFolderPath).FullName + "\\ZipTest.zip";
    
    	fastZip.CreateZip(zipFileName, backupFolderPath, true, "");
    }
    
    private void ProcessFileMethod(object sender, ScanEventArgs args) {
    	_uptoFileCount ++;
    	int percentCompleted = _uptoFileCount * 100 / _totalFileCount;
    	// do something here with a progress bar
    	// file counts are easier as sizes take more work to calculate, and compression levels vary by file type
    
    	string fileName = args.Name;
    	// To terminate the process, set args.ContinueRunning = false
    	if (fileName == "stop on this file")
    		args.ContinueRunning = false;
    }
    
    // Returns the number of files in this and all subdirectories
    private int FolderContentsCount(string path) {
    	int result = Directory.GetFiles(path).Length;
    	string[ ] subFolders = Directory.GetDirectories(path);
    	foreach (string subFolder in subFolders) {
    		result += FolderContentsCount(subFolder);
    	}
    	return result;
    }

How to extract a Zip File using FastZip

C#

    using System;
    using ICSharpCode.SharpZipLib.Zip;
    
    public void TestFastZipUnpack(string zipFileName, string targetDir) {
    
    	FastZip fastZip = new FastZip();
    	string fileFilter = null;
    
    	// Will always overwrite if target filenames already exist
    	fastZip.ExtractZip(zipFileName, targetDir, fileFilter);
    }

VB

    Imports ICSharpCode.SharpZipLib.Zip
    
    Public Sub TestFastZipUnpack(ByVal zipFileName As String, ByVal targetDir As String)
    
    	Dim fastZip As FastZip = New FastZip()
    	Dim fileFilter As String = Nothing
    
    	fastZip.ExtractZip(zipFileName, targetDir, fileFilter)
    End Sub

How to extract a Zip File using FastZip with Name Filter and Confirm Overwrite

C#

using System;
using System.Windows.Forms;
using ICSharpCode.SharpZipLib.Core;
using ICSharpCode.SharpZipLib.Zip;

private bool _stop;

public void TestFastZipUnpack(string zipFileName, string targetDir) {
    // Set the method that will be called on each file before extraction but after the OverwritePrompt (if applicable)
    FastZipEvents events = new FastZipEvents();
    events.ProcessFile = ProcessFileMethod;
    FastZip fastZip = new FastZip(events);

    // To conditionally extract files in FastZip, use the fileFilter and directoryFilter arguments.
    // The filter is a list of regex values separated with semi-colon. An entry starting with - is an exclusion.
    // See the NameFilter class for more details.
    // The following expression includes all name ending in '.dat' with the exception of 'dummy.dat'
    string fileFilter = @"+\.dat$;-^dummy\.dat$";
    string directoryFilter = null;
    bool restoreDateTime = true;

    // Will prompt to overwrite if target filenames already exist
    fastZip.ExtractZip(zipFileName, targetDir, FastZip.Overwrite.Prompt, OverwritePrompt,
                       fileFilter, directoryFilter, restoreDateTime);
}

private bool OverwritePrompt(string fileName) {
    // In this method you can choose whether to overwrite a file.
    DialogResult dr = MessageBox.Show("Overwrite " + fileName, "Overwrite?", MessageBoxButtons.YesNoCancel);
    if (dr == DialogResult.Cancel) {
        _stop = true;
        // Must return true if we want to abort processing, so that the ProcessFileMethod will be called.
        // When the ProcessFileMethod sets ContinueRunning false, processing will immediately stop.
        return true;
    }
    return dr == DialogResult.Yes;
}

private void ProcessFileMethod(object sender, ScanEventArgs args) {

    string fileName = args.Name;
    // To stop all further processing, set args.ContinueRunning = false
    if (_stop) {
        args.ContinueRunning = false;
    }
}

VB

Imports ICSharpCode.SharpZipLib.Zip
Imports ICSharpCode.SharpZipLib.Core
Imports System.Windows.Forms

Dim _stop As Boolean

Public Sub TestFastZipUnpack(ByVal zipFileName As String, ByVal targetDir As String)

    Dim events As FastZipEvents = New FastZipEvents()
    events.ProcessFile = AddressOf ProcessFileMethod
    Dim fastZip As FastZip = New FastZip(events)

    ' The only way to conditionally extraxt files in FastZip is to use the fileFilter and directoryFilter arguments.
    ' The filter is a list of regex values separated with semi-colon. An entry starting with - is an exclusion.
    ' See the NameFilter class for more examples.
    ' The following expression includes all name ending in '.dat' with the exception of 'dummy.dat'
    Dim fileFilter As String = "+\.dat$;-^dummy\.dat$"
    Dim directoryFilter As String = Nothing
    Dim restoreDateTime As Boolean = True

    ' Will prompt to overwrite if target filenames already exist
    fastZip.ExtractZip(zipFileName, targetDir, fastZip.Overwrite.Prompt, AddressOf OverwritePrompt, _
                       fileFilter, directoryFilter, restoreDateTime)
End Sub

Private Function OverwritePrompt(ByVal fileName As String) As Boolean

    ' In this method you can choose whether to overwrite a file.
    Dim dr As DialogResult = MessageBox.Show("Overwrite " + fileName, "Overwrite?", MessageBoxButtons.YesNoCancel)
    If (dr = DialogResult.Cancel) Then
        _stop = True
        ' Must return true if we want to abort processing, so that the ProcessFileMethod will be called.
        ' When the ProcessFileMethod sets ContinueRunning false, processing will immediately stop.
        Return True
    End If
    Return dr = DialogResult.Yes
End Function

Private Sub ProcessFileMethod(ByVal sender As Object, ByVal args As ScanEventArgs)

    Dim fileName As String = args.Name
    ' To stop all further processing, set args.ContinueRunning = false
    If (_stop) Then
        args.ContinueRunning = False
    End If
    
End Sub