ZipFileExtensions.ExtractToDirectory Método

Definição

Namespace:

System.IO.Compression

Assembly:

System.IO.Compression.ZipFile.dll

Sobrecargas

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.

ExtractToDirectory(ZipArchive, String)

Origem:

ZipFileExtensions.ZipArchive.Extract.cs

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

public:
[System::Runtime::CompilerServices::Extension]
 static void ExtractToDirectory(System::IO::Compression::ZipArchive ^ source, System::String ^ destinationDirectoryName);

public static void ExtractToDirectory (this System.IO.Compression.ZipArchive source, string destinationDirectoryName);

static member ExtractToDirectory : System.IO.Compression.ZipArchive * string -> unit

<Extension()>
Public Sub ExtractToDirectory (source As ZipArchive, destinationDirectoryName As String)

Parâmetros

source

ZipArchive

O arquivo zip de onde extrair os arquivos.

destinationDirectoryName

String

O caminho para o diretório para colocar os arquivos extraídos. Você pode especificar um caminho absoluto ou relativo. Um caminho relativo é interpretado como relativo ao diretório de trabalho atual.

Exceções

ArgumentException

destinationDirectoryName é Empty, contém somente espaços em branco ou, pelo menos, um caractere inválido.

ArgumentNullException

destinationDirectoryName é null.

PathTooLongException

O caminho especificado excede o tamanho máximo definido pelo sistema.

DirectoryNotFoundException

O caminho especificado é inválido (por exemplo, ele está em uma unidade não mapeada).

IOException

O nome de uma entrada no arquivo morto é Empty, contém somente espaços em branco ou, pelo menos, um caractere inválido.

- ou -

A extração de uma entrada do arquivo criará um arquivo que está fora do diretório especificado por destinationDirectoryName. (Por exemplo, isso poderá acontecer se o nome da entrada contiver acessadores de diretório pai.)

- ou -

Duas ou mais entradas no arquivo tem o mesmo nome.

UnauthorizedAccessException

O chamador não tem a permissão necessária para acessar o arquivo ou o diretório de destino.

NotSupportedException

destinationDirectoryName contém um formato inválido.

InvalidDataException

Uma entrada de arquivo não pode ser encontrada ou está corrompida.

- ou -

Uma entrada de arquivo morto foi compactada usando um método de compactação sem suporte.

Exemplos

O exemplo a seguir mostra como criar uma nova entrada em um arquivo zip de um arquivo existente e extrair o arquivo para um novo 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

Comentários

Esse método cria o diretório especificado por destinationDirectoryName. O método também cria subdiretórios que refletem a hierarquia no arquivo zip. Se ocorrer um erro durante a extração, o arquivo morto permanecerá parcialmente extraído. Cada arquivo extraído tem o mesmo caminho relativo para o diretório especificado por destinationDirectoryName como sua entrada de origem tem para a raiz do arquivo morto.

ExtractToDirectory(ZipArchive, String, Boolean)

Origem:

ZipFileExtensions.ZipArchive.Extract.cs

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

public:
[System::Runtime::CompilerServices::Extension]
 static void ExtractToDirectory(System::IO::Compression::ZipArchive ^ source, System::String ^ destinationDirectoryName, bool overwriteFiles);

public static void ExtractToDirectory (this System.IO.Compression.ZipArchive source, string destinationDirectoryName, bool overwriteFiles);

static member ExtractToDirectory : System.IO.Compression.ZipArchive * string * bool -> unit

<Extension()>
Public Sub ExtractToDirectory (source As ZipArchive, destinationDirectoryName As String, overwriteFiles As Boolean)

Parâmetros

source

ZipArchive

O ZipArchive a ser extraído.

destinationDirectoryName

String

O caminho para o diretório de destino no sistema de arquivos. O caminho pode ser relativo ou absoluto. Um caminho relativo é interpretado como relativo ao diretório de trabalho atual.

overwriteFiles

Boolean

true para substituir arquivos existentes; false Caso contrário.

Exceções

ArgumentException

destinationArchiveFileName é uma cadeia de comprimento zero, contém somente espaço em branco ou um ou mais caracteres inválidos, conforme definido por InvalidPathChars.

ArgumentNullException

destinationArchiveFileName é null.

PathTooLongException

O caminho especificado, o nome de arquivo, ou ambos excedem o tamanho máximo definido pelo sistema.

DirectoryNotFoundException

O caminho especificado é inválido (por exemplo, ele está em uma unidade não mapeada).

IOException

O nome de uma ZipArchiveEntry é uma cadeia de comprimento zero, contém somente espaço em branco ou contém um ou mais caracteres inválidos, conforme definido por InvalidPathChars.

- ou -

A extração de uma ZipArchiveEntry resulta em um arquivo de destino que está fora de destinationArchiveFileName (por exemplo, se o nome da entrada contém acessadores de diretório pai).

- ou -

Uma ZipArchiveEntry tem o mesmo nome de uma entrada já extraída dos mesmos arquivos.

UnauthorizedAccessException

O chamador não tem a permissão necessária.

NotSupportedException

destinationArchiveFileName está em um formato inválido.

InvalidDataException

Uma ZipArchiveEntry não foi encontrada ou estava corrompida.

- ou -

Uma ZipArchiveEntry foi compactada usando um método de compactação sem suporte.

Comentários

O diretório especificado já pode existir. Esse método cria o diretório especificado e todos os subdiretórios, se necessário.

Se houver um erro ao extrair o arquivo morto, o arquivo permanecerá parcialmente extraído.

Cada entrada é extraída de modo que o arquivo extraído tenha o mesmo caminho relativo para destinationDirectoryName que a entrada tenha para a raiz do arquivo morto.

Se um arquivo a ser arquivado tiver uma hora da última modificação inválida, a primeira data e hora representáveis no formato de carimbo de data/hora zip (meia-noite de 1º de janeiro de 1980) será usada.