Class LzipArchive
Namespace: Aspose.Zip.Lzip
Assembly: Aspose.Zip.dll (25.1.0)
Этот класс представляет файл архива Lzip. Используйте его для создания или извлечения архивов Lzip.
public class LzipArchive : IArchive, IDisposable, IArchiveFileEntry
Наследование
Реализует
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) для декомпрессии.
Исключения
sourceStream
не поддерживает перемещение.
sourceStream
равно null.
Заголовки не соответствуют типу архива 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) для декомпрессии.
Исключения
path
равно null.
У вызывающего нет необходимых прав для доступа.
path
пуст, содержит только пробелы или содержит недопустимые символы.
Доступ к файлу path
запрещен.
Указанный path
, имя файла или оба превышают максимальную длину, определенную системой. Например, на платформах Windows пути должны быть меньше 248 символов, а имена файлов должны быть меньше 260 символов.
Файл по адресу path
содержит двоеточие (:) в середине строки.
Файл не найден.
Указанный путь недействителен, например, находится на немаркированном диске.
Файл уже открыт.
Заголовки не соответствуют типу архива lzip.
Свойства
Settings
Получает настройки конкретного архива lzip.
public LzipArchiveSettings Settings { get; }
Значение свойства
Методы
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);
}
}
}
Исключения
Заголовки архива и служебная информация не были прочитаны.
Ошибка в данных в заголовке или контрольной сумме.
Поток назначения равен null.
Поток назначения не поддерживает запись.
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"));
}
}
Исключения
Заголовки архива и служебная информация не были прочитаны.
У вызывающего нет необходимых прав для открытия fileInfo
.
Путь к файлу пуст или содержит только пробелы.
Файл не найден.
Путь к файлу является доступным только для чтения или является каталогом.
fileInfo
равно null.
Указанный путь недействителен, например, находится на немаркированном диске.
Файл уже открыт.
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");
}
}
Исключения
Заголовки архива и служебная информация не были прочитаны.
path
равно null.
У вызывающего нет необходимых прав для доступа.
path
пуст, содержит только пробелы или содержит недопустимые символы.
Доступ к файлу path
запрещен.
Указанный path
, имя файла или оба превышают максимальную длину, определенную системой. Например, на платформах Windows пути должны быть меньше 248 символов, а имена файлов должны быть меньше 260 символов.
Файл по адресу path
содержит двоеточие (:) в середине строки.
ExtractToDirectory(string)
Извлекает содержимое архива в указанный каталог.
public void ExtractToDirectory(string destinationDirectory)
Параметры
destinationDirectory
string
Путь к каталогу, в который будут помещены извлеченные файлы.
Примечания
Если каталог не существует, он будет создан.
Исключения
destinationDirectory
равно null.
Указанный путь, имя файла или оба превышают максимальную длину, определенную системой. Например, на платформах Windows пути должны быть меньше 248 символов, а имена файлов должны быть меньше 260 символов.
У вызывающего нет необходимых прав для доступа к существующему каталогу.
Если каталог не существует, путь содержит символ двоеточия (:) не в части метки диска (“C:").
destinationDirectory
является строкой нулевой длины, содержит только пробелы или содержит один или несколько недопустимых символов. Вы можете запросить недопустимые символы, используя метод System.IO.Path.GetInvalidPathChars.
-или- путь предваряется или содержит только символ двоеточия (:).
Указанный путь является файлом. -или- Сетевое имя неизвестно.
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
должен поддерживать перемещение.
Исключения
outputStream
не поддерживает перемещение.
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");
}
Исключения
destinationFileName
равно null.
У вызывающего нет необходимых прав для доступа.
destinationFileName
пуст, содержит только пробелы или содержит недопустимые символы.
Доступ к файлу destinationFileName
запрещен.
Указанный destinationFileName
, имя файла или оба превышают максимальную длину, определенную системой. Например, на платформах Windows пути должны быть меньше 248 символов, а имена файлов должны быть меньше 260 символов.
Файл по адресу 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"));
}
Исключения
У вызывающего нет необходимых прав для открытия destination
.
Путь к файлу пуст или содержит только пробелы.
Файл не найден.
Путь к файлу является доступным только для чтения или является каталогом.
destination
равно null.
Указанный путь недействителен, например, находится на немаркированном диске.
Файл уже открыт.
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");
}
Исключения
Поток 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");
}
Исключения
У вызывающего нет необходимых прав для открытия fileInfo
.
Путь к файлу пуст или содержит только пробелы.
Файл не найден.
Путь к файлу является доступным только для чтения или является каталогом.
fileInfo
равно null.
Указанный путь недействителен, например, находится на немаркированном диске.
Файл уже открыт.
SetSource(string)
Устанавливает содержимое, которое будет сжиматься в архиве.
public void SetSource(string path)
Параметры
path
string
Путь к файлу, который будет сжат.
Примеры
using (var archive = new LzipArchive())
{
archive.SetSource("data.bin");
archive.Save("archive.lz");
}
Исключения
path
равно null.
У вызывающего нет необходимых прав для доступа.
path
пуст, содержит только пробелы или содержит недопустимые символы.
Доступ к файлу path
запрещен.
Указанный path
, имя файла или оба превышают максимальную длину, определенную системой. Например, на платформах Windows пути должны быть меньше 248 символов, а имена файлов должны быть меньше 260 символов.
Файл по адресу path
содержит двоеточие (:) в середине строки.