Class ZArchive

Class ZArchive

Названий на: Aspose.Zip.Z Асамблея: Aspose.Zip.dll (25.5.0)

Цей клас являє собою файл архіву Z (компрес). використовуйте його для складання або екстракту архівів Z.

public class ZArchive : IArchive, IDisposable, IArchiveFileEntry

Inheritance

object ZArchive

Implements

IArchive , IDisposable , IArchiveFileEntry

Нападні члени

object.GetType() , object.MemberwiseClone() , object.ToString() , object.Equals(object?) , object.Equals(object?, object?) , object.ReferenceEquals(object?, object?) , object.GetHashCode()

Remarks

Переглянути https://docs.fileformat.com/compression/z/

Constructors

Архів()

Ініціалює новий приклад класу Aspose.Zip.Z.Archive, підготовленого для компресії.

public ZArchive()

Архів(Завантажити ZArchiveLoadOptions)

Ініціалює новий приклад класу Aspose.Zip.Z.Archive, підготовленого до декомпресії.

public ZArchive(Stream source, ZArchiveLoadOptions loadOptions = null)

Parameters

source Stream

Джерело архіву.

loadOptions ZArchiveLoadOptions

Вибір варіантів завантаження архіву.

Remarks

Цей конструктор не декомпресує. переглянути Aspose.Zip.Z.ZArchive.Extract(System.IO.Stream) метод для декомпресії.

Exceptions

ArgumentException

source’ is not seekable.

ArgumentNullException

source’ is null.

Архів(Завантажити ZArchiveLoadOptions)

Ініціалює новий приклад класу Aspose.Zip.Z.Archive, підготовленого до декомпресії.

public ZArchive(string path, ZArchiveLoadOptions loadOptions = null)

Parameters

path string

Шлях до джерела архіву.

loadOptions ZArchiveLoadOptions

Вибір варіантів завантаження архіву.

Remarks

Цей конструктор не декомпресує. переглянути Aspose.Zip.Z.ZArchive.Extract(System.IO.Stream) метод для декомпресії.

Exceptions

ArgumentNullException

path’ is null.

SecurityException

Замовник не має необхідного дозволу на доступ.

ArgumentException

path’ є порожнім, містить тільки білі простори, або містить недійсні символи.

UnauthorizedAccessException

Доступ до файлу path" відмовляється.

PathTooLongException

Наприклад, на платформах, заснованих на Windows, шляхи повинні бути менше 248 символів, а імена файлів повинні бути менше 260 символів.

NotSupportedException

Файл в path’ містить колону (:) в середині смуги.

FileNotFoundException

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

DirectoryNotFoundException

Визначений шлях недійсний, наприклад, перебування на безкартованому двигуні.

IOException

Файл вже відкритий.

Methods

Dispose()

Виконання завдань, визначених застосуванням, пов’язаних з звільненням, звільненням або відновленням нерухомих ресурсів.

public void Dispose()

Dispose(Бол)

Виконання завдань, визначених застосуванням, пов’язаних з звільненням, звільненням або відновленням нерухомих ресурсів.

protected virtual void Dispose(bool disposing)

Parameters

disposing bool

Чи потрібно витрачати управляні ресурси.

Extract(Stream)

Екстракти Z архіву до потоку.

public void Extract(Stream destination)

Parameters

destination Stream

Потік для зберігання декомпресованих даних.

Examples

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

Exceptions

InvalidDataException

Дані не можуть бути декомпресовані.

Extract(FileInfo)

Екстракти Z архіву до файлу.

public void Extract(FileInfo fileInfo)

Parameters

fileInfo FileInfo

FileInfo для зберігання декомпресованих даних.

Examples

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

Exceptions

SecurityException

Зателефонувач не має необхідного дозволу на відкриття fileInfo'.

ArgumentException

Дорога файлу порожня або містить тільки білі простори.

FileNotFoundException

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

UnauthorizedAccessException

Шлях до файлу читається тільки або є каталогом.

ArgumentNullException

fileInfo’ is null.

DirectoryNotFoundException

Визначений шлях недійсний, наприклад, перебування на безкартованому двигуні.

IOException

Файл вже відкритий.

InvalidDataException

Дані не можуть бути декомпресовані.

Extract(стрічка)

Екстракти Z архіву до файлу шляхом.

public FileInfo Extract(string path)

Parameters

path string

Шлях до файлу, який буде зберігати декомпресовані дані.

Returns

FileInfo

Інформація про витягнутий файл.

Examples

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

Exceptions

ArgumentNullException

path’ is null.

SecurityException

Замовник не має необхідного дозволу на доступ.

ArgumentException

path’ є порожнім, містить тільки білі простори, або містить недійсні символи.

UnauthorizedAccessException

Доступ до файлу path" відмовляється.

PathTooLongException

Наприклад, на платформах, заснованих на Windows, шляхи повинні бути менше 248 символів, а імена файлів повинні бути менше 260 символів.

NotSupportedException

Файл в path’ містить колону (:) в середині смуги.

InvalidDataException

Дані не можуть бути декомпресовані.

ExtractToDirectory(стрічка)

Витягує вміст архіву в наданий каталог.

public void ExtractToDirectory(string destinationDirectory)

Parameters

destinationDirectory string

Шлях до каталогу для розміщення витягнутих файлів.

Remarks

Якщо каталог не існує, він буде створений.

Exceptions

ArgumentNullException

destinationDirectory’ is null.

PathTooLongException

Наприклад, на платформах, заснованих на Windows, шляхи повинні бути менше 248 символів, а імена файлів повинні бути менше 260 символів.

SecurityException

Зателефонувач не має необхідного дозволу на доступ до існуючого каталогу.

NotSupportedException

Якщо каталог не існує, то шлях містить символ колону (:) який не є частиною етикетки диска (“C:”).

ArgumentException

destinationDirectory’ is a zero-length string, contains only white space, or contains one or more invalid characters. You can query for invalid characters by using the System.IO.Path.GetInvalidPathChars method.-or- path is prefixed with, or contains, only a colon character (:).

IOException

Директива, зазначена шляхом, є файлом. -або- Назва мережі не відома.

Save(Архіви, АрхівиSaveOptions)

Зберегти xz архіву до потоку, що надається.

public void Save(Stream output, ZArchiveSaveOptions settings = null)

Parameters

output Stream

Потік напряму.

settings ZArchiveSaveOptions

Опціональні налаштування для архівної композиції.

Examples

using (FileStream zFile = File.Open("data.bin.z", FileMode.Create))
{
    using (var archive = new ZArchive())
    {
        archive.SetSource("data.bin");
        archive.Save(zFile);
     }
}

Remarks

Вони повинні бути пошуковими.

Exceptions

ArgumentException

output’ does not support seeking.

ArgumentNullException

output’ is null.

Save(Зоряний, ZArchiveSaveOptions)

Зберегти Z архіву до даного файлу призначення.

public void Save(string destinationFileName, ZArchiveSaveOptions settings = null)

Parameters

destinationFileName string

Якщо назва файлу вказує на існуючий файл, він буде переписаний.

settings ZArchiveSaveOptions

Опціональні налаштування для архівної композиції.

Examples

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

Exceptions

ArgumentNullException

destinationFileName’ is null.

SecurityException

Замовник не має необхідного дозволу на доступ.

ArgumentException

destinationFileName’ є порожнім, містить тільки білі простори, або містить недійсні символи.

UnauthorizedAccessException

Доступ до файлу destinationFileName’ відмовляється.

PathTooLongException

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

NotSupportedException

Файл в destinationFileName’ містить колону (:) в середині смуги.

SetSource(Stream)

Налаштуйте контент, який повинен бути компресований в архіві.

public void SetSource(Stream source)

Parameters

source Stream

Вхідний потік для архіву.

Examples

using (var archive = new ZArchive())
{
    archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
    archive.Save("archive.Z");
}

SetSource(FileInfo)

Налаштуйте контент, який повинен бути компресований в архіві.

public void SetSource(FileInfo fileInfo)

Parameters

fileInfo FileInfo

FileInfo, який буде відкритий як вхідний потік.

Examples

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

Exceptions

SecurityException

Зателефонувач не має необхідного дозволу на відкриття fileInfo'.

ArgumentException

Дорога файлу порожня або містить тільки білі простори.

FileNotFoundException

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

UnauthorizedAccessException

Шлях до файлу читається тільки або є каталогом.

ArgumentNullException

fileInfo’ is null.

DirectoryNotFoundException

Визначений шлях недійсний, наприклад, перебування на безкартованому двигуні.

IOException

Файл вже відкритий.

SetSource(стрічка)

Налаштуйте контент, який повинен бути компресований в архіві.

public void SetSource(string sourcePath)

Parameters

sourcePath string

Шлях до файлу, який буде відкритий як вхідний потік.

Examples

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

Exceptions

ArgumentNullException

sourcePath’ is null or empty string.

SecurityException

Зателефонувач не має необхідного дозволу на доступ до ресурсу.

ArgumentException

sourcePath’ порожній, містить тільки білі простори, або містить недійсні символи.

UnauthorizedAccessException

Доступ до файлу sourcePath’ відмовляється.

PathTooLongException

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

NotSupportedException

Файл в sourcePath’ містить колону (:) в середині смуги.

 Українська