Class LzipArchive

Class LzipArchive

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

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

public class LzipArchive : IArchive, IDisposable, IArchiveFileEntry

Спадкування

objectLzipArchive

Реалізує

IArchive, IDisposable, IArchiveFileEntry

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

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

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

LzipArchive(LzipArchiveSettings)

Ініціалізує новий екземпляр Aspose.Zip.Lzip.LzipArchive.

public LzipArchive(LzipArchiveSettings settings = null)

Параметри

settings LzipArchiveSettings

Налаштування конкретного архіву lzip з визначенням розміру словника.

LzipArchive(Stream)

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

public LzipArchive(Stream sourceStream)

Параметри

sourceStream Stream

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

Примітки

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

Винятки

ArgumentException

sourceStream не є доступним для пошуку.

ArgumentNullException

sourceStream дорівнює null.

InvalidDataException

Заголовки не відповідають типу архіву lzip.

LzipArchive(string)

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

public LzipArchive(string path)

Параметри

path string

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

Приклади

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

Примітки

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

Винятки

ArgumentNullException

path дорівнює null.

SecurityException

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

ArgumentException

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

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

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

FileNotFoundException

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

DirectoryNotFoundException

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

IOException

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

InvalidDataException

Заголовки не відповідають типу архіву lzip.

Властивості

Settings

Отримує налаштування конкретного архіву lzip.

public LzipArchiveSettings Settings { get; }

Значення властивості

LzipArchiveSettings

Методи

Dispose()

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

public void Dispose()

Dispose(bool)

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

protected virtual void Dispose(bool disposing)

Параметри

disposing bool

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

Extract(Stream)

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

public void Extract(Stream destination)

Параметри

destination Stream

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

Приклади

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

Винятки

InvalidOperationException

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

InvalidDataException

Помилка в даних у заголовку або контрольній сумі.

ArgumentNullException

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

ArgumentException

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

Extract(FileInfo)

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

public void Extract(FileInfo fileInfo)

Параметри

fileInfo FileInfo

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

Приклади

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

Винятки

InvalidOperationException

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

SecurityException

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

ArgumentException

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

FileNotFoundException

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

UnauthorizedAccessException

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

ArgumentNullException

fileInfo дорівнює null.

DirectoryNotFoundException

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

IOException

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

Extract(string)

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

public void Extract(string path)

Параметри

path string

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

Приклади

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

Винятки

InvalidOperationException

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

ArgumentNullException

path дорівнює null.

SecurityException

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

ArgumentException

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

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

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

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

IOException

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

Save(Stream)

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

public void Save(Stream outputStream)

Параметри

outputStream Stream

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

Приклади

using (FileStream lzFile = File.Open("archive.lz", FileMode.Create))
{
    using (var archive = new LzipArchive())
    {
        archive.SetSource("data.bin");
        archive.Save(lzFile);
     }
}

Примітки

outputStream повинен бути доступним для пошуку.

Винятки

ArgumentException

outputStream не підтримує пошук.

ArgumentNullException

outputStream дорівнює null.

Save(string)

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

public void Save(string destinationFileName)

Параметри

destinationFileName string

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

Приклади

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

Винятки

ArgumentNullException

destinationFileName дорівнює null.

SecurityException

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

ArgumentException

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

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

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

Save(FileInfo)

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

public void Save(FileInfo destination)

Параметри

destination FileInfo

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

Приклади

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

Винятки

SecurityException

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

ArgumentException

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

FileNotFoundException

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

UnauthorizedAccessException

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

ArgumentNullException

destination дорівнює null.

DirectoryNotFoundException

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

IOException

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

SetSource(Stream)

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

public void SetSource(Stream source)

Параметри

source Stream

Вхідний потік для архіву.

Приклади

using (var archive = new LzipArchive())
   {
       archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
       archive.Save("archive.lz");
}

Винятки

ArgumentException

Потік source не доступний для пошуку.

SetSource(FileInfo)

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

public void SetSource(FileInfo fileInfo)

Параметри

fileInfo FileInfo

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

Приклади

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

Винятки

SecurityException

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

ArgumentException

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

FileNotFoundException

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

UnauthorizedAccessException

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

ArgumentNullException

fileInfo дорівнює null.

DirectoryNotFoundException

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

IOException

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

SetSource(string)

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

public void SetSource(string path)

Параметри

path string

Шлях до файлу, який буде стиснутий.

Приклади

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

Винятки

ArgumentNullException

path дорівнює null.

SecurityException

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

ArgumentException

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

UnauthorizedAccessException

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

PathTooLongException

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

NotSupportedException

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

 Українська