ZipFileExtensions Classe

Definição

Fornece métodos de extensão para as classes ZipArchive e ZipArchiveEntry.Provides extension methods for the ZipArchive and ZipArchiveEntry classes.

public ref class ZipFileExtensions abstract sealed
public static class ZipFileExtensions
type ZipFileExtensions = class
Public Module ZipFileExtensions
Herança
ZipFileExtensions

Comentários

A ZipFileExtensions classe contém apenas métodos estáticos que estendem as ZipArchive ZipArchiveEntry classes e.The ZipFileExtensions class contains only static methods that extend the ZipArchive and ZipArchiveEntry classes. Você não cria uma instância da ZipFileExtensions classe; em vez disso, você usa esses métodos de instâncias do ZipArchive ou do ZipArchiveEntry .You do not create an instance of the ZipFileExtensions class; instead, you use these methods from instances of ZipArchive or ZipArchiveEntry.

Para usar os métodos de extensão, você deve fazer referência ao System.IO.Compression.FileSystem assembly em seu projeto.To use the extension methods, you must reference the System.IO.Compression.FileSystem assembly in your project. O System.IO.Compression.FileSystem assembly não está disponível nos aplicativos da loja do Windows 8. x.The System.IO.Compression.FileSystem assembly is not available in Windows 8.x Store apps. Portanto, as ZipFileExtensions ZipFile classes e (ambas estão no System.IO.Compression.FileSystem assembly) não estão disponíveis nos aplicativos da loja do Windows 8. x.Therefore, the ZipFileExtensions and ZipFile classes (both of which are in the System.IO.Compression.FileSystem assembly) are not available in Windows 8.x Store apps. Nos aplicativos da loja do Windows 8. x, você trabalha com arquivos compactados usando os métodos em ZipArchive ,, ZipArchiveEntry DeflateStream e GZipStream .In Windows 8.x Store apps, you work with compressed files by using the methods in ZipArchive, ZipArchiveEntry, DeflateStream, and GZipStream.

A ZipFileExtensions classe contém quatro métodos que estendem ZipArchive :The ZipFileExtensions class contains four methods that extend ZipArchive:

A ZipFileExtensions classe contém dois métodos que estendem ZipArchiveEntry :The ZipFileExtensions class contains two methods that extend ZipArchiveEntry:

ExemplosExamples

O exemplo a seguir mostra como criar uma nova entrada em um arquivo zip a partir dos arquivos existentes e extrair o conteúdo do arquivo para um diretório.The following example shows how to create a new entry in a zip archive from an existing file, and extract the contents of the archive to a directory.

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 pelo conteúdo de um arquivo zip e extrair arquivos que têm uma extensão. txt.The following example shows how to iterate through the contents of a zip archive and extract files that have a .txt extension.

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.Archives a file by compressing it and adding it to the zip archive.

CreateEntryFromFile(ZipArchive, String, String, CompressionLevel)

Arquiva um arquivo, compactando-o usando o nível de compactação especificado e adicionando-o ao arquivo zip.Archives a file by compressing it using the specified compression level and adding it to the zip archive.

ExtractToDirectory(ZipArchive, String)

Extrai todos os arquivos no arquivo zip especificado para um diretório do sistema de arquivos.Extracts all the files in the zip archive to a directory on the file system.

ExtractToDirectory(ZipArchive, String, Boolean)

Extrai todos os arquivos dos arquivos para um diretório do sistema de arquivos.Extracts all of the files in the archive to a directory on the file system.

ExtractToFile(ZipArchiveEntry, String)

Extrai uma entrada no arquivo zip para um arquivo.Extracts an entry in the zip archive to a file.

ExtractToFile(ZipArchiveEntry, String, Boolean)

Extrai uma entrada do arquivo zip para um arquivo e, opcionalmente, substitui um arquivo existente que tem o mesmo nome.Extracts an entry in the zip archive to a file, and optionally overwrites an existing file that has the same name.

Aplica-se a