Class Bzip2Archive

Class Bzip2Archive

Названий на: Aspose.Zip.Bzip2 Асамблея: Aspose.Zip.dll (25.5.0)

Цей клас являє собою файл архіву bzip2. Використовуйте його для композиції або екстракту архівів bzip2.

public class Bzip2Archive : IArchive, IDisposable, IArchiveFileEntry

Inheritance

object Bzip2Archive

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

EndOfStreamException

Ранній потік закінчується.

InvalidDataException

Помилковий підпис байтів.

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

ArgumentNullException

path’ is null.

SecurityException

Замовник не має необхідного дозволу на доступ.

ArgumentException

path’ є порожнім, містить тільки білі простори, або містить недійсні символи.

UnauthorizedAccessException

Доступ до файлу path" відмовляється.

PathTooLongException

Наприклад, на платформах, заснованих на Windows, шляхи повинні бути менше 248 символів, а імена файлів повинні бути менше 260 символів.

NotSupportedException

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

FileNotFoundException

Файл не знайдено.

DirectoryNotFoundException

Визначений шлях недійсний, наприклад, перебування на безкартованому двигуні.

IOException

Файл вже відкритий.

EndOfStreamException

Ранній потік закінчується.

InvalidDataException

Помилковий підпис байтів.

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

ArgumentException

destination’ does not support writing.

Extract(стрічка)

Екстракт архіву до файлу шляхом.

public FileInfo Extract(string path)

Parameters

path string

Якщо файл вже існує, він буде переписаний.

Returns

FileInfo

Інформація про витягнутий файл.

Exceptions

ArgumentNullException

path’ is null.

SecurityException

Замовник не має необхідного дозволу на доступ.

ArgumentException

path’ є порожнім, містить тільки білі простори, або містить недійсні символи.

UnauthorizedAccessException

Доступ до файлу path" відмовляється.

PathTooLongException

Наприклад, на платформах, заснованих на Windows, шляхи повинні бути менше 248 символів, а імена файлів повинні бути менше 260 символів.

NotSupportedException

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

FileNotFoundException

Файл не знайдено.

DirectoryNotFoundException

Визначений шлях недійсний, наприклад, перебування на безкартованому двигуні.

IOException

Файл вже відкритий.

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

Директива, зазначена шляхом, є файлом. -або- Назва мережі не відома.

Open()

Відкриває архіви для екстракції і забезпечує потік з архівним вмістом.

public Stream Open()

Returns

Stream

Потік, що представляє зміст архіву.

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

InvalidOperationException

Джерело даних, які потрібно зберігати, не надано.

ArgumentException

outputStream’ is not writable.

UnauthorizedAccessException

Джерело файлу читається або є каталогом.

DirectoryNotFoundException

Визначений шлях джерела файлу недійсний, наприклад, перебування на безкартованому диску.

IOException

Джерело файлу вже відкрито.

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

ArgumentNullException

destinationFileName’ is null.

SecurityException

Замовник не має необхідного дозволу на доступ.

ArgumentException

destinationFileName’ є порожнім, містить тільки білі простори, або містить недійсні символи.

UnauthorizedAccessException

Доступ до файлу destinationFileName’ відмовляється.

PathTooLongException

Визначений destinationFileName’, ім’я файлу, або обидва перевищують максимальну довжину, визначену системою. Наприклад, на платформах, заснованих на Windows, шляхи повинні бути менше 248 символів, а імена файлу повинні бути менше 260 символів.

NotSupportedException

Файл в 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

ArgumentNullException

path’ is null.

SecurityException

Замовник не має необхідного дозволу на доступ.

ArgumentException

path’ є порожнім, містить тільки білі простори, або містить недійсні символи.

UnauthorizedAccessException

Доступ до файлу path" відмовляється.

PathTooLongException

Наприклад, на платформах, заснованих на Windows, шляхи повинні бути менше 248 символів, а імена файлів повинні бути менше 260 символів.

NotSupportedException

Файл в 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.

 Українська