Class LzmaArchive
Namespace: Aspose.Zip.LZMA
Assembly: Aspose.Zip.dll (25.1.0)
Цей клас представляє файл архіву LZMA. Використовуйте його для створення або витягування архівів LZMA.
public class LzmaArchive : 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()
Конструктори
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) для розпакування.
Виключення
source
не може бути переміщеним.
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) для розпакування.
Виключення
path
є null.
Викликач не має необхідних прав для доступу.
path
є порожнім, містить лише пробіли або містить недопустимі символи.
Доступ до файлу path
заборонено.
Вказаний path
, ім’я файлу або обидва перевищують максимально допустиму довжину, визначену системою. Наприклад, на платформах Windows шляхи повинні бути менше 248 символів, а імена файлів повинні бути менше 260 символів.
Файл за 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);
}
}
}
Виключення
Заголовки архіву та службова інформація не були прочитані.
Архів пошкоджений.
Потік призначення є null.
Потік призначення не підтримує запис.
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"));
}
}
Виключення
Заголовки архіву та службова інформація не були прочитані.
Викликач не має необхідних прав для відкриття fileInfo
.
Шлях до файлу є порожнім або містить лише пробіли.
Файл не знайдено.
Шлях до файлу є лише для читання або є каталогом.
fileInfo
є null.
Вказаний шлях недійсний, наприклад, знаходиться на не відображеному диску.
Файл вже відкритий.
Архів пошкоджений.
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");
}
}
Виключення
Заголовки архіву та службова інформація не були прочитані.
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.
-or- шлях починається з, або містить, лише символ двокрапки (:).
Вказаний шлях є файлом. -or- Ім’я мережі не відомо.
Архів пошкоджений.
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
повинен бути переміщуваним.
Виключення
output
не підтримує переміщення.
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"));
}
Виключення
Викликач не має необхідних прав для відкриття destination
.
Шлях до файлу є порожнім або містить лише пробіли.
Файл не знайдено.
Шлях до файлу є лише для читання або є каталогом.
destination
є null.
Вказаний шлях недійсний, наприклад, знаходиться на не відображеному диску.
Файл вже відкритий.
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");
}
Виключення
destinationFileName
є null.
Викликач не має необхідних прав для доступу.
destinationFileName
є порожнім, містить лише пробіли або містить недопустимі символи.
Доступ до файлу destinationFileName
заборонено.
Вказаний destinationFileName
, ім’я файлу або обидва перевищують максимально допустиму довжину, визначену системою. Наприклад, на платформах Windows шляхи повинні бути менше 248 символів, а імена файлів повинні бути менше 260 символів.
Файл за 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");
}
Виключення
Потік 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");
}
Виключення
Викликач не має необхідних прав для відкриття fileInfo
.
Шлях до файлу є порожнім або містить лише пробіли.
Файл не знайдено.
Шлях до файлу є лише для читання або є каталогом.
fileInfo
є null.
Вказаний шлях недійсний, наприклад, знаходиться на не відображеному диску.
Файл вже відкритий.
SetSource(string)
Встановлює вміст, який потрібно стиснути в архіві.
public void SetSource(string sourcePath)
Параметри
sourcePath
string
Шлях до файлу, який буде відкрито як вхідний потік.
Приклади
using (var archive = new LzmaArchive())
{
archive.SetSource("data.bin");
archive.Save("archive.lzma");
}
Виключення
sourcePath
є null.
Викликач не має необхідних прав для доступу.
sourcePath
є порожнім, містить лише пробіли або містить недопустимі символи.
Доступ до файлу sourcePath
заборонено.
Вказаний sourcePath
, ім’я файлу або обидва перевищують максимально допустиму довжину, визначену системою. Наприклад, на платформах Windows шляхи повинні бути менше 248 символів, а імена файлів повинні бути менше 260 символів.
Файл за sourcePath
містить двокрапку (:) посередині рядка.