Extracting data from a Zip archive using ZipReader

Example: Extracting data from a Zip archive using ZipReader on desktop environments

The following example shows how to read a Zip archive on desktop environments.

C#
VB.NET

static void ZipReaderExample()
{
  string zipFilePath = @"D:\RealTimeZipExamples\MyZipFile.zip";
  string destinationFolder = @"D:\UnzipToFolder";
  string password = "password";

  int bufferSize = 64 * 1024;
  byte[] buffer = new byte[ bufferSize ];

  // Create a stream for the zip file
  using( Stream zipFileStream = new FileStream( zipFilePath, FileMode.Open, FileAccess.Read, FileShare.Read, bufferSize, FileOptions.SequentialScan ) )
  {
    // Create a local header object
    ZipItemLocalHeader localHeader = new ZipItemLocalHeader();

    // Create the ZipReader object around the stream
    using( ZipReader zipReader = new ZipReader( zipFileStream ) )
    {
      // Optional. Provide the default password for encrypted items in the archive
      zipReader.EncryptionPassword = password;

      // Optional. Subscribe to available events
      zipReader.ByteProgression += new EventHandler<ZipReaderByteProgressionEventArgs>( OnByteProgression );
      zipReader.InvalidPassword += new EventHandler<ZipReaderInvalidPasswordEventArgs>( OnInvalidPassword );

      // While the reader finds local headers
      while( zipReader.ReadItemLocalHeader( localHeader ) != null )
      {
        // The 'FileName' property contains the sub-folders and filename
        string outputPath = destinationFolder + localHeader.FileName;
        string outputFolder = Path.GetDirectoryName( outputPath );

        // Make sure the output folder exists
        Directory.CreateDirectory( outputFolder );

        // If the item isn't a folder entry
        if( !localHeader.IsFolder )
        {
          // Create/overwrite an output file using our calculated filename
          using( FileStream outputFileStream = new FileStream( outputPath, FileMode.Create, FileAccess.Write, FileShare.None ) )
          {
            // Have the reader read the item data and write it to the stream using our buffer
            zipReader.ReadItemData( outputFileStream, buffer, 0, bufferSize );
          }
        }
      }
    }
  }
}

private static void OnInvalidPassword( object sender, ZipReaderInvalidPasswordEventArgs e )
{
  // TODO: We have access to the current item being unzipped. We can report it's name, etc
  ZipItemLocalHeader currentItem = e.ZipItemLocalHeader;

  // TODO: We're given the password that failed. We can report it, etc
  string oldPassword = e.OldPassword;

  /* If 'e.NewPassword' is set to null or an empty string, or 'e.Abort' is set to true,
  a ZipReaderException will be thrown for failure to decrypt the item.
  Since items can't be skipped, the entire unzip process will be canceled.
   
  When the event is triggered, 'e.NewPassword' is set to an empty string and 'e.Abort' is set
  to false. */

  // TODO: We have to supply a new password.
  // If that new password is invalid, the event will be triggered again
  e.NewPassword = "Some New Password";

  // TODO: We can ask the entire unzip operation to be aborted
  e.Abort = true;
}

private static void OnByteProgression( object sender, ZipReaderByteProgressionEventArgs e )
{
  // TODO: We have access to the current item being unzipped. We can report it's name, etc
  ZipItemLocalHeader currentItem = e.ZipItemLocalHeader;

  // TODO: We're given the current amount of bytes unzipped for the item. We can report it, etc
  long bytesProcessed = e.BytesProcessed;

  /* Do not assume that e.UncompressedSize and e.Percent will contain useful values.
  Since ZipReader doesn't seek in the archive, it cannot always know the uncompressed
  size in advance. */
}

    Private Shared Sub ZipReaderExample()
      Dim zipFilePath As String = "D:\RealTimeZipExamples\MyZipFile.zip"
      Dim destinationFolder As String = "D:\UnzipToFolder"
      Dim password As String = "password"

      Dim bufferSize As Integer = 64 * 1024
      Dim buffer(bufferSize - 1) As Byte

      ' Create a stream for the zip file
      Using zipFileStream As Stream = New FileStream(zipFilePath, FileMode.Open, FileAccess.Read, FileShare.Read, bufferSize, FileOptions.SequentialScan)
        ' Create a local header object
        Dim localHeader As New ZipItemLocalHeader()

        ' Create the ZipReader object around the stream
        Using zipReader As New ZipReader(zipFileStream)
          ' Optional. Provide the default password for encrypted items in the archive
          zipReader.EncryptionPassword = password

          ' Optional. Subscribe to available events
          AddHandler zipReader.ByteProgression, AddressOf OnByteProgression
          AddHandler zipReader.InvalidPassword, AddressOf OnInvalidPassword

          ' While the reader finds local headers
          Do While zipReader.ReadItemLocalHeader(localHeader) IsNot Nothing
            ' The 'FileName' property contains the sub-folders and filename
            Dim outputPath As String = destinationFolder & localHeader.FileName
            Dim outputFolder As String = Path.GetDirectoryName(outputPath)

            ' Make sure the output folder exists
            Directory.CreateDirectory(outputFolder)

            ' If the item isn't a folder entry
            If (Not localHeader.IsFolder) Then
              ' Create/overwrite an output file using our calculated filename
              Using outputFileStream As New FileStream(outputPath, FileMode.Create, FileAccess.Write, FileShare.None)
                ' Have the reader read the item data and write it to the stream using our buffer
                zipReader.ReadItemData(outputFileStream, buffer, 0, bufferSize)
              End Using
            End If
          Loop
        End Using
      End Using
    End Sub

    Private Shared Sub OnInvalidPassword(ByVal sender As Object, ByVal e As ZipReaderInvalidPasswordEventArgs)
      ' TODO: We have access to the current item being unzipped. We can report it's name, etc
      Dim currentItem As ZipItemLocalHeader = e.ZipItemLocalHeader

      ' TODO: We're given the password that failed. We can report it, etc
      Dim oldPassword As String = e.OldPassword

'       If 'e.NewPassword' is set to null or an empty string, or 'e.Abort' is set to true,
'      a ZipReaderException will be thrown for failure to decrypt the item.
'      Since items can't be skipped, the entire unzip process will be canceled.
'       
'      When the event is triggered, 'e.NewPassword' is set to an empty string and 'e.Abort' is set
'      to false. 

      ' TODO: We have to supply a new password.
      ' If that new password is invalid, the event will be triggered again
      e.NewPassword = "Some New Password"

      ' TODO: We can ask the entire unzip operation to be aborted
      e.Abort = True
    End Sub

    Private Shared Sub OnByteProgression(ByVal sender As Object, ByVal e As ZipReaderByteProgressionEventArgs)
      ' TODO: We have access to the current item being unzipped. We can report it's name, etc
      Dim currentItem As ZipItemLocalHeader = e.ZipItemLocalHeader

      ' TODO: We're given the current amount of bytes unzipped for the item. We can report it, etc
      Dim bytesProcessed As Long = e.BytesProcessed

'       Do not assume that e.UncompressedSize and e.Percent will contain useful values.
'      Since ZipReader doesn't seek in the archive, it cannot always know the uncompressed
'      size in advance. 
    End Sub

Example: Extracting data from a Zip archive using ZipReader on Xamarin (Android and iOS)

The following example shows how to read a Zip archive on Xamarin (Android and iOS).

C#
VB.NET

static void ZipReaderExampleXamarin( Stream zipFileStream )
{
  string password = "password";

  /* If we'll be extracting many items from the archive, we'll create a work buffer
      ahead of time and use it over and over again to avoid creating a new buffer
      each time we write to a destination. */

  int bufferSize = 64 * 1024;
  byte[] buffer = new byte[ bufferSize ];

  Dictionary<string, MemoryStream> extractedFiles = new Dictionary<string, MemoryStream>();

  /* NOTE: The zip file can be any type of stream you use. A network stream, a file stream, etc
      The component will never call Stream.Seek() on the stream and will only read to it.
    
      This example will use the 'zipFileStream' memory stream used in the ZipWriter example. */

  // Make sure the zip file stream is positioned at the start
  zipFileStream.Seek( 0, SeekOrigin.Begin );

  // Create a local header object that will be reused
  ZipItemLocalHeader localHeader = new ZipItemLocalHeader();

  // Create the ZipReader object around the stream
  using( ZipReader zipReader = new ZipReader( zipFileStream ) )
  {
    /* As a convenience, ZipReader offers the option to automatically close the input stream when
        ZipReader is closed. The behavior is disabled by default.
     
        In this example, we will not enable it as we may want to manipulate the zip file
        after it has been read. */
    //zipReader.AllowInputStreamClosure = true;

    // Optional. Provide the default password for encrypted items in the archive
    zipReader.EncryptionPassword = password;

    // Optional. Subscribe to available events
    zipReader.ByteProgression += new EventHandler<ZipReaderByteProgressionEventArgs>( OnByteProgression );
    zipReader.InvalidPassword += new EventHandler<ZipReaderInvalidPasswordEventArgs>( OnInvalidPassword );

    /* Here, we supply the local header object we created above.
        ReadItemLocalHeader() will fill the object with current data and return a
        reference to the same object.
        
        ReadItemLocalHeader() can also be called without parameters. Then, it will
        create a new ZipItemLocalHeader object and return it with current data. */

    // While the reader finds local headers
    while( zipReader.ReadItemLocalHeader( localHeader ) != null )
    {
      /* NOTE: 'localHeader.FileName' will contain a leading slash */

      // If the item isn't a folder entry
      if( !localHeader.IsFolder )
      {
        /* NOTE: The destination data can be any type of stream you need. A network stream, a file stream, etc
            The component will never call Stream.Seek() on the stream and will only write to it.
   
            This example will use memory data to keep it simple and on point. */
        MemoryStream outputStream = new MemoryStream();
        
        extractedFiles.Add( localHeader.FileName, outputStream );

        // Have the reader read the item data and write it to the stream using our buffer
        zipReader.ReadItemData( outputStream, buffer, 0, bufferSize );
      }
    }
  }
}

private static void OnInvalidPassword( object sender, ZipReaderInvalidPasswordEventArgs e )
{
  // TODO: We have access to the current item being unzipped. We can report it's name, etc
  ZipItemLocalHeader currentItem = e.ZipItemLocalHeader;

  // TODO: We're given the password that failed. We can report it, etc
  string oldPassword = e.OldPassword;

  /* If 'e.NewPassword' is set to null or an empty string, or 'e.Abort' is set to true,
  a ZipReaderException will be thrown for failure to decrypt the item.
  Since items can't be skipped, the entire unzip process will be canceled.
   
  When the event is triggered, 'e.NewPassword' is set to an empty string and 'e.Abort' is set
  to false. */

  // TODO: We have to supply a new password.
  // If that new password is invalid, the event will be triggered again
  e.NewPassword = "Some New Password";

  // TODO: We can ask the entire unzip operation to be aborted
  e.Abort = true;
}

private static void OnByteProgression( object sender, ZipReaderByteProgressionEventArgs e )
{
  // TODO: We have access to the current item being unzipped. We can report it's name, etc
  ZipItemLocalHeader currentItem = e.ZipItemLocalHeader;

  // TODO: We're given the current amount of bytes unzipped for the item. We can report it, etc
  long bytesProcessed = e.BytesProcessed;

  /* Do not assume that e.UncompressedSize and e.Percent will contain useful values.
  Since ZipReader doesn't seek in the archive, it cannot always know the uncompressed
  size in advance. */
}

Private Shared Sub ZipReaderExampleXamarin(ByVal zipFileStream As Stream)
Dim password As String = "password"

' If we'll be extracting many items from the archive, we'll create a work buffer
' ahead of time and use it over and over again to avoid creating a new buffer
' each time we write to a destination.

Dim bufferSize As Integer = 64 * 1024
Dim buffer(bufferSize - 1) As Byte

Dim extractedFiles As Dictionary(Of String, MemoryStream) = New Dictionary(Of String, MemoryStream)()

' NOTE: The zip file can be any type of stream you use. A network stream, a file stream, etc
' The component will never call Stream.Seek() on the stream and will only read to it.
'
' This example will use the 'zipFileStream' memory stream used in the ZipWriter example.

' Make sure the zip file stream is positioned at the start
zipFileStream.Seek(0, SeekOrigin.Begin)

' Create a local header object that will be reused
Dim localHeader As New ZipItemLocalHeader()

' Create the ZipReader object around the stream
Using zipReader As New ZipReader(zipFileStream)
' As a convenience, ZipReader offers the option to automatically close the input stream when
' ZipReader is closed. The behavior is disabled by default.
'
' In this example, we will not enable it as we may want to manipulate the zip file
' after it has been read.
'zipReader.AllowInputStreamClosure = true;

' Optional. Provide the default password for encrypted items in the archive
zipReader.EncryptionPassword = password

' Optional. Subscribe to available events
AddHandler zipReader.ByteProgression, AddressOf OnByteProgression
AddHandler zipReader.InvalidPassword, AddressOf OnInvalidPassword

' Here, we supply the local header object we created above.
' ReadItemLocalHeader() will fill the object with current data and return a
' reference to the same object.
'
' ReadItemLocalHeader() can also be called without parameters. Then, it will
' create a new ZipItemLocalHeader object and return it with current data.

' While the reader finds local headers
Do While zipReader.ReadItemLocalHeader(localHeader) IsNot Nothing
' NOTE: 'localHeader.FileName' will contain a leading slash

' If the item isn't a folder entry
If (Not localHeader.IsFolder) Then
' NOTE: The destination data can be any type of stream you need. A network stream, a file stream, etc
' The component will never call Stream.Seek() on the stream and will only write to it.
'
' This example will use memory data to keep it simple and on point.
Dim outputStream As New MemoryStream()

extractedFiles.Add(localHeader.FileName, outputStream)

' Have the reader read the item data and write it to the stream using our buffer
zipReader.ReadItemData(outputStream, buffer, 0, bufferSize)
End If
Loop
End Using
End Sub

Private Shared Sub OnInvalidPassword(ByVal sender As Object, ByVal e As ZipReaderInvalidPasswordEventArgs)
' TODO: We have access to the current item being unzipped. We can report it's name, etc
Dim currentItem As ZipItemLocalHeader = e.ZipItemLocalHeader

' TODO: We're given the password that failed. We can report it, etc
Dim oldPassword As String = e.OldPassword

' If 'e.NewPassword' is set to null or an empty string, or 'e.Abort' is set to true,
' a ZipReaderException will be thrown for failure to decrypt the item.
' Since items can't be skipped, the entire unzip process will be canceled.
'
' When the event is triggered, 'e.NewPassword' is set to an empty string and 'e.Abort' is set
' to false.

' TODO: We have to supply a new password.
' If that new password is invalid, the event will be triggered again
e.NewPassword = "Some New Password"

' TODO: We can ask the entire unzip operation to be aborted
e.Abort = True
End Sub

Private Shared Sub OnByteProgression(ByVal sender As Object, ByVal e As ZipReaderByteProgressionEventArgs)
' TODO: We have access to the current item being unzipped. We can report it's name, etc
Dim currentItem As ZipItemLocalHeader = e.ZipItemLocalHeader

' TODO: We're given the current amount of bytes unzipped for the item. We can report it, etc
Dim bytesProcessed As Long = e.BytesProcessed

' Do not assume that e.UncompressedSize and e.Percent will contain useful values.
' Since ZipReader doesn't seek in the archive, it cannot always know the uncompressed
' size in advance.
End Sub