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