Class Lz4Archive
Названий на: Aspose.Zip.Lz4 Асамблея: Aspose.Zip.dll (25.5.0)
Цей клас являє собою файл архіву LZ4. Використовуйте його для екстракції або складання архівів ЛЗ4.
public class Lz4Archive : IArchive, IDisposable, IArchiveFileEntry
Inheritance
Implements
IArchive , IDisposable , IArchiveFileEntry
Нападні члени
object.GetType() , object.MemberwiseClone() , object.ToString() , object.Equals(object?) , object.Equals(object?, object?) , object.ReferenceEquals(object?, object?) , object.GetHashCode()
Constructors
Lz4Archive(Stream)
Ініціалює новий приклад класу Aspose.Zip.Lz4.Lz4Archive, підготовлений для декомпресії.
public Lz4Archive(Stream sourceStream)
Parameters
sourceStream
Stream
Джерело архіву.
Examples
Відкрийте файл з потоку і витягніть його в
var ms = new MemoryStream();
using (Lz4Archive archive = new Lz4Archive(File.OpenRead("archive.lz4")))
archive.Open().CopyTo(ms);
Remarks
Цей конструктор не декомпресує. переглянути Aspose.Zip.Lz4.Lz4Archive.Open метод для декомпресії.
Exceptions
Не можна читати з sourceStream'
sourceStream’ is null.
sourceStream’ is too short.
У sourceStream’ є неправильний підпис.
Lz4Archive(стрічка)
Ініціалізація нової інстанції класу Aspose.Zip.Lz4.Lz4Archive.
public Lz4Archive(string path)
Parameters
path
string
Шлях до архіву.
Examples
Відкрийте файл з файлу шляхом і витягніть його в
var ms = new MemoryStream();
using (Lz4Archive archive = new Lz4Archive("archive.lz4"))
archive.Open().CopyTo(ms);
Remarks
Цей конструктор не декомпресує. переглянути Aspose.Zip.Lz4.Lz4Archive.Open метод для декомпресії.
Exceptions
path’ is null.
Замовник не має необхідного дозволу на доступ до
path’ є порожнім, містить тільки білі простори, або містить недійсні символи.
Доступ до файлу path" відмовляється.
Наприклад, на платформах, заснованих на Windows, шляхи повинні бути менше 248 символів, а імена файлів повинні бути менше 260 символів.
Файл в path’ містить колону (:) в середині смуги.
Файл дуже короткий.
Дані, що містяться в файлі, мають неправильний підпис.
Lz4Archive(Lz4ArchiveSetting)
Ініціалізує нову інстанцію класу Aspose.Zip.Lz4.Lc4Архіви, підготовлені для компресії.
public Lz4Archive(Lz4ArchiveSetting settings = null)
Parameters
settings
Lz4ArchiveSetting
Створення складеного архіву.
Methods
Dispose()
Виконання завдань, визначених застосуванням, пов’язаних з звільненням, звільненням або відновленням нерухомих ресурсів.
public void Dispose()
Dispose(Бол)
Виконання завдань, визначених застосуванням, пов’язаних з звільненням, звільненням або відновленням нерухомих ресурсів.
protected virtual void Dispose(bool disposing)
Parameters
disposing
bool
Чи потрібно витрачати управляні ресурси.
Extract(стрічка)
Екстракт архіву до файлу шляхом.
public FileInfo Extract(string path)
Parameters
path
string
Якщо файл вже існує, він буде переписаний.
Returns
Інформація про витягнутий файл.
Exceptions
Потік джерела занадто короткий.
Помилкові байти знайдені під час декодування.
Ця версія LZ4 не підтримується.
Extract(Stream)
Витягніть архіви до наданого потоку.
public void Extract(Stream destination)
Parameters
destination
Stream
Достовірний маршрут - має бути написані.
Examples
using (var archive = new Lz4Archive("archive.lz4"))
{
archive.Extract(httpResponseStream);
}
Exceptions
destination’ does not support writing.
Потік джерела занадто короткий.
Помилкові байти знайдені під час декодування.
Ця версія LZ4 не підтримується.
Архів готується до композиції.
ExtractToDirectory(стрічка)
Витягує вміст архіву в наданий каталог.
public void ExtractToDirectory(string destinationDirectory)
Parameters
destinationDirectory
string
Шлях до каталогу для розміщення витягнутих файлів.
Remarks
Якщо каталог не існує, він буде створений.
Exceptions
destinationDirectory’ is null.
Наприклад, на платформах, заснованих на Windows, шляхи повинні бути менше 248 символів, а імена файлів повинні бути менше 260 символів.
Зателефонувач не має необхідного дозволу на доступ до існуючого каталогу.
Якщо каталог не існує, то шлях містить символ колону (:) який не є частиною етикетки диска (“C:”).
destinationDirectory’ is a zero-length string, contains only white space, or contains one or more invalid characters. You can query for invalid characters by using the System.IO.Path.GetInvalidPathChars method.-or- path is prefixed with, or contains, only a colon character (:).
Директива, зазначена шляхом, є файлом. -або- Назва мережі не відома.
Потік джерела занадто короткий.
Помилкові байти знайдені під час ініціалізації розшифрування.
Архів готується до композиції.
Open()
Відкриває архіви для екстракції і забезпечує потік з архівним вмістом.
public Stream Open()
Returns
Потік, що представляє зміст архіву.
Examples
Витягує архів і копіює витягнутий контент до потоку файлів.
using (var archive = new Lz4Archive("archive.lz4"))
{
using (var extracted = File.Create("data.bin"))
{
var unpacked = archive.Open();
byte[] b = new byte[8192];
int bytesRead;
while (0 < (bytesRead = unpacked.Read(b, 0, b.Length)))
extracted.Write(b, 0, bytesRead);
}
}
Ви можете скористатися методом Stream.CopyTo для .NET 4.0 і вище: unpacked.PopyTo(витягнуто);
Remarks
Читати з потоку, щоб отримати оригінальний вміст файлу. переглянути розділ Приклади.
Exceptions
Потік джерела занадто короткий.
Помилкові байти знайдені під час ініціалізації розшифрування.
Архів готується до композиції.
Save(Stream)
Збереже LZ4 архів до потоку, що надається.
public void Save(Stream output)
Parameters
output
Stream
Потік напряму.
Examples
using (FileStream lz4File = File.Open("archive.lz4", FileMode.Create))
{
using (var archive = new Lz4Archive())
{
archive.SetSource("data.bin");
archive.Save(lz4File);
}
}
Remarks
Вони повинні бути пошуковими.
Exceptions
output’ is null.
output’ is not writable.
Архів готується до екстракції. - або - Джерело не надано.
Save(FileInfo)
Зберегти LZ4 архіву до даного файлу призначення.
public void Save(FileInfo destination)
Parameters
destination
FileInfo
FileInfo, який буде відкритий як напрям призначення.
Examples
using (var archive = new Lz4Archive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save(new FileInfo("archive.lz4"));
}
Exceptions
Зателефонувач не має необхідного дозволу на відкриття destination".
Дорога файлу порожня або містить тільки білі простори.
Файл не знайдено.
Шлях до файлу читається тільки або є каталогом.
destination’ is null.
Визначений шлях недійсний, наприклад, перебування на безкартованому двигуні.
Файл вже відкритий.
Архів готується до екстракції.
Save(стрічка)
Зберегти архіви до даного файлу призначення.
public void Save(string destinationFileName)
Parameters
destinationFileName
string
Якщо назва файлу вказує на існуючий файл, він буде переписаний.
Examples
using (var archive = new LZ4Archive())
{
archive.SetSource("data.bin");
archive.Save("archive.lz4");
}
Exceptions
destinationFileName’ is null.
Замовник не має необхідного дозволу на доступ до
destinationFileName’ є порожнім, містить тільки білі простори, або містить недійсні символи.
Доступ до файлу destinationFileName’ відмовляється.
Визначений destinationFileName’, ім’я файлу, або обидва перевищують максимальну довжину, визначену системою. Наприклад, на платформах, заснованих на Windows, шляхи повинні бути менше 248 символів, а імена файлу повинні бути менше 260 символів.
Файл в destinationFileName’ містить колону (:) в середині смуги.
Архів готується до екстракції.
SetSource(Stream)
Налаштуйте контент, який повинен бути компресований в архіві.
public void SetSource(Stream source)
Parameters
source
Stream
Вхідний потік для архіву.
Examples
using (var archive = new Lz4Archive())
{
archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
archive.Save("archive.lz4");
}
Exceptions
Архів готується до екстракції.
SetSource(FileInfo)
Налаштуйте контент, який повинен бути компресований в архіві.
public void SetSource(FileInfo fileInfo)
Parameters
fileInfo
FileInfo
Посилання на файл, який повинен бути компресований.
Examples
Відкрийте файл з потоку і витягніть його в
using (var archive = new Lz4Archive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("archive.lz4");
}
Exceptions
Архів готується до екстракції.
SetSource(Створення TarFormat)
Налаштуйте контент, який повинен бути компресований в архіві.
public void SetSource(TarArchive tarArchive, TarFormat format = TarFormat.UsTar)
Parameters
tarArchive
TarArchive
Архів має бути компресований.
format
TarFormat
Визначте формат Tar Header.
Examples
using (var tarArchive = new TarArchive())
{
tarArchive.CreateEntry("first.bin", "data1.bin");
tarArchive.CreateEntry("second.bin", "data2.bin");
using (var lz4Archive = new Lz4Archive())
{
lz4Archive.SetSource(tarArchive);
lz4Archive.Save("archive.tar.lz4");
}
}
Remarks
Використовуйте цей метод для складання спільного архіву tar.lz4.
SetSource(стрічка)
Налаштуйте контент, який повинен бути компресований в архіві.
public void SetSource(string path)
Parameters
path
string
Шлях до файлу, щоб бути компресованим.
Examples
Відкрийте файл з файлу шляхом і витягніть його в
using (var archive = new Lz4Archive())
{
archive.SetSource("data.bin");
archive.Save("archive.lz4");
}
Exceptions
path’ is null.
Замовник не має необхідного дозволу на доступ до
path’ є порожнім, містить тільки білі простори, або містить недійсні символи.
Доступ до файлу path" відмовляється.
Наприклад, на платформах, заснованих на Windows, шляхи повинні бути менше 248 символів, а імена файлів повинні бути менше 260 символів.
Файл в path’ містить колону (:) в середині смуги.
Ця стаття готується до екстракції.