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 содержит двоеточие (:) в середине строки.

 Русский