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 кодиране. виж повече: https://en.wikipedia.org/wiki/Bzip2

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

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

UnauthorizedAccessException

code class=“paramref”>path.

PathTooLongException

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

NotSupportedException

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

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

UnauthorizedAccessException

code class=“paramref”>path.

PathTooLongException

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

NotSupportedException

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

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 Kb.

Examples

Напишете компресирани данни за файлове.

using (var archive = new Bzip2Archive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save("data.bz2");
}

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.

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

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

UnauthorizedAccessException

code class=“paramref”>path.

PathTooLongException

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

NotSupportedException

code class=“paramref”>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(CpioArchive и 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 архив.

 Български