ZipFileExtensions Classe

Definição

Namespace:

System.IO.Compression

Assembly:

System.IO.Compression.ZipFile.dll

Origem:

ZipFileExtensions.ZipArchive.Create.cs

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

public ref class ZipFileExtensions abstract sealed

public static class ZipFileExtensions

type ZipFileExtensions = class

Public Module ZipFileExtensions

Herança

Object

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:

• CreateEntryFromFile(ZipArchive, String, String)

• CreateEntryFromFile(ZipArchive, String, String, CompressionLevel)

• ExtractToDirectory(ZipArchive, String)

• ExtractToDirectory(ZipArchive, String, Boolean)

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

• ExtractToFile(ZipArchiveEntry, String)

• ExtractToFile(ZipArchiveEntry, String, Boolean)

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);
            }
        }
    }
}

Imports System.IO
Imports System.IO.Compression

Module Module1

    Sub Main()
        Dim zipPath As String = "c:\users\exampleuser\end.zip"
        Dim extractPath As String = "c:\users\exampleuser\extract"
        Dim newFile As String = "c:\users\exampleuser\NewFile.txt"

        Using archive As ZipArchive = ZipFile.Open(zipPath, ZipArchiveMode.Update)
            archive.CreateEntryFromFile(newFile, "NewEntry.txt", CompressionLevel.Fastest)
            archive.ExtractToDirectory(extractPath)
        End Using
    End Sub

End Module

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);
                }
            }
        }
    }
}

Imports System.IO
Imports System.IO.Compression

Module Module1

    Sub Main()
        Dim zipPath As String = ".\result.zip"

        Console.WriteLine("Provide path where to extract the zip file:")
        Dim extractPath As String = 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 Not extractPath.EndsWith(Path.DirectorySeparatorChar.ToString(), StringComparison.Ordinal) Then
            extractPath += Path.DirectorySeparatorChar
        End If

        Using archive As ZipArchive = ZipFile.OpenRead(zipPath)
            For Each entry As ZipArchiveEntry In archive.Entries
                If entry.FullName.EndsWith(".txt", StringComparison.OrdinalIgnoreCase) Then

                    ' Gets the full path to ensure that relative segments are removed.
                    Dim destinationPath As String = 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) Then 
                        entry.ExtractToFile(destinationPath)
                    End If

                End If
            Next
        End Using
    End Sub

End Module

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.