Class Lz4Archive

Class Lz4Archive

Названий на: Aspose.Zip.Lz4 Асамблея: Aspose.Zip.dll (25.5.0)

Цей клас являє собою файл архіву LZ4. Використовуйте його для екстракції або складання архівів ЛЗ4.

public class Lz4Archive : IArchive, IDisposable, IArchiveFileEntry

Inheritance

object Lz4Archive

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

ArgumentException

Не можна читати з sourceStream'

ArgumentNullException

sourceStream’ is null.

EndOfStreamException

sourceStream’ is too short.

InvalidDataException

У 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

ArgumentNullException

path’ is null.

SecurityException

Замовник не має необхідного дозволу на доступ до

ArgumentException

path’ є порожнім, містить тільки білі простори, або містить недійсні символи.

UnauthorizedAccessException

Доступ до файлу path" відмовляється.

PathTooLongException

Наприклад, на платформах, заснованих на Windows, шляхи повинні бути менше 248 символів, а імена файлів повинні бути менше 260 символів.

NotSupportedException

Файл в path’ містить колону (:) в середині смуги.

EndOfStreamException

Файл дуже короткий.

InvalidDataException

Дані, що містяться в файлі, мають неправильний підпис.

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

FileInfo

Інформація про витягнутий файл.

Exceptions

EndOfStreamException

Потік джерела занадто короткий.

InvalidDataException

Помилкові байти знайдені під час декодування.

NotSupportedException

Ця версія LZ4 не підтримується.

Extract(Stream)

Витягніть архіви до наданого потоку.

public void Extract(Stream destination)

Parameters

destination Stream

Достовірний маршрут - має бути написані.

Examples

using (var archive = new Lz4Archive("archive.lz4"))
{
     archive.Extract(httpResponseStream);
}

Exceptions

ArgumentException

destination’ does not support writing.

EndOfStreamException

Потік джерела занадто короткий.

InvalidDataException

Помилкові байти знайдені під час декодування.

NotSupportedException

Ця версія LZ4 не підтримується.

InvalidOperationException

Архів готується до композиції.

ExtractToDirectory(стрічка)

Витягує вміст архіву в наданий каталог.

public void ExtractToDirectory(string destinationDirectory)

Parameters

destinationDirectory string

Шлях до каталогу для розміщення витягнутих файлів.

Remarks

Якщо каталог не існує, він буде створений.

Exceptions

ArgumentNullException

destinationDirectory’ is null.

PathTooLongException

Наприклад, на платформах, заснованих на Windows, шляхи повинні бути менше 248 символів, а імена файлів повинні бути менше 260 символів.

SecurityException

Зателефонувач не має необхідного дозволу на доступ до існуючого каталогу.

NotSupportedException

Якщо каталог не існує, то шлях містить символ колону (:) який не є частиною етикетки диска (“C:”).

ArgumentException

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 (:).

IOException

Директива, зазначена шляхом, є файлом. -або- Назва мережі не відома.

EndOfStreamException

Потік джерела занадто короткий.

InvalidDataException

Помилкові байти знайдені під час ініціалізації розшифрування.

InvalidOperationException

Архів готується до композиції.

Open()

Відкриває архіви для екстракції і забезпечує потік з архівним вмістом.

public Stream Open()

Returns

Stream

Потік, що представляє зміст архіву.

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

EndOfStreamException

Потік джерела занадто короткий.

InvalidDataException

Помилкові байти знайдені під час ініціалізації розшифрування.

InvalidOperationException

Архів готується до композиції.

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

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

InvalidOperationException

Архів готується до екстракції. - або - Джерело не надано.

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

SecurityException

Зателефонувач не має необхідного дозволу на відкриття destination".

ArgumentException

Дорога файлу порожня або містить тільки білі простори.

FileNotFoundException

Файл не знайдено.

UnauthorizedAccessException

Шлях до файлу читається тільки або є каталогом.

ArgumentNullException

destination’ is null.

DirectoryNotFoundException

Визначений шлях недійсний, наприклад, перебування на безкартованому двигуні.

IOException

Файл вже відкритий.

InvalidOperationException

Архів готується до екстракції.

Save(стрічка)

Зберегти архіви до даного файлу призначення.

public void Save(string destinationFileName)

Parameters

destinationFileName string

Якщо назва файлу вказує на існуючий файл, він буде переписаний.

Examples

using (var archive = new LZ4Archive())
{
    archive.SetSource("data.bin");
    archive.Save("archive.lz4");
}

Exceptions

ArgumentNullException

destinationFileName’ is null.

SecurityException

Замовник не має необхідного дозволу на доступ до

ArgumentException

destinationFileName’ є порожнім, містить тільки білі простори, або містить недійсні символи.

UnauthorizedAccessException

Доступ до файлу destinationFileName’ відмовляється.

PathTooLongException

Визначений destinationFileName’, ім’я файлу, або обидва перевищують максимальну довжину, визначену системою. Наприклад, на платформах, заснованих на Windows, шляхи повинні бути менше 248 символів, а імена файлу повинні бути менше 260 символів.

NotSupportedException

Файл в destinationFileName’ містить колону (:) в середині смуги.

InvalidOperationException

Архів готується до екстракції.

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

InvalidOperationException

Архів готується до екстракції.

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

InvalidOperationException

Архів готується до екстракції.

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

ArgumentNullException

path’ is null.

SecurityException

Замовник не має необхідного дозволу на доступ до

ArgumentException

path’ є порожнім, містить тільки білі простори, або містить недійсні символи.

UnauthorizedAccessException

Доступ до файлу path" відмовляється.

PathTooLongException

Наприклад, на платформах, заснованих на Windows, шляхи повинні бути менше 248 символів, а імена файлів повинні бути менше 260 символів.

NotSupportedException

Файл в path’ містить колону (:) в середині смуги.

InvalidOperationException

Ця стаття готується до екстракції.

 Українська