ZipFileExtensions.ExtractToFile Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Extrai uma entrada no arquivo zip para um arquivo.
Sobrecargas
| 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. |
ExtractToFile(ZipArchiveEntry, String)
Extrai uma entrada no arquivo zip para um arquivo.
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.
- destinationFileName
- String
O caminho do arquivo a ser criado do conteúdo da entrada. Você pode especificar um caminho absoluto ou relativo. Um caminho relativo é interpretado como relativo ao diretório de trabalho atual.
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.
- ou -
destinationFileName especifica um diretório.
destinationFileName é null.
O caminho especificado, o nome de arquivo, ou ambos excedem o tamanho máximo definido pelo sistema.
O caminho especificado é inválido (por exemplo, ele está em uma unidade não mapeada).
destinationFileName já existe.
- ou -
Ocorreu um erro de E/S.
- ou -
A entrada está aberta para gravação.
- ou -
A entrada foi excluída do arquivo.
O chamador não tem a permissão necessária para criar o novo arquivo.
A entrada está ausente do arquivo ou está corrompida e não pode ser lida.
- ou -
A entrada foi compactada usando um método de compactação sem suporte.
O arquivo zip a que esta entrada pertence foi descartado.
destinationFileName está em um formato inválido.
- ou -
O arquivo zip desta entrada foi aberto no modo Create, que não permite a recuperação de entradas.
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.
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á; gera uma exceção IOException . Para substituir um arquivo existente, use a sobrecarga do ExtractToFile(ZipArchiveEntry, String, Boolean) método.
A hora da última gravação do arquivo é definida como a última vez em que a entrada no arquivo zip foi alterada; esse valor é armazenado na LastWriteTime propriedade .
Você não pode usar esse método para extrair um diretório; em vez disso, use o ExtractToDirectory método .
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.
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.
- destinationFileName
- String
O caminho do arquivo a ser criado do conteúdo da entrada. Você pode especificar um caminho absoluto ou relativo. Um caminho relativo é interpretado como relativo ao diretório de trabalho atual.
- overwrite
- Boolean
true para substituir um arquivo existente que tem o mesmo nome do arquivo de destino; caso contrário, 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.
- ou -
destinationFileName especifica um diretório.
destinationFileName é null.
O caminho especificado, o nome de arquivo, ou ambos excedem o tamanho máximo definido pelo sistema.
O caminho especificado é inválido (por exemplo, ele está em uma unidade não mapeada).
destinationFileName já existe e overwrite é false.
- ou -
Ocorreu um erro de E/S.
- ou -
A entrada está aberta para gravação.
- ou -
A entrada foi excluída do arquivo.
O chamador não tem a permissão necessária para criar o novo arquivo.
A entrada está ausente do arquivo ou está corrompida e não pode ser lida.
- ou -
A entrada foi compactada usando um método de compactação sem suporte.
O arquivo zip a que esta entrada pertence foi descartado.
destinationFileName está em um formato inválido.
- ou -
O arquivo zip desta entrada foi aberto no modo Create, que não permite a recuperação de entradas.
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. Ele substitui um arquivo existente que tem o mesmo nome na pasta de destino. Para compilar esse exemplo de código, você deve referenciar os System.IO.Compression assemblies e System.IO.Compression.FileSystem em seu projeto.
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 como a última vez em que a entrada no arquivo zip foi alterada; esse valor é armazenado na LastWriteTime propriedade .
Você não pode usar esse método para extrair um diretório; em vez disso, use o ExtractToDirectory método .
Aplica-se a
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de