ZipFileExtensions Classe

Definição

Fornece métodos de extensão para as classes ZipArchive e ZipArchiveEntry.

public static class ZipFileExtensions
Herança
ZipFileExtensions

Comentários

A ZipFileExtensions classe contém apenas métodos estáticos que estendem as ZipArchive classes e ZipArchiveEntry . Você não cria uma instância da ZipFileExtensions classe ; em vez disso, usa esses métodos de instâncias de ZipArchive ou ZipArchiveEntry.

Para usar os métodos de extensão, você deve referenciar o System.IO.Compression.FileSystem assembly em seu projeto. O System.IO.Compression.FileSystem assembly não está disponível em aplicativos da Loja Windows 8.x. Portanto, as ZipFileExtensions classes e ZipFile (ambas estão no System.IO.Compression.FileSystem assembly) não estão disponíveis em aplicativos da Store Windows 8.x. Em aplicativos Windows 8.x Store, você trabalha com arquivos compactados usando os métodos em ZipArchive, ZipArchiveEntry, DeflateStreame GZipStream.

A ZipFileExtensions classe contém quatro métodos que estendem ZipArchive:

A ZipFileExtensions classe contém dois métodos que estendem ZipArchiveEntry:

Exemplos

O exemplo a seguir mostra como criar uma nova entrada em um arquivo zip de um arquivo existente e extrair o conteúdo do arquivo morto para um diretório.

using System;
using System.IO;
using System.IO.Compression;

namespace ConsoleApplication
{
    class Program
    {
        static void Main(string[] args)
        {
            string zipPath = @"c:\users\exampleuser\start.zip";
            string extractPath = @"c:\users\exampleuser\extract";
            string newFile = @"c:\users\exampleuser\NewFile.txt";

            using (ZipArchive archive = ZipFile.Open(zipPath, ZipArchiveMode.Update))
            {
                archive.CreateEntryFromFile(newFile, "NewEntry.txt");
                archive.ExtractToDirectory(extractPath);
            }
        }
    }
}

O exemplo a seguir mostra como iterar por meio do conteúdo de um arquivo zip e extrair arquivos que têm uma extensão .txt.

using System;
using System.IO;
using System.IO.Compression;

class Program
{
    static void Main(string[] args)
    {
        string zipPath = @".\result.zip";

        Console.WriteLine("Provide path where to extract the zip file:");
        string extractPath = Console.ReadLine();

        // Normalizes the path.
        extractPath = Path.GetFullPath(extractPath);

        // Ensures that the last character on the extraction path
        // is the directory separator char.
        // Without this, a malicious zip file could try to traverse outside of the expected
        // extraction path.
        if (!extractPath.EndsWith(Path.DirectorySeparatorChar.ToString(), StringComparison.Ordinal))
            extractPath += Path.DirectorySeparatorChar;

        using (ZipArchive archive = ZipFile.OpenRead(zipPath))
        {
            foreach (ZipArchiveEntry entry in archive.Entries)
            {
                if (entry.FullName.EndsWith(".txt", StringComparison.OrdinalIgnoreCase))
                {
                    // Gets the full path to ensure that relative segments are removed.
                    string destinationPath = Path.GetFullPath(Path.Combine(extractPath, entry.FullName));

                    // Ordinal match is safest, case-sensitive volumes can be mounted within volumes that
                    // are case-insensitive.
                    if (destinationPath.StartsWith(extractPath, StringComparison.Ordinal))
                        entry.ExtractToFile(destinationPath);
                }
            }
        }
    }
}

Métodos

CreateEntryFromFile(ZipArchive, String, String)

Arquiva um arquivo compactando-o e adicionando-o ao arquivo zip.

CreateEntryFromFile(ZipArchive, String, String, CompressionLevel)

Arquiva um arquivo, compactando-o usando o nível de compactação especificado e adicionando-o ao arquivo zip.

ExtractToDirectory(ZipArchive, String)

Extrai todos os arquivos no arquivo zip especificado para um diretório do sistema de arquivos.

ExtractToDirectory(ZipArchive, String, Boolean)

Extrai todos os arquivos dos arquivos para um diretório do sistema de arquivos.

ExtractToFile(ZipArchiveEntry, String)

Extrai uma entrada no arquivo zip para um arquivo.

ExtractToFile(ZipArchiveEntry, String, Boolean)

Extrai uma entrada do arquivo zip para um arquivo e, opcionalmente, substitui um arquivo existente que tem o mesmo nome.

Aplica-se a

Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0