👁 Image
Gapotchenko.FX.Data.Archives.Zip 2026.7.2

Overview

The module provides ZIP archive functionality that integrates with the virtual file system (VFS) abstraction layer, allowing you to treat ZIP archives as file systems.

ZipArchive

ZipArchive class from Gapotchenko.FX.Data.Archives.Zip module represents a ZIP archive and implements IFileSystemView, which means you can use it just like a regular file system.

Creating a ZIP Archive

You can create a new ZIP archive:

using Gapotchenko.FX.Data.Archives.Zip;
using Gapotchenko.FX.IO.Vfs;

// Create a new writable ZIP archive
using var zip = ZipArchive.Storage.CreateFile("archive.zip");

// Now you can use it as a file system
zip.WriteAllText("readme.txt", "Hello from ZIP archive!");

Reading from a ZIP Archive

Reading from a ZIP archive is straightforward:

using Gapotchenko.FX.Data.Archives.Zip;
using Gapotchenko.FX.IO.Vfs;

// Open an existing ZIP archive for reading
using var zip = ZipArchive.Storage.ReadFile("archive.zip");

// Check if a file exists
if (zip.FileExists("readme.txt"))
{
 // Read file content
 string content = zip.ReadAllText("readme.txt");
 Console.WriteLine(content);
}

Working with Files

Since ZipArchive implements IFileSystemView, you can use all the typical file operations:

using Gapotchenko.FX.Data.Archives.Zip;
using Gapotchenko.FX.IO.Vfs;

using var zip = ZipArchive.Storage.OpenFile("archive.zip", FileMode.OpenOrCreate);

// Write text to a file
zip.WriteAllText("data.txt", "Some content");

// Read all lines
string[] lines = zip.ReadAllLines("data.txt");

// Copy a file
zip.CopyFile("data.txt", "backup.txt", overwrite: true);

// Delete a file
zip.DeleteFile("old.txt");

Enumerating Files

You can enumerate files and directories in a ZIP archive:

using Gapotchenko.FX.Data.Archives.Zip;
using System.IO;

using var zip = ZipArchive.Storage.ReadFile("archive.zip");

// Enumerate all files
foreach (string file in zip.EnumerateFiles("/"))
 Console.WriteLine(file);

// Enumerate files with a pattern
foreach (string file in zip.EnumerateFiles("/", "*.txt"))
 Console.WriteLine(file);

// Enumerate directories
foreach (string dir in zip.EnumerateDirectories("/"))
 Console.WriteLine(dir);

Working with Directories

Directory operations are also supported:

using Gapotchenko.FX.Data.Archives.Zip;
using System.IO;

using var zip = ZipArchive.Storage.CreateFile("archive.zip");

// Create a directory structure
zip.CreateDirectory("folder1/subfolder");

// Write files to directories
zip.WriteAllText("folder1/file.txt", "Content");

// Check if directory exists
if (zip.DirectoryExists("folder1"))
{
 // Enumerate files in directory
 foreach (string file in zip.EnumerateFiles("folder1"))
 Console.WriteLine(file);
}

Stream Management

You can control whether the underlying stream should remain open after disposing the archive:

using Gapotchenko.FX.Data.Archives.Zip;
using System.IO;

var stream = new FileStream("archive.zip", FileMode.Create);

// Leave the stream open after disposing the archive
using (var zip = new ZipArchive(stream, writable: true, leaveOpen: true))
 zip.WriteAllText("file.txt", "Content");

// Archive is disposed, but stream remains open
// ... stream can be used further

Capabilities

ZipArchive exposes capabilities that indicate what operations are supported:

using Gapotchenko.FX.Data.Archives.Zip;
using System.IO;

using var stream = new FileStream("archive.zip", FileMode.Open);
using var zip = new ZipArchive(stream, writable: false);

Console.WriteLine($"Can read: {zip.CanRead}");
Console.WriteLine($"Can write: {zip.CanWrite}");
Console.WriteLine($"Supports last write time: {zip.SupportsLastWriteTime}");

Integration with Virtual File System

Since ZipArchive implements IFileSystemView, it can be used anywhere a file system view is expected. This allows you to write code that works with both regular file systems and ZIP archives:

using Gapotchenko.FX.Data.Archives.Zip;
using Gapotchenko.FX.IO.Vfs;

// Works with local file system
ProcessFiles(FileSystemView.Local);

// Also works with ZIP archive
using (var zip = ZipArchive.Storage.ReadFile("archive.zip"))
{
 ProcessFiles(zip);

 // Works with a nested archive as well
 using (var nestedZip = ZipArchive.Storage.ReadFile(new VfsLocation(zip, "nested.zip"))
 ProcessFiles(nestedZip);
}

void ProcessFiles(IReadOnlyFileSystemView vfs)
{
 if (vfs.FileExists("data.txt"))
 {
 string content = vfs.ReadAllText("data.txt");
 // Process content...
 }
}

Related Modules

• Gapotchenko.FX.IO.Vfs - Provides the virtual file system abstraction layer
• Gapotchenko.FX.Data.Archives - Provides base functionality for data archives

Other Modules

Let's continue with a look at some other modules provided by Gapotchenko.FX:

• Gapotchenko.FX
• Gapotchenko.FX.AppModel.Information
• Gapotchenko.FX.Collections
• Gapotchenko.FX.Console
• Gapotchenko.FX.Data
  • Gapotchenko.FX.Data.Archives
    • ➴ Gapotchenko.FX.Data.Archives.Zip
  • Gapotchenko.FX.Data.Encoding
  • Gapotchenko.FX.Data.Integrity.Checksum
• Gapotchenko.FX.Diagnostics
• Gapotchenko.FX.IO
• Gapotchenko.FX.Linq
• Gapotchenko.FX.Math
• Gapotchenko.FX.Memory
• Gapotchenko.FX.Security.Cryptography
• Gapotchenko.FX.Text
• Gapotchenko.FX.Threading
• Gapotchenko.FX.Tuples
• Gapotchenko.FX.Versioning

Or look at the full list of modules.