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 кодиране. виж повече: 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
Бързият край на потока.
Неправилно подписване на байтове.
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.
Призователят няма изискваното разрешение за достъп.
Пътят " е празен, съдържа само бели пространства или съдържа невалидни знаци.
code class=“paramref”>path.
code class=“paramref”>path", име на файла, или и двете надвишават максималната дължина, определена от системата. например, на платформи, базирани на Windows, пътеките трябва да са по-малко от 248 знака, а имената на файла трябва да са по-малко от 260.
code class=“paramref”>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.
Призователят няма изискваното разрешение за достъп.
Пътят " е празен, съдържа само бели пространства или съдържа невалидни знаци.
code class=“paramref”>path.
code class=“paramref”>path", име на файла, или и двете надвишават максималната дължина, определена от системата. например, на платформи, базирани на Windows, пътеките трябва да са по-малко от 248 знака, а имената на файла трябва да са по-малко от 260.
code class=“paramref”>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 Kb.
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 Kb.
Examples
Напишете компресирани данни за файлове.
using (var archive = new Bzip2Archive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("data.bz2");
}
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 (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.
Призователят няма изискваното разрешение за достъп.
Пътят " е празен, съдържа само бели пространства или съдържа невалидни знаци.
code class=“paramref”>path.
code class=“paramref”>path", име на файла, или и двете надвишават максималната дължина, определена от системата. например, на платформи, базирани на Windows, пътеките трябва да са по-малко от 248 знака, а имената на файла трябва да са по-малко от 260.
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 архив.