Class ZArchive
Namespace: Aspose.Zip.Z
Assembly: Aspose.Zip.dll (25.1.0)
Этот класс представляет файл архива Z (сжатие). Используйте его для создания или извлечения архивов Z.
public class ZArchive : IArchive, IDisposable, IArchiveFileEntry
Наследование
Реализует
IArchive, IDisposable, IArchiveFileEntry
Унаследованные члены
object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
Замечания
Смотрите https://docs.fileformat.com/compression/z/
Конструкторы
ZArchive()
Инициализирует новый экземпляр класса Aspose.Zip.Z.ZArchive, подготовленный для сжатия.
public ZArchive()
ZArchive(Stream, ZArchiveLoadOptions)
Инициализирует новый экземпляр класса Aspose.Zip.Z.ZArchive, подготовленный для распаковки.
public ZArchive(Stream source, ZArchiveLoadOptions loadOptions = null)
Параметры
source
Stream
Источник архива.
loadOptions
ZArchiveLoadOptions
Опции для загрузки архива.
Замечания
Этот конструктор не распаковывает. Смотрите метод Aspose.Zip.Z.ZArchive.Extract(System.IO.Stream) для распаковки.
Исключения
source
не поддерживает поиск.
source
равен null.
ZArchive(string, ZArchiveLoadOptions)
Инициализирует новый экземпляр класса Aspose.Zip.Z.ZArchive, подготовленный для распаковки.
public ZArchive(string path, ZArchiveLoadOptions loadOptions = null)
Параметры
path
string
Путь к источнику архива.
loadOptions
ZArchiveLoadOptions
Опции для загрузки архива.
Замечания
Этот конструктор не распаковывает. Смотрите метод Aspose.Zip.Z.ZArchive.Extract(System.IO.Stream) для распаковки.
Исключения
path
равен null.
У вызывающего нет необходимых разрешений для доступа.
path
пуст, содержит только пробелы или содержит недопустимые символы.
Доступ к файлу path
запрещен.
Указанный path
, имя файла или оба превышают максимальную длину, определенную системой. Например, на платформах Windows пути должны быть короче 248 символов, а имена файлов — короче 260 символов.
Файл по path
содержит двоеточие (:) в середине строки.
Файл не найден.
Указанный путь недействителен, например, находится на неотображаемом диске.
Файл уже открыт.
Методы
Dispose()
Выполняет определенные приложением задачи, связанные с освобождением, освобождением или сбросом неуправляемых ресурсов.
public void Dispose()
Dispose(bool)
Выполняет определенные приложением задачи, связанные с освобождением, освобождением или сбросом неуправляемых ресурсов.
protected virtual void Dispose(bool disposing)
Параметры
disposing
bool
Должны ли управляемые ресурсы быть освобождены.
Extract(Stream)
Извлекает архив Z в поток.
public void Extract(Stream destination)
Параметры
destination
Stream
Поток для хранения распакованных данных.
Примеры
using (FileStream zFile = File.Open(sourceFileName, FileMode.Open))
{
using (FileStream extractedFile = File.Open(extractedFileName, FileMode.Create))
{
using (var archive = new ZArchive(zFile))
{
archive.Extract(extractedFile);
}
}
}
Исключения
Данные не могут быть распакованы.
Extract(FileInfo)
Извлекает архив Z в файл.
public void Extract(FileInfo fileInfo)
Параметры
fileInfo
FileInfo
FileInfo для хранения распакованных данных.
Примеры
using (FileStream zFile = File.Open(sourceFileName, FileMode.Open))
{
using (var archive = new ZArchive(zFile))
{
archive.Extract(new FileInfo("extracted.bin"));
}
}
Исключения
У вызывающего нет необходимых разрешений для открытия fileInfo
.
Путь к файлу пуст или содержит только пробелы.
Файл не найден.
Путь к файлу является доступным только для чтения или является каталогом.
fileInfo
равен null.
Указанный путь недействителен, например, находится на неотображаемом диске.
Файл уже открыт.
Данные не могут быть распакованы.
Extract(string)
Извлекает архив Z в файл по указанному пути.
public FileInfo Extract(string path)
Параметры
path
string
Путь к файлу, который будет хранить распакованные данные.
Возвращает
Информация о извлеченном файле.
Примеры
using (FileStream zFile = File.Open(sourceFileName, FileMode.Open))
{
using (var archive = new ZArchive(zFile))
{
archive.Extract("extracted.bin");
}
}
Исключения
path
равен null.
У вызывающего нет необходимых разрешений для доступа.
path
пуст, содержит только пробелы или содержит недопустимые символы.
Доступ к файлу path
запрещен.
Указанный path
, имя файла или оба превышают максимальную длину, определенную системой. Например, на платформах Windows пути должны быть короче 248 символов, а имена файлов — короче 260 символов.
Файл по path
содержит двоеточие (:) в середине строки.
Данные не могут быть распакованы.
ExtractToDirectory(string)
Извлекает содержимое архива в указанный каталог.
public void ExtractToDirectory(string destinationDirectory)
Параметры
destinationDirectory
string
Путь к каталогу, в который будут помещены извлеченные файлы.
Замечания
Если каталог не существует, он будет создан.
Исключения
destinationDirectory
равен null.
Указанный путь, имя файла или оба превышают максимальную длину, определенную системой. Например, на платформах Windows пути должны быть короче 248 символов, а имена файлов — короче 260 символов.
У вызывающего нет необходимых разрешений для доступа к существующему каталогу.
Если каталог не существует, путь содержит символ двоеточия (:) который не является частью метки диска (“C:").
destinationDirectory
является строкой нулевой длины, содержит только пробелы или содержит один или несколько недопустимых символов. Вы можете запросить недопустимые символы, используя метод System.IO.Path.GetInvalidPathChars.
-или- путь начинается с, или содержит только символ двоеточия (:).
Указанный путь является файлом. -или- Сетевое имя не известно.
Save(Stream, ZArchiveSaveOptions)
Сохраняет архив xz в предоставленный поток.
public void Save(Stream output, ZArchiveSaveOptions settings = null)
Параметры
output
Stream
Поток назначения.
settings
ZArchiveSaveOptions
Необязательные настройки для составления архива.
Примеры
using (FileStream zFile = File.Open("data.bin.z", FileMode.Create))
{
using (var archive = new ZArchive())
{
archive.SetSource("data.bin");
archive.Save(zFile);
}
}
Замечания
output
должен поддерживать поиск.
Исключения
output
не поддерживает поиск.
output
равен null.
Save(string, ZArchiveSaveOptions)
Сохраняет архив Z в указанный файл назначения.
public void Save(string destinationFileName, ZArchiveSaveOptions settings = null)
Параметры
destinationFileName
string
+Путь к архиву, который будет создан. Если указанное имя файла указывает на существующий файл, он будет перезаписан.
settings
ZArchiveSaveOptions
Необязательные настройки для составления архива.
Примеры
using (var archive = new ZArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("data.bin.Z");
}
Исключения
destinationFileName
равен null.
У вызывающего нет необходимых разрешений для доступа.
destinationFileName
пуст, содержит только пробелы или содержит недопустимые символы.
Доступ к файлу destinationFileName
запрещен.
Указанный destinationFileName
, имя файла или оба превышают максимальную длину, определенную системой. Например, на платформах Windows пути должны быть короче 248 символов, а имена файлов — короче 260 символов.
Файл по destinationFileName
содержит двоеточие (:) в середине строки.
SetSource(Stream)
Устанавливает содержимое, которое будет сжиматься в архиве.
public void SetSource(Stream source)
Параметры
source
Stream
Входной поток для архива.
Примеры
using (var archive = new ZArchive())
{
archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
archive.Save("archive.Z");
}
SetSource(FileInfo)
Устанавливает содержимое, которое будет сжиматься в архиве.
public void SetSource(FileInfo fileInfo)
Параметры
fileInfo
FileInfo
FileInfo, который будет открыт как входной поток.
Примеры
using (var archive = new ZArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("data.bin.Z");
}
Исключения
У вызывающего нет необходимых разрешений для открытия fileInfo
.
Путь к файлу пуст или содержит только пробелы.
Файл не найден.
Путь к файлу является доступным только для чтения или является каталогом.
fileInfo
равен null.
Указанный путь недействителен, например, находится на неотображаемом диске.
Файл уже открыт.
SetSource(string)
Устанавливает содержимое, которое будет сжиматься в архиве.
public void SetSource(string sourcePath)
Параметры
sourcePath
string
Путь к файлу, который будет открыт как входной поток.
Примеры
using (var archive = new ZArchive())
{
archive.SetSource("data.bin");
archive.Save("data.bin.Z");
}
Исключения
sourcePath
равен null или пустой строкой.
У вызывающего нет необходимых разрешений для доступа к ресурсу.
sourcePath
пуст, содержит только пробелы или содержит недопустимые символы.
Доступ к файлу sourcePath
запрещен.
Указанный sourcePath
, имя файла или оба превышают максимальную длину, определенную системой. Например, на платформах Windows пути должны быть короче 248 символов, а имена файлов — короче 260 символов.
Файл по sourcePath
содержит двоеточие (:) в середине строки.