Class Bzip2Archive
Nom dels espais: Aspose.Zip.Bzip2 Assemblea: Aspose.Zip.dll (25.5.0)
Aquesta classe representa el fitxer d’arxiu bzip2. utilitzeu-lo per compondre o extreure arxius bzip2.
public class Bzip2Archive : IArchive, IDisposable, IArchiveFileEntryInheritance
Implements
IArchive , IDisposable , IArchiveFileEntry
Membres heretats
object.GetType() , object.MemberwiseClone() , object.ToString() , object.Equals(object?) , object.Equals(object?, object?) , object.ReferenceEquals(object?, object?) , object.GetHashCode()
Remarks
bzip2 comprimeix els arxius utilitzant el bloc de Burrows-Wheeler per ordenar l’algoritme de compressió de text, i la codificació de Huffman. Veure més: https://en.wikipedia.org/wiki/Bzip2
Constructors
Bzip2Archive()
Inicialitza una nova instància de la classe Aspose.Zip.Bzip2.Bzip2Arxiu preparat per a la compressi.
public Bzip2Archive()Examples
L’exemple següent mostra com comprimir un fitxer.
using (Bzip2Archive archive = new Bzip2Archive())
{
archive.SetSource("data.bin");
archive.Save("archive.bz2");
}Bzip2Archive(Projecció, Bzip2LoadOptions)
Inicialitza una nova instància de la classe Aspose.Zip.Bzip2.Bzip2Arxiu preparat per a la decompressi.
public Bzip2Archive(Stream sourceStream, Bzip2LoadOptions loadOptions = null)Parameters
sourceStream Stream
La font de l’arxiu.
loadOptions Bzip2LoadOptions
Les opcions per carregar arxius amb.
Examples
Obre un arxiu d’un corrent i extreure’l a un
var ms = new MemoryStream();
using (Bzip2Archive archive = new Bzip2Archive(File.OpenRead("archive.bz2")))
archive.Open().CopyTo(ms);Remarks
Aquest constructor no descomprimeix. Veure Aspose.Zip.Bzip2.Bzip2Archive.Open mètode per descomprimir.
Exceptions
Terminar el flux prematur.
Són errades les signatures.
Bzip2Archive(Llistat, Bzip2LoadOptions)
Inicialitza una nova instància de la classe Aspose.Zip.Bzip2.Bzip2Arxiu preparat per a la decompressi.
public Bzip2Archive(string path, Bzip2LoadOptions loadOptions = null)Parameters
path string
El camí cap a l’arxiu.
loadOptions Bzip2LoadOptions
Les opcions per carregar arxius amb.
Examples
Obre un arxiu del fitxer per ruta i extreure-lo a un
var ms = new MemoryStream();
using (Bzip2Archive archive = new Bzip2Archive("archive.bz2"))
archive.Open().CopyTo(ms);Remarks
Aquest constructor no descomprimeix. Veure Aspose.Zip.Bzip2.Bzip2Archive.Open mètode per descomprimir.
Exceptions
path’ is null.
El client no té el permís d’accés requerit.
La path’ és buida, només conté espais blancs, o conté caràcters invalidats.
L’accés al fitxer path" es nega.
El nom de fitxer especificat path", o tots dos superen la longitud màxima definida pel sistema. per exemple, en les plataformes basades en Windows, els passos han de ser menys de 248 caràcters, i els noms de fitxer han de ser menys de 260 caràcters.
El fitxer a path’ conté una columna (:) al mig de la cadena.
El fitxer no es troba.
La ruta especificada és invalidada, com per exemple estar en un disc no mapat.
El fitxer ja està obert.
Terminar el flux prematur.
Són errades les signatures.
Methods
Dispose()
Realitza tasques definides per aplicació associades amb el lliurament, el lliurament o la restauració de recursos no gestionats.
public void Dispose()Dispose(La botiga)
Realitza tasques definides per aplicació associades amb el lliurament, el lliurament o la restauració de recursos no gestionats.
protected virtual void Dispose(bool disposing)Parameters
disposing bool
S’han de disposar de recursos gestionats.
Extract(Stream)
L’arxiu s’extreu al flux proporcionat.
public void Extract(Stream destination)Parameters
destination Stream
La destinació ha de ser escrita.
Examples
using (Bzip2Archive archive = new Bzip2Archive("archive.bz2"))
{
archive.Extract(httpResponseStream);
}Exceptions
destination’ does not support writing.
Extract(Tàrrega)
Extreure l’arxiu al fitxer per cam.
public FileInfo Extract(string path)Parameters
path string
El camí a l’arxiu de destinació. Si el fitxer ja existeix, serà sobreescrit.
Returns
Informació sobre el fitxer extraït.
Exceptions
path’ is null.
El client no té el permís d’accés requerit.
La path’ és buida, només conté espais blancs, o conté caràcters invalidats.
L’accés al fitxer path" es nega.
El nom de fitxer especificat path", o tots dos superen la longitud màxima definida pel sistema. per exemple, en les plataformes basades en Windows, els passos han de ser menys de 248 caràcters, i els noms de fitxer han de ser menys de 260 caràcters.
El fitxer a path’ conté una columna (:) al mig de la cadena.
El fitxer no es troba.
La ruta especificada és invalidada, com per exemple estar en un disc no mapat.
El fitxer ja està obert.
ExtractToDirectory(Tàrrega)
Extreu el contingut de l’arxiu a la direcció proporcionada.
public void ExtractToDirectory(string destinationDirectory)Parameters
destinationDirectory string
El camí a la direcció per col·locar els arxius extraïts.
Remarks
Si la direcció no existeix, es crear.
Exceptions
destinationDirectory’ is null.
Per exemple, en les plataformes basades en Windows, els camins han de ser menys de 248 caràcters i els noms de fitxers han de ser menys de 260 caràcters.
El sol·licitant no té l’autorització necessària per accedir a la direcció existent.
Si el directori no existeix, el recorregut conté un caràcter colon (:) que no forma part d’una etiqueta de disc (“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 (:).
El directori especificat per ruta és un arxiu. -o- El nom de la xarxa no és conegut.
Open()
Obre l’arxiu per a l’extracció i proporciona un flux amb contingut d’arxiu.
public Stream Open()Returns
El corrent que representa el contingut de l’arxiu.
Examples
Utilitzaci:Stream decompressed = archive.Open();
.NET 4.0 i superior - utilitzar el mètode Stream.CopyTo:decompressed.CopyTo(httpResponse.OutputStream)
.NET 3.5 i abans - copiar els bytes manualment:
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
El flux de destinaci.
saveOptions Bzip2SaveOptions
Opcions per a l’emmagatzematge d’un arxiu bzip2. si no s’especifica, s’utilitzaria la mida de bloc de 900 Kb.
Examples
Escriu les dades comprimides al flux de resposta HTTP.
using (var archive = new Bzip2Archive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save(httpResponse.OutputStream);
}Remarks
Ha de ser escriïble.
Exceptions
La font de dades que s’arxiu no s’ha proporcionat.
outputStream’ is not writable.
La font de fitxers és només llegit o és un directori.
La ruta de font del fitxer especificada és invalidada, per exemple, estar en un disc no mapat.
La font del fitxer ja està oberta.
Save(Llistat, Bzip2SaveOptions)
Salva l’arxiu a un arxiu de destinació proporcionat.
public void Save(string destinationFileName, Bzip2SaveOptions saveOptions = null)Parameters
destinationFileName string
El camí de l’arxiu que s’ha de crear. Si el nom de fitxer especificat indica un fitxer existent, serà sobreescrit.
saveOptions Bzip2SaveOptions
Opcions per a l’emmagatzematge d’un arxiu bzip2. si no s’especifica, s’utilitzaria la mida de bloc de 900 Kb.
Examples
Escriu les dades comprimides al fitxer.
using (var archive = new Bzip2Archive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("data.bz2");
}Exceptions
destinationFileName’ is null.
El client no té el permís d’accés requerit.
El destinationFileName’ és buit, només conté espais blancs, o conté caràcters invalidats.
L’accés al fitxer destinationFileName’ és negat.
El nom de fitxer especificat destinationFileName, o ambdós superen la longitud màxima definida pel sistema. Per exemple, en les plataformes basades en Windows, els camins han de ser menys de 248 caràcters, i els noms de fitxer han de ser menys de 260 caràcters.
El fitxer a destinationFileName’ conté una columna (:) al mig de la cadena.
SetSource(Stream)
Establir el contingut per a ser comprès dins de l’arxiu.
public void SetSource(Stream source)Parameters
source Stream
El flux d’entrada per a l’arxiu.
Examples
using (Bzip2Archive archive = new Bzip2Archive())
{
archive.SetSource(new MemoryStream(new byte[] { 0x00,0xFF }));
archive.Save("archive.bz2");
}SetSource(FileInfo)
Establir el contingut per a ser comprès dins de l’arxiu.
public void SetSource(FileInfo fileInfo)Parameters
fileInfo FileInfo
La referència a un arxiu a ser comprès.
Examples
using (Bzip2Archive archive = new Bzip2Archive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("archive.bz2");
}SetSource(Tàrrega)
Establir el contingut per a ser comprès dins de l’arxiu.
public void SetSource(string path)Parameters
path string
El camí per a arxiu per a ser comprès.
Examples
using (Bzip2Archive archive = new Bzip2Archive())
{
archive.SetSource("data.bin");
archive.Save("archive.bz2");
}Exceptions
path’ is null.
El client no té el permís d’accés requerit.
La path’ és buida, només conté espais blancs, o conté caràcters invalidats.
L’accés al fitxer path" es nega.
El nom de fitxer especificat path", o tots dos superen la longitud màxima definida pel sistema. per exemple, en les plataformes basades en Windows, els passos han de ser menys de 248 caràcters, i els noms de fitxer han de ser menys de 260 caràcters.
El fitxer a path’ conté una columna (:) al mig de la cadena.
SetSource(Tàrrega, Tàrrega)
Establir el contingut per a ser comprès dins de l’arxiu.
public void SetSource(TarArchive tarArchive, TarFormat format = TarFormat.UsTar)Parameters
tarArchive TarArchive
Arxiu per a ser comprès.
format TarFormat
Defineix el format 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
Utilitza aquest mètode per compondre l’arxiu conjunta tar.bz2.
SetSource(Arxiu de Cpio, CpioFormat)
Establir el contingut per a ser comprès dins de l’arxiu.
public void SetSource(CpioArchive cpioArchive, CpioFormat format = CpioFormat.OldAscii)Parameters
cpioArchive CpioArchive
L’arxiu de Cpio s’ha de comprimir.
format CpioFormat
Defineix el format de 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
Utilitza aquest mètode per compondre l’arxiu conjunta cpio.bz2.
