Class ZArchive

Class ZArchive

Namespace: Aspose.Zip.Z
Assembly: Aspose.Zip.dll (25.1.0)

Этот класс представляет файл архива Z (сжатие). Используйте его для создания или извлечения архивов Z.

public class ZArchive : IArchive, IDisposable, IArchiveFileEntry

Наследование

objectZArchive

Реализует

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) для распаковки.

Исключения

ArgumentException

source не поддерживает поиск.

ArgumentNullException

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) для распаковки.

Исключения

ArgumentNullException

path равен null.

SecurityException

У вызывающего нет необходимых разрешений для доступа.

ArgumentException

path пуст, содержит только пробелы или содержит недопустимые символы.

UnauthorizedAccessException

Доступ к файлу path запрещен.

PathTooLongException

Указанный path, имя файла или оба превышают максимальную длину, определенную системой. Например, на платформах Windows пути должны быть короче 248 символов, а имена файлов — короче 260 символов.

NotSupportedException

Файл по path содержит двоеточие (:) в середине строки.

FileNotFoundException

Файл не найден.

DirectoryNotFoundException

Указанный путь недействителен, например, находится на неотображаемом диске.

IOException

Файл уже открыт.

Методы

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);
        }
    }
}

Исключения

InvalidDataException

Данные не могут быть распакованы.

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"));
    }
}

Исключения

SecurityException

У вызывающего нет необходимых разрешений для открытия fileInfo.

ArgumentException

Путь к файлу пуст или содержит только пробелы.

FileNotFoundException

Файл не найден.

UnauthorizedAccessException

Путь к файлу является доступным только для чтения или является каталогом.

ArgumentNullException

fileInfo равен null.

DirectoryNotFoundException

Указанный путь недействителен, например, находится на неотображаемом диске.

IOException

Файл уже открыт.

InvalidDataException

Данные не могут быть распакованы.

Extract(string)

Извлекает архив Z в файл по указанному пути.

public FileInfo Extract(string path)

Параметры

path string

Путь к файлу, который будет хранить распакованные данные.

Возвращает

FileInfo

Информация о извлеченном файле.

Примеры

using (FileStream zFile = File.Open(sourceFileName, FileMode.Open))
{
    using (var archive = new ZArchive(zFile))
    {
        archive.Extract("extracted.bin");
    }
}

Исключения

ArgumentNullException

path равен null.

SecurityException

У вызывающего нет необходимых разрешений для доступа.

ArgumentException

path пуст, содержит только пробелы или содержит недопустимые символы.

UnauthorizedAccessException

Доступ к файлу path запрещен.

PathTooLongException

Указанный path, имя файла или оба превышают максимальную длину, определенную системой. Например, на платформах Windows пути должны быть короче 248 символов, а имена файлов — короче 260 символов.

NotSupportedException

Файл по path содержит двоеточие (:) в середине строки.

InvalidDataException

Данные не могут быть распакованы.

ExtractToDirectory(string)

Извлекает содержимое архива в указанный каталог.

public void ExtractToDirectory(string destinationDirectory)

Параметры

destinationDirectory string

Путь к каталогу, в который будут помещены извлеченные файлы.

Замечания

Если каталог не существует, он будет создан.

Исключения

ArgumentNullException

destinationDirectory равен null.

PathTooLongException

Указанный путь, имя файла или оба превышают максимальную длину, определенную системой. Например, на платформах Windows пути должны быть короче 248 символов, а имена файлов — короче 260 символов.

SecurityException

У вызывающего нет необходимых разрешений для доступа к существующему каталогу.

NotSupportedException

Если каталог не существует, путь содержит символ двоеточия (:) который не является частью метки диска (“C:").

ArgumentException

destinationDirectory является строкой нулевой длины, содержит только пробелы или содержит один или несколько недопустимых символов. Вы можете запросить недопустимые символы, используя метод System.IO.Path.GetInvalidPathChars. -или- путь начинается с, или содержит только символ двоеточия (:).

IOException

Указанный путь является файлом. -или- Сетевое имя не известно.

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 должен поддерживать поиск.

Исключения

ArgumentException

output не поддерживает поиск.

ArgumentNullException

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");
}

Исключения

ArgumentNullException

destinationFileName равен null.

SecurityException

У вызывающего нет необходимых разрешений для доступа.

ArgumentException

destinationFileName пуст, содержит только пробелы или содержит недопустимые символы.

UnauthorizedAccessException

Доступ к файлу destinationFileName запрещен.

PathTooLongException

Указанный destinationFileName, имя файла или оба превышают максимальную длину, определенную системой. Например, на платформах Windows пути должны быть короче 248 символов, а имена файлов — короче 260 символов.

NotSupportedException

Файл по 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");
}

Исключения

SecurityException

У вызывающего нет необходимых разрешений для открытия fileInfo.

ArgumentException

Путь к файлу пуст или содержит только пробелы.

FileNotFoundException

Файл не найден.

UnauthorizedAccessException

Путь к файлу является доступным только для чтения или является каталогом.

ArgumentNullException

fileInfo равен null.

DirectoryNotFoundException

Указанный путь недействителен, например, находится на неотображаемом диске.

IOException

Файл уже открыт.

SetSource(string)

Устанавливает содержимое, которое будет сжиматься в архиве.

public void SetSource(string sourcePath)

Параметры

sourcePath string

Путь к файлу, который будет открыт как входной поток.

Примеры

using (var archive = new ZArchive()) 
{
    archive.SetSource("data.bin");
    archive.Save("data.bin.Z");
}

Исключения

ArgumentNullException

sourcePath равен null или пустой строкой.

SecurityException

У вызывающего нет необходимых разрешений для доступа к ресурсу.

ArgumentException

sourcePath пуст, содержит только пробелы или содержит недопустимые символы.

UnauthorizedAccessException

Доступ к файлу sourcePath запрещен.

PathTooLongException

Указанный sourcePath, имя файла или оба превышают максимальную длину, определенную системой. Например, на платформах Windows пути должны быть короче 248 символов, а имена файлов — короче 260 символов.

NotSupportedException

Файл по sourcePath содержит двоеточие (:) в середине строки.

 Русский