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