Class XzArchive

Class XzArchive

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

Цей клас являє собою файл архів xz. Використовуйте його для композиції і екстракту архів xz.

public class XzArchive : IArchive, IDisposable, IArchiveFileEntry

Inheritance

object XzArchive

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

ArgumentException

source’ is not seekable.

ArgumentNullException

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

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)

Екстракт 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

InvalidOperationException

Архівні заголовки та інформація про службу не прочитано.

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

InvalidOperationException

Архівні заголовки та інформація про службу не прочитано.

SecurityException

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

ArgumentException

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

FileNotFoundException

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

UnauthorizedAccessException

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

ArgumentNullException

fileInfo’ is null.

DirectoryNotFoundException

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

IOException

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

Extract(стрічка)

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

public FileInfo Extract(string path)

Parameters

path string

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

Returns

FileInfo

System.IO.FileInfo інстанція, що містить витягнуті дані.

Examples

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

Exceptions

InvalidOperationException

Архівні заголовки та інформація про службу не прочитано.

ArgumentNullException

path’ is null.

SecurityException

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

ArgumentException

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

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

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

FileNotFoundException

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

DirectoryNotFoundException

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

IOException

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

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(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

ArgumentException

output’ does not support seeking.

ArgumentNullException

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

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 XzArchive())
{
    archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
    archive.Save("archive.xz");
}

Exceptions

ArgumentException

Потік джерела є невизначеним.

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

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 XzArchive()) 
{
    archive.SetSource("data.bin");
    archive.Save("archive.xz");
}

Exceptions

ArgumentNullException

sourcePath’ is null.

SecurityException

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

ArgumentException

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

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

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

 Українська