Class ZArchive

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 символів.

DirectoryNotFoundException

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

FileNotFoundException

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

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

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

Методи

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

Винятки

Викликач не має необхідних прав доступу для відкриття fileInfo.

Шлях до файлу є порожнім або містить лише пробіли.

FileNotFoundException

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

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

DirectoryNotFoundException

fileInfo є null.

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

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

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

Винятки

path є null.

Викликач не має необхідних прав доступу.

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

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

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

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

InvalidDataException

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

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.

Шлях до файлу є порожнім або містить лише пробіли.

FileNotFoundException

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

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

DirectoryNotFoundException

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 символів.