Class LzmaArchive

Class LzmaArchive

Namespace: Aspose.Zip.LZMA
Assembly: Aspose.Zip.dll (25.1.0)

Цей клас представляє файл архіву LZMA. Використовуйте його для створення або витягування архівів LZMA.

public class LzmaArchive : IArchive, IDisposable, IArchiveFileEntry

Спадкування

objectLzmaArchive

Реалізує

IArchive, IDisposable, IArchiveFileEntry

Спадковані члени

object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()

Конструктори

LzmaArchive(LzmaArchiveSettings)

Ініціалізує новий екземпляр класу Aspose.Zip.LZMA.LzmaArchive та формує архів у форматі lzma.

public LzmaArchive(LzmaArchiveSettings settings = null)

Параметри

settings LzmaArchiveSettings

Набір налаштувань конкретного архіву lzma.

LzmaArchive(Stream)

Ініціалізує новий екземпляр класу Aspose.Zip.LZMA.LzmaArchive, підготовлений для розпакування.

public LzmaArchive(Stream source)

Параметри

source Stream

Джерело архіву.

Зауваження

Цей конструктор не розпаковує. Дивіться метод Aspose.Zip.LZMA.LzmaArchive.Extract(System.IO.Stream) для розпакування.

Виключення

ArgumentException

source не може бути переміщеним.

ArgumentNullException

source є null.

LzmaArchive(string)

Ініціалізує новий екземпляр класу Aspose.Zip.LZMA.LzmaArchive, підготовлений для розпакування.

public LzmaArchive(string path)

Параметри

path string

Шлях до джерела архіву.

Приклади

using (FileStream extractedFile = File.Open(extractedFileName, FileMode.Create))
{
    using (var archive = new LzmaArchive(sourceLzmaFile))
    {
         archive.Extract(extractedFile);
    }
}

Зауваження

Цей конструктор не розпаковує. Дивіться метод Aspose.Zip.LZMA.LzmaArchive.Extract(System.IO.Stream) для розпакування.

Виключення

ArgumentNullException

path є null.

SecurityException

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

ArgumentException

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

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

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

Методи

Dispose()

Виконує завдання, визначені програмою, пов’язані з звільненням, вивільненням або скиданням некерованих ресурсів.

public void Dispose()

Dispose(bool)

Виконує завдання, визначені програмою, пов’язані з звільненням, вивільненням або скиданням некерованих ресурсів.

protected virtual void Dispose(bool disposing)

Параметри

disposing bool

Чи слід звільнити керовані ресурси.

Extract(Stream)

Витягує архів lzma в потік.

public void Extract(Stream destination)

Параметри

destination Stream

Потік для зберігання розпакованих даних.

Приклади

using (FileStream sourceLzmaFile = File.Open(sourceFileName, FileMode.Open))
{
   using (FileStream extractedFile = File.Open(extractedFileName, FileMode.Create))
   {
       using (var archive = new LzmaArchive(sourceLzmaFile))
       {
           archive.Extract(extractedFile);
       }
   }
}

Виключення

InvalidOperationException

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

InvalidDataException

Архів пошкоджений.

ArgumentNullException

Потік призначення є null.

ArgumentException

Потік призначення не підтримує запис.

Extract(FileInfo)

Витягує архів lzma в файл.

public void Extract(FileInfo fileInfo)

Параметри

fileInfo FileInfo

FileInfo для зберігання розпакованих даних.

Приклади

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

Виключення

InvalidOperationException

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

SecurityException

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

ArgumentException

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

FileNotFoundException

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

UnauthorizedAccessException

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

ArgumentNullException

fileInfo є null.

DirectoryNotFoundException

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

IOException

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

InvalidDataException

Архів пошкоджений.

Extract(string)

Витягує архів lzma в файл за шляхом.

public void Extract(string path)

Параметри

path string

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

Приклади

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

Виключення

InvalidOperationException

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

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. -or- шлях починається з, або містить, лише символ двокрапки (:).

IOException

Вказаний шлях є файлом. -or- Ім’я мережі не відомо.

InvalidDataException

Архів пошкоджений.

Save(Stream)

Зберігає архів lzma в наданий потік.

public void Save(Stream output)

Параметри

output Stream

Потік призначення.

Приклади

using (FileStream lzmaFile = File.Open("archive.lzma", FileMode.Create))
{
    using (var archive = new LzmaArchive())
    {
        archive.SetSource("data.bin");
        archive.Save(lzmaFile);
     }
}

Зауваження

output повинен бути переміщуваним.

Виключення

ArgumentException

output не підтримує переміщення.

ArgumentNullException

output є null.

Save(FileInfo)

Зберігає архів lzma в наданий файл призначення.

public void Save(FileInfo destination)

Параметри

destination FileInfo

FileInfo, який буде відкрито як потік призначення.

Приклади

using (var archive = new LzmaArchive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save(new FileInfo("archive.lzma"));
}

Виключення

SecurityException

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

ArgumentException

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

FileNotFoundException

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

UnauthorizedAccessException

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

ArgumentNullException

destination є null.

DirectoryNotFoundException

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

IOException

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

Save(string)

Зберігає архів lzma в наданий файл призначення.

public void Save(string destinationFileName)

Параметри

destinationFileName string

Шлях до архіву, який буде створено. Якщо вказане ім’я файлу вказує на існуючий файл, він буде перезаписано.

Приклади

using (var archive = new LzmaArchive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save("result.lzma");
}

Виключення

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

Виключення

ArgumentException

Потік source не може бути переміщеним.

SetSource(FileInfo)

Встановлює вміст, який потрібно стиснути в архіві.

public void SetSource(FileInfo fileInfo)

Параметри

fileInfo FileInfo

FileInfo, який буде відкрито як вхідний потік.

Приклади

using (var archive = new LzmaArchive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save("archive.lzma");
}

Виключення

SecurityException

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

ArgumentException

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

FileNotFoundException

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

UnauthorizedAccessException

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

ArgumentNullException

fileInfo є null.

DirectoryNotFoundException

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

IOException

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

SetSource(string)

Встановлює вміст, який потрібно стиснути в архіві.

public void SetSource(string sourcePath)

Параметри

sourcePath string

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

Приклади

using (var archive = new LzmaArchive()) 
{
    archive.SetSource("data.bin");
    archive.Save("archive.lzma");
}

Виключення

ArgumentNullException

sourcePath є null.

SecurityException

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

ArgumentException

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

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

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

 Українська