Class XzArchive
Названий на: Aspose.Zip.Xz Асамблея: Aspose.Zip.dll (25.5.0)
Цей клас являє собою файл архів xz. Використовуйте його для композиції і екстракту архів xz.
public class XzArchive : IArchive, IDisposable, IArchiveFileEntry
Inheritance
Implements
IArchive , IDisposable , IArchiveFileEntry
Нападні члени
object.GetType() , object.MemberwiseClone() , object.ToString() , object.Equals(object?) , object.Equals(object?, object?) , object.ReferenceEquals(object?, object?) , object.GetHashCode()
Constructors
XzArchive(XzArchiveSettings)
Ініціалізує новий приклад класу Aspose.Zip.Xz.XzArchive і складає архіви у форматі xz.
public XzArchive(XzArchiveSettings settings = null)
Parameters
settings
XzArchiveSettings
Набір налаштувань конкретного xz архіву: розмір словника, розмір блоку, тип перевірки.
XzArchive(Stream)
Ініціалює новий приклад класу Aspose.Zip.Xz.XzArchive, підготовлений для декомпресії.
public XzArchive(Stream source)
Parameters
source
Stream
Джерело архіву.
Remarks
Цей конструктор не декомпресує. переглянути Aspose.Zip.Xz.XzArchive.Extract(System.IO.Stream) метод для декомпресування.
Exceptions
source’ is not seekable.
source’ is null.
XzArchive(стрічка)
Ініціалює новий приклад класу Aspose.Zip.Xz.XzArchive, підготовлений для декомпресії.
public XzArchive(string path)
Parameters
path
string
Шлях до джерела архіву.
Remarks
Цей конструктор не декомпресує. переглянути Aspose.Zip.Xz.XzArchive.Extract(System.IO.Stream) метод для декомпресування.
Exceptions
path’ is null.
Замовник не має необхідного дозволу на доступ.
path’ є порожнім, містить тільки білі простори, або містить недійсні символи.
Доступ до файлу path" відмовляється.
Наприклад, на платформах, заснованих на Windows, шляхи повинні бути менше 248 символів, а імена файлів повинні бути менше 260 символів.
Файл в path’ містить колону (:) в середині смуги.
Файл не знайдено.
Визначений шлях недійсний, наприклад, перебування на безкартованому двигуні.
Файл вже відкритий.
Methods
Dispose()
Виконання завдань, визначених застосуванням, пов’язаних з звільненням, звільненням або відновленням нерухомих ресурсів.
public void Dispose()
Dispose(Бол)
Виконання завдань, визначених застосуванням, пов’язаних з звільненням, звільненням або відновленням нерухомих ресурсів.
protected virtual void Dispose(bool disposing)
Parameters
disposing
bool
Чи потрібно витрачати управляні ресурси.
Extract(Stream)
Екстракт xz архіву до потоку.
public void Extract(Stream destination)
Parameters
destination
Stream
Потік для зберігання декомпресованих даних.
Examples
using (FileStream xzFile = File.Open(sourceFileName, FileMode.Open))
{
using (FileStream extractedFile = File.Open(extractedFileName, FileMode.Create))
{
using (var archive = new XzArchive(xzFile))
{
archive.Extract(extractedFile);
}
}
}
Exceptions
Архівні заголовки та інформація про службу не прочитано.
Extract(FileInfo)
Екстракт xz архіву до файлу.
public void Extract(FileInfo fileInfo)
Parameters
fileInfo
FileInfo
FileInfo для зберігання декомпресованих даних.
Examples
using (FileStream xzFile = File.Open(sourceFileName, FileMode.Open))
{
using (var archive = new XzArchive(xzFile))
{
archive.Extract(new FileInfo("extracted.bin"));
}
}
Exceptions
Архівні заголовки та інформація про службу не прочитано.
Зателефонувач не має необхідного дозволу на відкриття fileInfo'.
Дорога файлу порожня або містить тільки білі простори.
Файл не знайдено.
Шлях до файлу читається тільки або є каталогом.
fileInfo’ is null.
Визначений шлях недійсний, наприклад, перебування на безкартованому двигуні.
Файл вже відкритий.
Extract(стрічка)
Екстракти xz архіву до файлу шляхом.
public FileInfo Extract(string path)
Parameters
path
string
Шлях до файлу, який буде зберігати декомпресовані дані.
Returns
System.IO.FileInfo інстанція, що містить витягнуті дані.
Examples
using (FileStream xzFile = File.Open(sourceFileName, FileMode.Open))
{
using (var archive = new XzArchive(xzFile))
{
archive.Extract("extracted.bin");
}
}
Exceptions
Архівні заголовки та інформація про службу не прочитано.
path’ is null.
Замовник не має необхідного дозволу на доступ.
path’ є порожнім, містить тільки білі простори, або містить недійсні символи.
Доступ до файлу path" відмовляється.
Наприклад, на платформах, заснованих на Windows, шляхи повинні бути менше 248 символів, а імена файлів повинні бути менше 260 символів.
Файл в path’ містить колону (:) в середині смуги.
Файл не знайдено.
Визначений шлях недійсний, наприклад, перебування на безкартованому двигуні.
Файл вже відкритий.
ExtractToDirectory(стрічка)
Витягує вміст архіву в наданий каталог.
public void ExtractToDirectory(string destinationDirectory)
Parameters
destinationDirectory
string
Шлях до каталогу для розміщення витягнутих файлів.
Remarks
Якщо каталог не існує, він буде створений.
Exceptions
destinationDirectory’ is null.
Наприклад, на платформах, заснованих на Windows, шляхи повинні бути менше 248 символів, а імена файлів повинні бути менше 260 символів.
Зателефонувач не має необхідного дозволу на доступ до існуючого каталогу.
Якщо каталог не існує, то шлях містить символ колону (:) який не є частиною етикетки диска (“C:”).
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 (:).
Директива, зазначена шляхом, є файлом. -або- Назва мережі не відома.
Save(Stream)
Зберегти xz архіву до потоку, що надається.
public void Save(Stream output)
Parameters
output
Stream
Потік напряму.
Examples
using (FileStream xzFile = File.Open("archive.xz", FileMode.Create))
{
using (var archive = new XzArchive())
{
archive.SetSource("data.bin");
archive.Save(xzFile);
}
}
Remarks
Вони повинні бути пошуковими.
Exceptions
output’ does not support seeking.
output’ is null.
Save(стрічка)
Зберегти файл xz до даного файлу призначення.
public void Save(string destinationFileName)
Parameters
destinationFileName
string
Якщо назва файлу вказує на існуючий файл, він буде переписаний.
Examples
using (var archive = new XzArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("result.xz");
}
Exceptions
destinationFileName’ is null.
Замовник не має необхідного дозволу на доступ.
destinationFileName’ є порожнім, містить тільки білі простори, або містить недійсні символи.
Доступ до файлу destinationFileName’ відмовляється.
Визначений destinationFileName’, ім’я файлу, або обидва перевищують максимальну довжину, визначену системою. Наприклад, на платформах, заснованих на Windows, шляхи повинні бути менше 248 символів, а імена файлу повинні бути менше 260 символів.
Файл в destinationFileName’ містить колону (:) в середині смуги.
SetSource(Stream)
Налаштуйте контент, який повинен бути компресований в архіві.
public void SetSource(Stream source)
Parameters
source
Stream
Вхідний потік для архіву.
Examples
using (var archive = new XzArchive())
{
archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
archive.Save("archive.xz");
}
Exceptions
Потік джерела є невизначеним.
SetSource(FileInfo)
Налаштуйте контент, який повинен бути компресований в архіві.
public void SetSource(FileInfo fileInfo)
Parameters
fileInfo
FileInfo
FileInfo, який буде відкритий як вхідний потік.
Examples
using (var archive = new XzArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("archive.xz");
}
Exceptions
Зателефонувач не має необхідного дозволу на відкриття fileInfo'.
Дорога файлу порожня або містить тільки білі простори.
Файл не знайдено.
Шлях до файлу читається тільки або є каталогом.
fileInfo’ is null.
Визначений шлях недійсний, наприклад, перебування на безкартованому двигуні.
Файл вже відкритий.
SetSource(стрічка)
Налаштуйте контент, який повинен бути компресований в архіві.
public void SetSource(string sourcePath)
Parameters
sourcePath
string
Шлях до файлу, який буде відкритий як вхідний потік.
Examples
using (var archive = new XzArchive())
{
archive.SetSource("data.bin");
archive.Save("archive.xz");
}
Exceptions
sourcePath’ is null.
Замовник не має необхідного дозволу на доступ.
sourcePath’ порожній, містить тільки білі простори, або містить недійсні символи.
Доступ до файлу sourcePath’ відмовляється.
Визначений sourcePath", ім’я файлу, або обидва перевищують максимальну довжину, визначену системою. Наприклад, на платформах, заснованих на Windows, шляхи повинні бути менше 248 символів, а імена файлу повинні бути менше 260 символів.
Файл в sourcePath’ містить колону (:) в середині смуги.