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 містить двокрапку (:) посередині рядка.

 Українська