ZipFile.ExtractToDirectory Método

Origem:

ZipFile.Extract.cs

public:
 static void ExtractToDirectory(System::String ^ sourceArchiveFileName, System::String ^ destinationDirectoryName, System::IO::Compression::ZipExtractionOptions ^ options);

public static void ExtractToDirectory(string sourceArchiveFileName, string destinationDirectoryName, System.IO.Compression.ZipExtractionOptions options);

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

Public Shared Sub ExtractToDirectory (sourceArchiveFileName As String, destinationDirectoryName As String, options As ZipExtractionOptions)

Parâmetros

Observações

O diretório especificado por destinationDirectoryName pode já existir. Este método cria o diretório de destino, os diretórios pais em falta e subdiretórios conforme necessário ao extrair entradas. Se o arquivo estiver vazio, este método não cria o diretório de destino.

Cada ficheiro extraído tem o mesmo caminho relativo a destinationDirectoryName que a sua entrada de origem tem até à raiz do arquivo.

Os sourceArchiveFileName parâmetros e destinationDirectoryName aceitam caminhos relativos e absolutos. Um caminho relativo é interpretado como relativo ao diretório de trabalho atual.

Se ocorrer um erro durante a extração, o arquivo permanece parcialmente extraído.

Definir OverwriteFiles para true sobrescrever ficheiros existentes. O padrão é false, o que faz com que a extração lance um IOException se já existe um ficheiro a extrair.

Use Password para fornecer a palavra-passe para entradas encriptadas.

Use EntryNameEncoding para especificar a codificação dos nomes das entradas e comentários ao abrir o arquivo. Para detalhes sobre como esta codificação é utilizada, veja ZipArchive(Stream, ZipArchiveMode, Boolean, Encoding).

Os links simbólicos no arquivo não são recriados como links simbólicos. Se destinationDirectoryName ou qualquer um dos seus diretórios-pai for uma junção ou ligação simbólica pré-existente, a ligação é seguida e a extração escreve na pasta de destino final.

Origem:

ZipFile.Extract.cs

Origem:

ZipFile.Extract.cs

Origem:

ZipFile.Extract.cs

Origem:

ZipFile.Extract.cs

Origem:

ZipFile.Extract.cs

public:
 static void ExtractToDirectory(System::String ^ sourceArchiveFileName, System::String ^ destinationDirectoryName, System::Text::Encoding ^ entryNameEncoding, bool overwriteFiles);

public static void ExtractToDirectory(string sourceArchiveFileName, string destinationDirectoryName, System.Text.Encoding? entryNameEncoding, bool overwriteFiles);

static member ExtractToDirectory : string * string * System.Text.Encoding * bool -> unit

Public Shared Sub ExtractToDirectory (sourceArchiveFileName As String, destinationDirectoryName As String, entryNameEncoding As Encoding, overwriteFiles As Boolean)

Parâmetros

Exceções

Observações

O diretório especificado por destinationDirectoryName pode já existir. Este método cria o diretório de destino, os diretórios pais em falta e subdiretórios conforme necessário ao extrair entradas. Se o arquivo estiver vazio, este método não cria o diretório de destino.

Se houver um erro durante a extração do arquivo, este permanecerá parcialmente extraído.

Cada entrada será extraída de modo que o ficheiro extraído tenha o mesmo caminho relativo para o destinationDirectoryName que a entrada tem para o arquivo.

Os sourceArchiveFileName parâmetros e destinationDirectoryName aceitam tanto caminhos relativos como absolutos. Um caminho relativo é interpretado como relativo ao diretório de trabalho atual.

Se uma entrada no arquivo postal for um link simbólico, é extraído como uma pasta normal, já que a informação do link simbólico não é preservada no formato ZIP. Se destinationDirectoryName ou qualquer um dos seus diretórios-pais for uma junção ou ligação simbólica pré-existente, a ligação é seguida e a extração escreve na pasta de destino final.

Se um ficheiro a ser arquivado tiver uma última hora modificada inválida, a primeira data e hora representáveis no formato de carimbo postal (meia-noite de 1 de janeiro de 1980) serão usadas.

Origem:

ZipFile.Extract.cs

Origem:

ZipFile.Extract.cs

Origem:

ZipFile.Extract.cs

Origem:

ZipFile.Extract.cs

public:
 static void ExtractToDirectory(System::IO::Stream ^ source, System::String ^ destinationDirectoryName, System::Text::Encoding ^ entryNameEncoding, bool overwriteFiles);

public static void ExtractToDirectory(System.IO.Stream source, string destinationDirectoryName, System.Text.Encoding? entryNameEncoding, bool overwriteFiles);

static member ExtractToDirectory : System.IO.Stream * string * System.Text.Encoding * bool -> unit

Public Shared Sub ExtractToDirectory (source As Stream, destinationDirectoryName As String, entryNameEncoding As Encoding, overwriteFiles As Boolean)

Parâmetros

Exceções

Observações

O diretório especificado por destinationDirectoryName pode já existir. Este método cria o diretório de destino, os diretórios pais em falta e subdiretórios conforme necessário ao extrair entradas. Se o arquivo estiver vazio, este método não cria o diretório de destino.

Exceções relacionadas com a validação dos caminhos no destinationDirectoryName ou dos ficheiros no arquivo zip contidos nos source parâmetros são lançadas antes da extração. Caso contrário, se ocorrer um erro durante a extração, o arquivo permanece parcialmente extraído. Cada ficheiro extraído tem o mesmo caminho relativo para o diretório especificado por destinationDirectoryName que a sua entrada de origem tem para a raiz do arquivo.

Se uma entrada no arquivo postal for um link simbólico, é extraído como uma pasta normal, já que a informação do link simbólico não é preservada no formato ZIP. Se destinationDirectoryName ou qualquer um dos seus diretórios-pais for uma junção ou ligação simbólica pré-existente, a ligação é seguida e a extração escreve na pasta de destino final.

Se um ficheiro a ser arquivado tiver uma última hora modificada inválida, a primeira data e hora representáveis no formato de carimbo postal (meia-noite de 1 de janeiro de 1980) serão usadas.

Origem:

ZipFile.Extract.cs

Origem:

ZipFile.Extract.cs

Origem:

ZipFile.Extract.cs

Origem:

ZipFile.Extract.cs

Origem:

ZipFile.Extract.cs

public:
 static void ExtractToDirectory(System::String ^ sourceArchiveFileName, System::String ^ destinationDirectoryName, System::Text::Encoding ^ entryNameEncoding);

public static void ExtractToDirectory(string sourceArchiveFileName, string destinationDirectoryName, System.Text.Encoding? entryNameEncoding);

public static void ExtractToDirectory(string sourceArchiveFileName, string destinationDirectoryName, System.Text.Encoding entryNameEncoding);

static member ExtractToDirectory : string * string * System.Text.Encoding -> unit

Public Shared Sub ExtractToDirectory (sourceArchiveFileName As String, destinationDirectoryName As String, entryNameEncoding As Encoding)

Parâmetros

Exceções

Observações

O diretório especificado por destinationDirectoryName pode já existir. Este método cria o diretório de destino, os diretórios pais em falta e subdiretórios conforme necessário ao extrair entradas. Se o arquivo estiver vazio, este método não cria o diretório de destino.

Exceções relacionadas com a validação dos caminhos nos destinationDirectoryName parâmetros ou sourceArchiveFileName são lançadas antes da extração. Caso contrário, se ocorrer um erro durante a extração, o arquivo permanece parcialmente extraído. Cada ficheiro extraído tem o mesmo caminho relativo para o diretório especificado por destinationDirectoryName que a sua entrada de origem tem para a raiz do arquivo.

Se uma entrada no arquivo postal for um link simbólico, é extraído como uma pasta normal, já que a informação do link simbólico não é preservada no formato ZIP. Se destinationDirectoryName ou qualquer um dos seus diretórios-pais for uma junção ou ligação simbólica pré-existente, a ligação é seguida e a extração escreve na pasta de destino final.

Se entryNameEncoding for definido para um valor diferente de null, os nomes das entradas e os comentários são decodificados de acordo com as seguintes regras:

• Para entradas onde o flag de codificação da linguagem (no flag de bit de uso geral do cabeçalho local do ficheiro) não está definido, os nomes das entradas e comentários são decodificados usando a codificação especificada.
• Para entradas onde o flag de codificação da linguagem está definido, os nomes das entradas e comentários são decodificados usando UTF-8.

Se entryNameEncoding for definido para null, os nomes das entradas e os comentários são decodificados de acordo com as seguintes regras:

• Para entradas onde o flag de codificação da linguagem (no flag de bit de uso geral do cabeçalho local do ficheiro) não está definido, os nomes das entradas e comentários são descodificados usando a página de código padrão do sistema atual.
• Para entradas onde o flag de codificação da linguagem está definido, os nomes das entradas e comentários são decodificados usando UTF-8.

Origem:

ZipFile.Extract.cs

Origem:

ZipFile.Extract.cs

Origem:

ZipFile.Extract.cs

Origem:

ZipFile.Extract.cs

Origem:

ZipFile.Extract.cs

public:
 static void ExtractToDirectory(System::String ^ sourceArchiveFileName, System::String ^ destinationDirectoryName, bool overwriteFiles);

public static void ExtractToDirectory(string sourceArchiveFileName, string destinationDirectoryName, bool overwriteFiles);

static member ExtractToDirectory : string * string * bool -> unit

Public Shared Sub ExtractToDirectory (sourceArchiveFileName As String, destinationDirectoryName As String, overwriteFiles As Boolean)

Parâmetros

Exceções

Observações

O diretório especificado por destinationDirectoryName pode já existir. Este método cria o diretório de destino, os diretórios pais em falta e subdiretórios conforme necessário ao extrair entradas. Se o arquivo estiver vazio, este método não cria o diretório de destino.

Se houver um erro durante a extração do arquivo, este permanecerá parcialmente extraído.

Cada entrada será extraída de modo que o ficheiro extraído tenha o mesmo caminho relativo para o destinationDirectoryName que a entrada tem para o arquivo.

Os sourceArchiveFileName parâmetros e destinationDirectoryName aceitam tanto caminhos relativos como absolutos. Um caminho relativo é interpretado como relativo ao diretório de trabalho atual.

Se uma entrada no arquivo postal for um link simbólico, é extraído como uma pasta normal, já que a informação do link simbólico não é preservada no formato ZIP. Se destinationDirectoryName ou qualquer um dos seus diretórios-pais for uma junção ou ligação simbólica pré-existente, a ligação é seguida e a extração escreve na pasta de destino final.

Se um ficheiro a ser arquivado tiver uma última hora modificada inválida, a primeira data e hora representáveis no formato de carimbo postal (meia-noite de 1 de janeiro de 1980) serão usadas.

Origem:

ZipFile.Extract.cs

Origem:

ZipFile.Extract.cs

Origem:

ZipFile.Extract.cs

Origem:

ZipFile.Extract.cs

public:
 static void ExtractToDirectory(System::IO::Stream ^ source, System::String ^ destinationDirectoryName, System::Text::Encoding ^ entryNameEncoding);

public static void ExtractToDirectory(System.IO.Stream source, string destinationDirectoryName, System.Text.Encoding? entryNameEncoding);

static member ExtractToDirectory : System.IO.Stream * string * System.Text.Encoding -> unit

Public Shared Sub ExtractToDirectory (source As Stream, destinationDirectoryName As String, entryNameEncoding As Encoding)

Parâmetros

Exceções

Observações

O diretório especificado por destinationDirectoryName pode já existir. Este método cria o diretório de destino, os diretórios pais em falta e subdiretórios conforme necessário ao extrair entradas. Se o arquivo estiver vazio, este método não cria o diretório de destino.

Exceções relacionadas com a validação dos caminhos no destinationDirectoryName ou dos ficheiros no arquivo zip contidos nos source parâmetros são lançadas antes da extração. Caso contrário, se ocorrer um erro durante a extração, o arquivo permanece parcialmente extraído. Cada ficheiro extraído tem o mesmo caminho relativo para o diretório especificado por destinationDirectoryName que a sua entrada de origem tem para a raiz do arquivo.

Se um ficheiro a ser arquivado tiver uma última hora modificada inválida, a primeira data e hora representáveis no formato de carimbo postal (meia-noite de 1 de janeiro de 1980) serão usadas.

Origem:

ZipFile.Extract.cs

public:
 static void ExtractToDirectory(System::IO::Stream ^ source, System::String ^ destinationDirectoryName, System::IO::Compression::ZipExtractionOptions ^ options);

public static void ExtractToDirectory(System.IO.Stream source, string destinationDirectoryName, System.IO.Compression.ZipExtractionOptions options);

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

Public Shared Sub ExtractToDirectory (source As Stream, destinationDirectoryName As String, options As ZipExtractionOptions)

Parâmetros

Observações

O diretório especificado por destinationDirectoryName pode já existir. Este método cria o diretório de destino, os diretórios pais em falta e subdiretórios conforme necessário ao extrair entradas. Se o arquivo estiver vazio, este método não cria o diretório de destino.

Cada ficheiro extraído tem o mesmo caminho relativo a destinationDirectoryName que a sua entrada de origem tem até à raiz do arquivo.

O destinationDirectoryName parâmetro aceita caminhos relativos e absolutos. Um caminho relativo é interpretado como relativo ao diretório de trabalho atual.

Se ocorrer um erro durante a extração, o arquivo permanece parcialmente extraído.

Definir OverwriteFiles para true sobrescrever ficheiros existentes. O padrão é false, o que faz com que a extração lance um IOException se já existe um ficheiro a extrair.

Use Password para fornecer a palavra-passe para entradas encriptadas.

Use EntryNameEncoding para especificar a codificação dos nomes das entradas e comentários ao abrir o arquivo. Para detalhes sobre como esta codificação é utilizada, veja ZipArchive(Stream, ZipArchiveMode, Boolean, Encoding).

Os links simbólicos no arquivo não são recriados como links simbólicos. Se destinationDirectoryName ou qualquer um dos seus diretórios-pai for uma junção ou ligação simbólica pré-existente, a ligação é seguida e a extração escreve na pasta de destino final.

O source riacho fica aberto após a extração.

Origem:

ZipFile.Extract.cs

Origem:

ZipFile.Extract.cs

Origem:

ZipFile.Extract.cs

Origem:

ZipFile.Extract.cs

public:
 static void ExtractToDirectory(System::IO::Stream ^ source, System::String ^ destinationDirectoryName, bool overwriteFiles);

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

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

Public Shared Sub ExtractToDirectory (source As Stream, destinationDirectoryName As String, overwriteFiles As Boolean)

Parâmetros

Exceções

Observações

O diretório especificado por destinationDirectoryName pode já existir. Este método cria o diretório de destino, os diretórios pais em falta e subdiretórios conforme necessário ao extrair entradas. Se o arquivo estiver vazio, este método não cria o diretório de destino.

Exceções relacionadas com a validação dos caminhos no destinationDirectoryName ou dos ficheiros no arquivo zip contidos nos source parâmetros são lançadas antes da extração. Caso contrário, se ocorrer um erro durante a extração, o arquivo permanece parcialmente extraído. Cada ficheiro extraído tem o mesmo caminho relativo para o diretório especificado por destinationDirectoryName que a sua entrada de origem tem para a raiz do arquivo.

Se uma entrada no arquivo postal for um link simbólico, é extraído como uma pasta normal, já que a informação do link simbólico não é preservada no formato ZIP. Se destinationDirectoryName ou qualquer um dos seus diretórios-pais for uma junção ou ligação simbólica pré-existente, a ligação é seguida e a extração escreve na pasta de destino final.

Se um ficheiro a ser arquivado tiver uma última hora modificada inválida, a primeira data e hora representáveis no formato de carimbo postal (meia-noite de 1 de janeiro de 1980) serão usadas.

Origem:

ZipFile.Extract.cs

Origem:

ZipFile.Extract.cs

Origem:

ZipFile.Extract.cs

Origem:

ZipFile.Extract.cs

Origem:

ZipFile.Extract.cs

public:
 static void ExtractToDirectory(System::String ^ sourceArchiveFileName, System::String ^ destinationDirectoryName);

public static void ExtractToDirectory(string sourceArchiveFileName, string destinationDirectoryName);

static member ExtractToDirectory : string * string -> unit

Public Shared Sub ExtractToDirectory (sourceArchiveFileName As String, destinationDirectoryName As String)

Parâmetros

Exceções

Exemplos

Este exemplo mostra como criar e extrair um arquivo zip usando a ZipFile classe. Comprime o conteúdo de uma pasta num arquivo zip e extrai esse conteúdo para uma nova pasta. Para usar a ZipFile classe, tens de referenciar a System.IO.Compression.FileSystem montagem no teu projeto.

using System;
using System.IO.Compression;

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

        ZipFile.CreateFromDirectory(startPath, zipPath);

        ZipFile.ExtractToDirectory(zipPath, extractPath);
    }
}

open System.IO.Compression

let startPath = @".\start"
let zipPath = @".\result.zip"
let extractPath = @".\extract"

ZipFile.CreateFromDirectory(startPath, zipPath)

ZipFile.ExtractToDirectory(zipPath, extractPath)

Imports System.IO.Compression

Module Module1

    Sub Main()
        Dim startPath As String = ".\start"
        Dim zipPath As String = ".\result.zip"
        Dim extractPath As String = ".\extract"

        ZipFile.CreateFromDirectory(startPath, zipPath)

        ZipFile.ExtractToDirectory(zipPath, extractPath)
    End Sub

End Module

Observações

O diretório especificado por destinationDirectoryName pode já existir. Este método cria o diretório de destino, os diretórios pais em falta e subdiretórios conforme necessário ao extrair entradas. Se o arquivo estiver vazio, este método não cria o diretório de destino.

Exceções relacionadas com a validação dos caminhos nos destinationDirectoryName parâmetros ou sourceArchiveFileName são lançadas antes da extração. Caso contrário, se ocorrer um erro durante a extração, o arquivo permanece parcialmente extraído. Cada ficheiro extraído tem o mesmo caminho relativo para o diretório especificado por destinationDirectoryName que a sua entrada de origem tem para a raiz do arquivo.

Se uma entrada no arquivo postal for um link simbólico, é extraído como uma pasta normal, já que a informação do link simbólico não é preservada no formato ZIP. Se destinationDirectoryName ou qualquer um dos seus diretórios-pais for uma junção ou ligação simbólica pré-existente, a ligação é seguida e a extração escreve na pasta de destino final.

Origem:

ZipFile.Extract.cs

Origem:

ZipFile.Extract.cs

Origem:

ZipFile.Extract.cs

Origem:

ZipFile.Extract.cs

public:
 static void ExtractToDirectory(System::IO::Stream ^ source, System::String ^ destinationDirectoryName);

public static void ExtractToDirectory(System.IO.Stream source, string destinationDirectoryName);

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

Public Shared Sub ExtractToDirectory (source As Stream, destinationDirectoryName As String)

Parâmetros

Exceções

Observações

O diretório especificado por destinationDirectoryName pode já existir. Este método cria o diretório de destino, os diretórios pais em falta e subdiretórios conforme necessário ao extrair entradas. Se o arquivo estiver vazio, este método não cria o diretório de destino.

Exceções relacionadas com a validação dos caminhos no destinationDirectoryName ou dos ficheiros no arquivo zip contidos nos source parâmetros são lançadas antes da extração. Caso contrário, se ocorrer um erro durante a extração, o arquivo permanece parcialmente extraído. Cada ficheiro extraído tem o mesmo caminho relativo para o diretório especificado por destinationDirectoryName que a sua entrada de origem tem para a raiz do arquivo.

Se uma entrada no arquivo postal for um link simbólico, é extraído como uma pasta normal, já que a informação do link simbólico não é preservada no formato ZIP. Se destinationDirectoryName ou qualquer um dos seus diretórios-pais for uma junção ou ligação simbólica pré-existente, a ligação é seguida e a extração escreve na pasta de destino final.

Se um ficheiro a ser arquivado tiver uma última hora modificada inválida, a primeira data e hora representáveis no formato de carimbo postal (meia-noite de 1 de janeiro de 1980) serão usadas.