Class Lz4Archive

Class Lz4Archive

Название пространства: Aspose.Zip.Lz4 Ассоциация: Aspose.Zip.dll (25.5.0)

Этот класс представляет LZ4 архивный файл. Используйте его для извлечения или составления архивов.

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

Указанный path", имя файла, или оба превышают максимальную длину, установленную системой. Например, на платформах на базе 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.KopyTo(извлечен);

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(ТАРФОРМАТ ТАРФОРМАТ)

Составьте контент, который должен быть компрессирован в архиве.

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

Указанный path", имя файла, или оба превышают максимальную длину, установленную системой. Например, на платформах на базе Windows, пути должны быть менее 248 символов, а имена файлов должны быть менее 260 символов.

NotSupportedException

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

InvalidOperationException

Этот архив подготавливается для экстракции.

 Русский