ZipFileExtensions Classe
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.
Fornece métodos de extensão para as classes e ZipArchive as ZipArchiveEntry classes.
public ref class ZipFileExtensions abstract sealed
public static class ZipFileExtensions
type ZipFileExtensions = class
Public Module ZipFileExtensions
- Herança
-
ZipFileExtensions
Exemplos
O exemplo a seguir mostra como criar uma nova entrada em um arquivo zip de um arquivo existente e extrair o conteúdo do arquivo morto para um 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
O exemplo a seguir mostra como iterar por meio do 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
A ZipFileExtensions classe contém quatro métodos que estendem ZipArchive:
- CreateEntryFromFile(ZipArchive, String, String)
- CreateEntryFromFile(ZipArchive, String, String, CompressionLevel)
- ExtractToDirectory(ZipArchive, String)
- ExtractToDirectory(ZipArchive, String, Boolean)
A ZipFileExtensions classe contém dois métodos que estendem ZipArchiveEntry:
Métodos
| Nome | Description |
|---|---|
| CreateEntryFromFile(ZipArchive, String, String, CompressionLevel, ReadOnlySpan<Char>, ZipEncryptionMethod) |
Fornece métodos de extensão para as classes e ZipArchive as ZipArchiveEntry classes. |
| CreateEntryFromFile(ZipArchive, String, String, CompressionLevel) |
Arquiva um arquivo compactando-o usando o nível de compactação especificado e adicionando-o ao arquivo zip. |
| CreateEntryFromFile(ZipArchive, String, String, ReadOnlySpan<Char>, ZipEncryptionMethod) |
Fornece métodos de extensão para as classes e ZipArchive as ZipArchiveEntry classes. |
| CreateEntryFromFile(ZipArchive, String, String) |
Arquiva um arquivo compactando-o e adicionando-o ao arquivo zip. |
| CreateEntryFromFileAsync(ZipArchive, String, String, CancellationToken) |
Adiciona de forma assíncrona um arquivo do sistema de arquivos ao arquivo morto sob o nome de entrada especificado. |
| CreateEntryFromFileAsync(ZipArchive, String, String, CompressionLevel, CancellationToken) |
Adiciona de forma assíncrona um arquivo do sistema de arquivos ao arquivo morto sob o nome de entrada especificado. |
| CreateEntryFromFileAsync(ZipArchive, String, String, CompressionLevel, ReadOnlyMemory<Char>, ZipEncryptionMethod, CancellationToken) |
Fornece métodos de extensão para as classes e ZipArchive as ZipArchiveEntry classes. |
| CreateEntryFromFileAsync(ZipArchive, String, String, ReadOnlyMemory<Char>, ZipEncryptionMethod, CancellationToken) |
Fornece métodos de extensão para as classes e ZipArchive as ZipArchiveEntry classes. |
| ExtractToDirectory(ZipArchive, String, Boolean) |
Extrai todos os arquivos no arquivo morto para um diretório no sistema de arquivos. |
| ExtractToDirectory(ZipArchive, String, ZipExtractionOptions) |
Fornece métodos de extensão para as classes e ZipArchive as ZipArchiveEntry classes. |
| ExtractToDirectory(ZipArchive, String) |
Extrai todos os arquivos no arquivo zip para um diretório no sistema de arquivos. |
| ExtractToDirectoryAsync(ZipArchive, String, Boolean, CancellationToken) |
Extrai todos os arquivos no arquivo morto para um diretório no sistema de arquivos. O diretório especificado já pode existir. |
| ExtractToDirectoryAsync(ZipArchive, String, CancellationToken) |
Extrai de forma assíncrona todos os arquivos no arquivo morto para um diretório no sistema de arquivos. O diretório especificado já pode existir. |
| ExtractToDirectoryAsync(ZipArchive, String, ZipExtractionOptions, CancellationToken) |
Fornece métodos de extensão para as classes e ZipArchive as ZipArchiveEntry classes. |
| ExtractToFile(ZipArchiveEntry, String, Boolean) |
Extrai uma entrada no arquivo zip para um arquivo e, opcionalmente, substitui um arquivo existente com o mesmo nome. |
| ExtractToFile(ZipArchiveEntry, String, ZipExtractionOptions) |
Fornece métodos de extensão para as classes e ZipArchive as ZipArchiveEntry classes. |
| ExtractToFile(ZipArchiveEntry, String) |
Extrai uma entrada no arquivo zip para um arquivo. |
| ExtractToFileAsync(ZipArchiveEntry, String, Boolean, CancellationToken) |
Cria de forma assíncrona um arquivo no sistema de arquivos com o conteúdo da entrada e o nome especificado. |
| ExtractToFileAsync(ZipArchiveEntry, String, CancellationToken) |
Cria de forma assíncrona um arquivo no sistema de arquivos com o conteúdo da entrada e o nome especificado. |
| ExtractToFileAsync(ZipArchiveEntry, String, ZipExtractionOptions, CancellationToken) |
Fornece métodos de extensão para as classes e ZipArchive as ZipArchiveEntry classes. |