ZipFileExtensions.ExtractToFile Método

Definição

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

Sobrecargas

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.

ExtractToFile(ZipArchiveEntry, String)

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

public:
[System::Runtime::CompilerServices::Extension]
 static void ExtractToFile(System::IO::Compression::ZipArchiveEntry ^ source, System::String ^ destinationFileName);
public static void ExtractToFile (this System.IO.Compression.ZipArchiveEntry source, string destinationFileName);
static member ExtractToFile : System.IO.Compression.ZipArchiveEntry * string -> unit
<Extension()>
Public Sub ExtractToFile (source As ZipArchiveEntry, destinationFileName As String)

Parâmetros

source
ZipArchiveEntry

A entrada do arquivo zip da qual um arquivo será extraído.The zip archive entry to extract a file from.

destinationFileName
String

O caminho do arquivo a ser criado do conteúdo da entrada.The path of the file to create from the contents of the entry. Você pode especificar um caminho absoluto ou relativo.You can specify either a relative or an absolute path. Um caminho relativo é interpretado como relativo ao diretório de trabalho atual.A relative path is interpreted as relative to the current working directory.

Exceções

destinationFileName é uma cadeia de comprimento zero, contém somente espaços em branco ou um ou mais caracteres inválidos, conforme definido por InvalidPathChars.destinationFileName is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

- ou --or- destinationFileName especifica um diretório.destinationFileName specifies a directory.

destinationFileName é null.destinationFileName is null.

O caminho especificado, o nome de arquivo, ou ambos excedem o tamanho máximo definido pelo sistema.The specified path, file name, or both exceed the system-defined maximum length.

O caminho especificado é inválido (por exemplo, ele está em uma unidade não mapeada).The specified path is invalid (for example, it is on an unmapped drive).

destinationFileName já existe.destinationFileName already exists.

- ou --or- Ocorreu um erro de E/S.An I/O error occurred.

- ou --or- A entrada está aberta para gravação.The entry is currently open for writing.

- ou --or- A entrada foi excluída do arquivo.The entry has been deleted from the archive.

O chamador não tem a permissão necessária para criar o novo arquivo.The caller does not have the required permission to create the new file.

A entrada está ausente do arquivo ou está corrompida e não pode ser lida.The entry is missing from the archive, or is corrupt and cannot be read.

- ou --or-

A entrada foi compactada usando um método de compactação sem suporte.The entry has been compressed by using a compression method that is not supported.

O arquivo zip a que esta entrada pertence foi descartado.The zip archive that this entry belongs to has been disposed.

destinationFileName está em um formato inválido.destinationFileName is in an invalid format.

- ou --or- O arquivo zip desta entrada foi aberto no modo Create, que não permite a recuperação de entradas.The zip archive for this entry was opened in Create mode, which does not permit the retrieval of entries.

Exemplos

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 file 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

Comentários

Se o arquivo de destino já existir, esse método não o substituirá; Ele gera uma IOException exceção.If the destination file already exists, this method does not overwrite it; it throws an IOException exception. Para substituir um arquivo existente, use a ExtractToFile(ZipArchiveEntry, String, Boolean) sobrecarga do método em vez disso.To overwrite an existing file, use the ExtractToFile(ZipArchiveEntry, String, Boolean) method overload instead.

A hora da última gravação do arquivo é definida para a última vez em que a entrada no arquivo zip foi alterada; Esse valor é armazenado na LastWriteTime propriedade.The last write time of the file is set to the last time the entry in the zip archive was changed; this value is stored in the LastWriteTime property.

Você não pode usar esse método para extrair um diretório; ExtractToDirectory em vez disso, use o método.You cannot use this method to extract a directory; use the ExtractToDirectory method instead.

Aplica-se a

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.

public:
[System::Runtime::CompilerServices::Extension]
 static void ExtractToFile(System::IO::Compression::ZipArchiveEntry ^ source, System::String ^ destinationFileName, bool overwrite);
public static void ExtractToFile (this System.IO.Compression.ZipArchiveEntry source, string destinationFileName, bool overwrite);
static member ExtractToFile : System.IO.Compression.ZipArchiveEntry * string * bool -> unit
<Extension()>
Public Sub ExtractToFile (source As ZipArchiveEntry, destinationFileName As String, overwrite As Boolean)

Parâmetros

source
ZipArchiveEntry

A entrada do arquivo zip da qual um arquivo será extraído.The zip archive entry to extract a file from.

destinationFileName
String

O caminho do arquivo a ser criado do conteúdo da entrada.The path of the file to create from the contents of the entry. Você pode especificar um caminho absoluto ou relativo.You can specify either a relative or an absolute path. Um caminho relativo é interpretado como relativo ao diretório de trabalho atual.A relative path is interpreted as relative to the current working directory.

overwrite
Boolean

true para substituir um arquivo existente que tem o mesmo nome do arquivo de destino; caso contrário, false.true to overwrite an existing file that has the same name as the destination file; otherwise, false.

Exceções

destinationFileName é uma cadeia de comprimento zero, contém somente espaços em branco ou um ou mais caracteres inválidos, conforme definido por InvalidPathChars.destinationFileName is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

- ou --or- destinationFileName especifica um diretório.destinationFileName specifies a directory.

destinationFileName é null.destinationFileName is null.

O caminho especificado, o nome de arquivo, ou ambos excedem o tamanho máximo definido pelo sistema.The specified path, file name, or both exceed the system-defined maximum length.

O caminho especificado é inválido (por exemplo, ele está em uma unidade não mapeada).The specified path is invalid (for example, it is on an unmapped drive).

destinationFileName já existe e overwrite é false.destinationFileName already exists and overwrite is false.

- ou --or- Ocorreu um erro de E/S.An I/O error occurred.

- ou --or- A entrada está aberta para gravação.The entry is currently open for writing.

- ou --or- A entrada foi excluída do arquivo.The entry has been deleted from the archive.

O chamador não tem a permissão necessária para criar o novo arquivo.The caller does not have the required permission to create the new file.

A entrada está ausente do arquivo ou está corrompida e não pode ser lida.The entry is missing from the archive or is corrupt and cannot be read.

- ou --or-

A entrada foi compactada usando um método de compactação sem suporte.The entry has been compressed by using a compression method that is not supported.

O arquivo zip a que esta entrada pertence foi descartado.The zip archive that this entry belongs to has been disposed.

destinationFileName está em um formato inválido.destinationFileName is in an invalid format.

- ou --or- O arquivo zip desta entrada foi aberto no modo Create, que não permite a recuperação de entradas.The zip archive for this entry was opened in Create mode, which does not permit the retrieval of entries.

Exemplos

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 file, and extract files that have a .txt extension. Ele substitui um arquivo existente que tem o mesmo nome na pasta de destino.It overwrites an existing file that has the same name in the destination folder. Para o compilador deste exemplo de código, você deve referenciar System.IO.Compression os System.IO.Compression.FileSystem assemblies e em seu projeto.In order to compiler this code example, you must reference the System.IO.Compression and System.IO.Compression.FileSystem assemblies in your project.

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

namespace ConsoleApplication1
{
    class Program
    {
        static void Main(string[] args)
        {
            string zipPath = @"c:\example\start.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))
                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, true);
                    }
                }
            }
        }
    }
}
Imports System.IO
Imports System.IO.Compression

Module Module1

    Sub Main()
        Dim zipPath As String = "c:\example\start.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) 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, true)
                    End If

                End If
            Next
        End Using
    End Sub

End Module

Comentários

A hora da última gravação do arquivo é definida para a última vez em que a entrada no arquivo zip foi alterada; Esse valor é armazenado na LastWriteTime propriedade.The last write time of the file is set to the last time the entry in the zip archive was changed; this value is stored in the LastWriteTime property.

Você não pode usar esse método para extrair um diretório; ExtractToDirectory em vez disso, use o método.You cannot use this method to extract a directory; use the ExtractToDirectory method instead.

Aplica-se a