Class Lz4Archive

Class Lz4Archive

Името на пространството: Aspose.Zip.Lz4 Асамблея: Aspose.Zip.dll (25.5.0)

Този клас представлява LZ4 архивен файл. Използвайте го, за да екстрактирате или съставите LЗ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

code class=“paramref”>sourceStream'

ArgumentNullException

sourceStream’ is null.

EndOfStreamException

sourceStream’ is too short.

InvalidDataException

The 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

Пътят " е празен, съдържа само бели пространства или съдържа невалидни знаци.

UnauthorizedAccessException

code class=“paramref”>path.

PathTooLongException

code class=“paramref”>path", име на файла, или и двете надвишават максималната дължина, определена от системата. например, на платформи, базирани на Windows, пътеките трябва да са по-малко от 248 знака, а имената на файла трябва да са по-малко от 260.

NotSupportedException

code class=“paramref”>path.

EndOfStreamException

Филмът е твърде кратък.

InvalidDataException

Данните в файла имат погрешен подпис.

Lz4Archive(Lz4ArchiveSetting)

Иницијализира нова инстанция на класата Aspose.Zip.Lz4.Lc4Archive, подготвена за компресиране.

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

Призователят не разполага с изискваното разрешение да отвори дестинацията .

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

code class=“paramref”>destinationFileName.

UnauthorizedAccessException

code class=“paramref”>destinationFileName.

PathTooLongException

code class=“paramref”>destinationFileName’, име на файла, или и двете надвишават максималната дължина, определена от системата. например, на платформи, базирани на Windows, пътеките трябва да са по-малко от 248 символа, а имената на файла трябва да са по-малко от 260.

NotSupportedException

code class=“paramref”>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

Пътят " е празен, съдържа само бели пространства или съдържа невалидни знаци.

UnauthorizedAccessException

code class=“paramref”>path.

PathTooLongException

code class=“paramref”>path", име на файла, или и двете надвишават максималната дължина, определена от системата. например, на платформи, базирани на Windows, пътеките трябва да са по-малко от 248 знака, а имената на файла трябва да са по-малко от 260.

NotSupportedException

code class=“paramref”>path.

InvalidOperationException

Архивът е подготвен за екстракция.

 Български