Class Bzip2Archive
Названий на: Aspose.Zip.Bzip2 Асамблея: Aspose.Zip.dll (25.5.0)
Цей клас являє собою файл архіву bzip2. Використовуйте його для композиції або екстракту архівів bzip2.
public class Bzip2Archive : 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()
Remarks
bzip2 компресує файли за допомогою блоку Burrows-Wheeler, що класифікує алгоритм компресії тексту, і кодування Huffman.
Constructors
Bzip2Archive()
Ініціалює новий приклад класу Aspose.Zip.Bzip2.Bzip2Archive, підготовленого для компресії.
public Bzip2Archive()
Examples
Наступний приклад показує, як компресувати файл.
using (Bzip2Archive archive = new Bzip2Archive())
{
archive.SetSource("data.bin");
archive.Save("archive.bz2");
}
Bzip2Archive(Завантажити Bzip2LoadOptions)
Ініціалює новий приклад класу Aspose.Zip.Bzip2.Bzip2Archive, підготовлений для декомпресії.
public Bzip2Archive(Stream sourceStream, Bzip2LoadOptions loadOptions = null)
Parameters
sourceStream
Stream
Джерело архіву.
loadOptions
Bzip2LoadOptions
Вибір варіантів завантаження архіву.
Examples
Відкрийте файл з потоку і витягніть його в
var ms = new MemoryStream();
using (Bzip2Archive archive = new Bzip2Archive(File.OpenRead("archive.bz2")))
archive.Open().CopyTo(ms);
Remarks
Цей конструктор не декомпресує. переглянути Aspose.Zip.Bzip2.Bzip2Archive.Open метод для декомпресії.
Exceptions
Ранній потік закінчується.
Помилковий підпис байтів.
Bzip2Archive(Завантажити Bzip2LoadOptions)
Ініціалює новий приклад класу Aspose.Zip.Bzip2.Bzip2Archive, підготовлений для декомпресії.
public Bzip2Archive(string path, Bzip2LoadOptions loadOptions = null)
Parameters
path
string
Шлях до архіву.
loadOptions
Bzip2LoadOptions
Вибір варіантів завантаження архіву.
Examples
Відкрийте файл з файлу шляхом і витягніть його в
var ms = new MemoryStream();
using (Bzip2Archive archive = new Bzip2Archive("archive.bz2"))
archive.Open().CopyTo(ms);
Remarks
Цей конструктор не декомпресує. переглянути Aspose.Zip.Bzip2.Bzip2Archive.Open метод для декомпресії.
Exceptions
path’ is null.
Замовник не має необхідного дозволу на доступ.
path’ є порожнім, містить тільки білі простори, або містить недійсні символи.
Доступ до файлу path" відмовляється.
Наприклад, на платформах, заснованих на Windows, шляхи повинні бути менше 248 символів, а імена файлів повинні бути менше 260 символів.
Файл в path’ містить колону (:) в середині смуги.
Файл не знайдено.
Визначений шлях недійсний, наприклад, перебування на безкартованому двигуні.
Файл вже відкритий.
Ранній потік закінчується.
Помилковий підпис байтів.
Methods
Dispose()
Виконання завдань, визначених застосуванням, пов’язаних з звільненням, звільненням або відновленням нерухомих ресурсів.
public void Dispose()
Dispose(Бол)
Виконання завдань, визначених застосуванням, пов’язаних з звільненням, звільненням або відновленням нерухомих ресурсів.
protected virtual void Dispose(bool disposing)
Parameters
disposing
bool
Чи потрібно витрачати управляні ресурси.
Extract(Stream)
Витягніть архіви до наданого потоку.
public void Extract(Stream destination)
Parameters
destination
Stream
Достовірний маршрут - має бути написані.
Examples
using (Bzip2Archive archive = new Bzip2Archive("archive.bz2"))
{
archive.Extract(httpResponseStream);
}
Exceptions
destination’ does not support writing.
Extract(стрічка)
Екстракт архіву до файлу шляхом.
public FileInfo Extract(string path)
Parameters
path
string
Якщо файл вже існує, він буде переписаний.
Returns
Інформація про витягнутий файл.
Exceptions
path’ is null.
Замовник не має необхідного дозволу на доступ.
path’ є порожнім, містить тільки білі простори, або містить недійсні символи.
Доступ до файлу path" відмовляється.
Наприклад, на платформах, заснованих на Windows, шляхи повинні бути менше 248 символів, а імена файлів повинні бути менше 260 символів.
Файл в path’ містить колону (:) в середині смуги.
Файл не знайдено.
Визначений шлях недійсний, наприклад, перебування на безкартованому двигуні.
Файл вже відкритий.
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
Використання :Stream decompressed = archive.Open();
.NET 4.0 і вище - використовуйте метод Stream.CopyTo:decompressed.CopyTo(httpResponse.OutputStream)
.NET 3.5 і раніше - копіюйте байти вручну:
byte[] buffer = new byte[8192];
int bytesRead;
while (0 < (bytesRead = decompressed.Read(buffer, 0, buffer.Length)))
fileStream.Write(buffer, 0, bytesRead);
```</p>
#### Remarks
Read from the stream to get the original content of the file. See examples section.
### <a id="Aspose_Zip_Bzip2_Bzip2Archive_Save_System_IO_Stream_Aspose_Zip_Bzip2_Bzip2SaveOptions_"></a> Save\(Stream, Bzip2SaveOptions\)
Saves archive to the stream provided.
```csharp
public void Save(Stream outputStream, Bzip2SaveOptions saveOptions = null)
Parameters
outputStream
Stream
Потік напряму.
saveOptions
Bzip2SaveOptions
Варіанти для збереження архіву bzip2. якщо не зазначено, буде використано розмір блоку 900 Кб.
Examples
Напишіть компресовані дані до потоку відповіді http.
using (var archive = new Bzip2Archive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save(httpResponse.OutputStream);
}
Remarks
Вона повинна бути письмовою.
Exceptions
Джерело даних, які потрібно зберігати, не надано.
outputStream’ is not writable.
Джерело файлу читається або є каталогом.
Визначений шлях джерела файлу недійсний, наприклад, перебування на безкартованому диску.
Джерело файлу вже відкрито.
Save(Завантажити Bzip2SaveOptions)
Зберегти архіви до даного файлу призначення.
public void Save(string destinationFileName, Bzip2SaveOptions saveOptions = null)
Parameters
destinationFileName
string
Якщо назва файлу вказує на існуючий файл, він буде переписаний.
saveOptions
Bzip2SaveOptions
Варіанти для збереження архіву bzip2. якщо не зазначено, буде використано розмір блоку 900 Кб.
Examples
Напишіть компресовані дані до файлу.
using (var archive = new Bzip2Archive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("data.bz2");
}
Exceptions
destinationFileName’ is null.
Замовник не має необхідного дозволу на доступ.
destinationFileName’ є порожнім, містить тільки білі простори, або містить недійсні символи.
Доступ до файлу destinationFileName’ відмовляється.
Визначений destinationFileName’, ім’я файлу, або обидва перевищують максимальну довжину, визначену системою. Наприклад, на платформах, заснованих на Windows, шляхи повинні бути менше 248 символів, а імена файлу повинні бути менше 260 символів.
Файл в destinationFileName’ містить колону (:) в середині смуги.
SetSource(Stream)
Налаштуйте контент, який повинен бути компресований в архіві.
public void SetSource(Stream source)
Parameters
source
Stream
Вхідний потік для архіву.
Examples
using (Bzip2Archive archive = new Bzip2Archive())
{
archive.SetSource(new MemoryStream(new byte[] { 0x00,0xFF }));
archive.Save("archive.bz2");
}
SetSource(FileInfo)
Налаштуйте контент, який повинен бути компресований в архіві.
public void SetSource(FileInfo fileInfo)
Parameters
fileInfo
FileInfo
Посилання на файл, який повинен бути компресований.
Examples
using (Bzip2Archive archive = new Bzip2Archive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("archive.bz2");
}
SetSource(стрічка)
Налаштуйте контент, який повинен бути компресований в архіві.
public void SetSource(string path)
Parameters
path
string
Шлях до файлу, щоб бути компресованим.
Examples
using (Bzip2Archive archive = new Bzip2Archive())
{
archive.SetSource("data.bin");
archive.Save("archive.bz2");
}
Exceptions
path’ is null.
Замовник не має необхідного дозволу на доступ.
path’ є порожнім, містить тільки білі простори, або містить недійсні символи.
Доступ до файлу path" відмовляється.
Наприклад, на платформах, заснованих на Windows, шляхи повинні бути менше 248 символів, а імена файлів повинні бути менше 260 символів.
Файл в path’ містить колону (:) в середині смуги.
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 bzippedArchive = new Bzip2Archive())
{
bzippedArchive.SetSource(tarArchive);
bzippedArchive.Save("archive.tar.bz2");
}
}
Remarks
Використовуйте цей метод для складання спільного архіву tar.bz2.
SetSource(Створення Cpio, CpioFormat)
Налаштуйте контент, який повинен бути компресований в архіві.
public void SetSource(CpioArchive cpioArchive, CpioFormat format = CpioFormat.OldAscii)
Parameters
cpioArchive
CpioArchive
Архів для компресії.
format
CpioFormat
Визначте формат Cpio Header.
Examples
using (var cpioArchive = new CpioArchive())
{
cpioArchive.CreateEntry("first.bin", "data1.bin");
cpioArchive.CreateEntry("second.bin", "data2.bin");
using (var bzippedArchive = new Bzip2Archive())
{
bzippedArchive.SetSource(cpioArchive);
bzippedArchive.Save("archive.cpio.bz2");
}
}
Remarks
Використовуйте цей метод для складання спільного архіву cpio.bz2.