Class Lz4Archive
Название пространства: Aspose.Zip.Lz4 Ассоциация: Aspose.Zip.dll (25.5.0)
Этот класс представляет LZ4 архивный файл. Используйте его для извлечения или составления архивов.
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" отказывается.
Указанный 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.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".
Путь файла пустая или содержит только белые пространства.
Файл не найден.
Путь к файлу читается только или является каталогом.
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(ТАРФОРМАТ ТАРФОРМАТ)
Составьте контент, который должен быть компрессирован в архиве.
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" отказывается.
Указанный path", имя файла, или оба превышают максимальную длину, установленную системой. Например, на платформах на базе Windows, пути должны быть менее 248 символов, а имена файлов должны быть менее 260 символов.
Файл в path’ содержит колону (:) в середине строки.
Этот архив подготавливается для экстракции.