ZipFileExtensions Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Предоставляет методы расширения для классов ZipArchive и ZipArchiveEntry.
public ref class ZipFileExtensions abstract sealed
public static class ZipFileExtensions
type ZipFileExtensions = class
Public Module ZipFileExtensions
- Наследование
-
ZipFileExtensions
Комментарии
Класс ZipFileExtensions содержит только статические методы, расширяющие классы ZipArchive и ZipArchiveEntry . Экземпляр класса не создается ZipFileExtensions ; вместо этого используются эти методы из экземпляров ZipArchive или ZipArchiveEntry.
Чтобы использовать методы расширения, необходимо ссылаться на сборку System.IO.Compression.FileSystem
в проекте. Сборка System.IO.Compression.FileSystem
недоступна в приложениях Магазина Windows 8.x. Поэтому классы ZipFileExtensions и ZipFile (оба из которых находятся в сборкеSystem.IO.Compression.FileSystem
) недоступны в приложениях Магазина Windows 8.x. В приложениях Магазина Windows 8.x вы работаете со сжатыми файлами с помощью методов в ZipArchive, ZipArchiveEntry, DeflateStreamи GZipStream.
Класс ZipFileExtensions содержит четыре метода, расширяющие :ZipArchive
Класс ZipFileExtensions содержит два метода, расширяющих :ZipArchiveEntry
Примеры
В следующем примере показано, как создать запись в ZIP-архиве из существующего файла и извлечь содержимое архива в каталог.
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
В следующем примере показано, как выполнить итерацию содержимого ZIP-архива и извлечь файлы с расширением .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
Методы
CreateEntryFromFile(ZipArchive, String, String) |
Архивирует файл, сжимая его и добавляя его в ZIP-архив. |
CreateEntryFromFile(ZipArchive, String, String, CompressionLevel) |
Архивирует файл, сжимая его с использованием заданного уровня сжатия и добавляя его в ZIP-архив. |
ExtractToDirectory(ZipArchive, String) |
Извлекает все файлы из ZIP-архива в каталог в файловой системе. |
ExtractToDirectory(ZipArchive, String, Boolean) |
Извлекает все файлы в архиве в каталог в файловой системе. |
ExtractToFile(ZipArchiveEntry, String) |
Извлекает запись в ZIP-архиве в файл. |
ExtractToFile(ZipArchiveEntry, String, Boolean) |
Извлекает запись из ZIP-архива в файл и при необходимости перезаписывает существующий файл с тем же именем. |