Class Lz4Archive
Името на пространството: Aspose.Zip.Lz4 Асамблея: Aspose.Zip.dll (25.5.0)
Този клас представлява LZ4 архивен файл. Използвайте го, за да екстрактирате или съставите LЗ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
code class=“paramref”>sourceStream'
sourceStream’ is null.
sourceStream’ is too short.
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
path’ is null.
Клиентът няма необходимата разрешение за достъп.
Пътят " е празен, съдържа само бели пространства или съдържа невалидни знаци.
code class=“paramref”>path.
code class=“paramref”>path", име на файла, или и двете надвишават максималната дължина, определена от системата. например, на платформи, базирани на Windows, пътеките трябва да са по-малко от 248 знака, а имената на файла трябва да са по-малко от 260.
code class=“paramref”>path.
Филмът е твърде кратък.
Данните в файла имат погрешен подпис.
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
Информация за извлечен файл.
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.KopyTo(извлечен);
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’ 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.
Клиентът няма необходимата разрешение за достъп.
code class=“paramref”>destinationFileName.
code class=“paramref”>destinationFileName.
code class=“paramref”>destinationFileName’, име на файла, или и двете надвишават максималната дължина, определена от системата. например, на платформи, базирани на Windows, пътеките трябва да са по-малко от 248 символа, а имената на файла трябва да са по-малко от 260.
code class=“paramref”>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.
Клиентът няма необходимата разрешение за достъп.
Пътят " е празен, съдържа само бели пространства или съдържа невалидни знаци.
code class=“paramref”>path.
code class=“paramref”>path", име на файла, или и двете надвишават максималната дължина, определена от системата. например, на платформи, базирани на Windows, пътеките трябва да са по-малко от 248 знака, а имената на файла трябва да са по-малко от 260.
code class=“paramref”>path.
Архивът е подготвен за екстракция.