Class Bzip2Archive
Numele spaţiului: Aspose.Zip.Bzip2 Asamblare: Aspose.Zip.dll (25.5.0)
Această clasă reprezintă fișierul de arhivă bzip2. utilizați-l pentru a compune sau extrage arhivele bzip2.
public class Bzip2Archive : IArchive, IDisposable, IArchiveFileEntryInheritance
Implements
IArchive , IDisposable , IArchiveFileEntry
Membrii moștenitori
object.GetType() , object.MemberwiseClone() , object.ToString() , object.Equals(object?) , object.Equals(object?, object?) , object.ReferenceEquals(object?, object?) , object.GetHashCode()
Remarks
bzip2 comprime fișierele folosind algoritmul de compresie text Burrows-Wheeler, și codificarea Huffman. Vezi mai multe: https://en.wikipedia.org/wiki/Bzip2
Constructors
Bzip2Archive()
Inițializează o nouă instanță a clasei Aspose.Zip.Bzip2.Bzip2Archivă pregătită pentru compresie.
public Bzip2Archive()Examples
Următorul exemplu arată cum să compresezi un fișier.
using (Bzip2Archive archive = new Bzip2Archive())
{
archive.SetSource("data.bin");
archive.Save("archive.bz2");
}Bzip2Archive(Cuvânt cheie: Bzip2LoadOptions)
Inițializează o nouă instanță a clasei Aspose.Zip.Bzip2.Bzip2Arhivă pregătită pentru decompresie.
public Bzip2Archive(Stream sourceStream, Bzip2LoadOptions loadOptions = null)Parameters
sourceStream Stream
Sursă a arhivelor.
loadOptions Bzip2LoadOptions
Opțiunile de încărcare a arhivelor cu.
Examples
Deschideți un arhiv dintr-un flux și extrageți-l la un
var ms = new MemoryStream();
using (Bzip2Archive archive = new Bzip2Archive(File.OpenRead("archive.bz2")))
archive.Open().CopyTo(ms);Remarks
Acest constructor nu decomprime. a se vedea Aspose.Zip.Bzip2.Bzip2Archive.Metoda deschisă pentru decomprimare.
Exceptions
Încheierea curentului prematur.
Bite de semnătură greșite.
Bzip2Archive(Cuvânt cheie: Bzip2LoadOptions)
Inițializează o nouă instanță a clasei Aspose.Zip.Bzip2.Bzip2Arhivă pregătită pentru decompresie.
public Bzip2Archive(string path, Bzip2LoadOptions loadOptions = null)Parameters
path string
Calea către arhivă.
loadOptions Bzip2LoadOptions
Opțiunile de încărcare a arhivelor cu.
Examples
Deschideți un arhiv din fișier pe cale și extrageți-l la un
var ms = new MemoryStream();
using (Bzip2Archive archive = new Bzip2Archive("archive.bz2"))
archive.Open().CopyTo(ms);Remarks
Acest constructor nu decomprime. a se vedea Aspose.Zip.Bzip2.Bzip2Archive.Metoda deschisă pentru decomprimare.
Exceptions
path’ is null.
Solicitantul nu are permisiunea necesară de acces.
Calea " este goală, conține doar spații albe sau conține caractere invalide.
Accesul la fișierul path" este refuzat.
Calea specificată path’, numele fișierului, sau ambele depășesc lungimea maximă definită de sistem. De exemplu, pe platformele bazate pe Windows, căile trebuie să fie mai puțin de 248 de caractere, iar numele fișierului trebuie să fie mai puțin de 260 de caractere.
Fișierul la path’ conține o coloană (:) în mijlocul stringului.
Dosarul nu a fost găsit.
Calea specificată este invalidă, de exemplu, fiind pe un motor necartat.
Dosarul este deja deschis.
Încheierea curentului prematur.
Bite de semnătură greșite.
Methods
Dispose()
Îndeplinește sarcini definite prin aplicare asociate cu eliberarea, eliberarea sau redistribuirea resurselor necontrolate.
public void Dispose()Dispose(Boulă)
Îndeplinește sarcini definite prin aplicare asociate cu eliberarea, eliberarea sau redistribuirea resurselor necontrolate.
protected virtual void Dispose(bool disposing)Parameters
disposing bool
În cazul în care resursele gestionate ar trebui să fie eliminate.
Extract(Stream)
Extrage arhiva în fluxul furnizat.
public void Extract(Stream destination)Parameters
destination Stream
Destination stream. trebuie să fie scris.
Examples
using (Bzip2Archive archive = new Bzip2Archive("archive.bz2"))
{
archive.Extract(httpResponseStream);
}Exceptions
destination’ does not support writing.
Extract(Strângere)
Extrageți arhiva în fișier prin traseu.
public FileInfo Extract(string path)Parameters
path string
Calea către fișierul de destinație. dacă fișierul există deja, va fi supraîncris.
Returns
Informații despre fișierul extras.
Exceptions
path’ is null.
Solicitantul nu are permisiunea necesară de acces.
Calea " este goală, conține doar spații albe sau conține caractere invalide.
Accesul la fișierul path" este refuzat.
Calea specificată path’, numele fișierului, sau ambele depășesc lungimea maximă definită de sistem. De exemplu, pe platformele bazate pe Windows, căile trebuie să fie mai puțin de 248 de caractere, iar numele fișierului trebuie să fie mai puțin de 260 de caractere.
Fișierul la path’ conține o coloană (:) în mijlocul stringului.
Dosarul nu a fost găsit.
Calea specificată este invalidă, de exemplu, fiind pe un motor necartat.
Dosarul este deja deschis.
ExtractToDirectory(Strângere)
Extrage conținutul arhivului în directorul furnizat.
public void ExtractToDirectory(string destinationDirectory)Parameters
destinationDirectory string
Calea către directorie pentru a pune în fișierele extrase.
Remarks
Dacă directorul nu există, acesta va fi creat.
Exceptions
destinationDirectory’ is null.
Calea specificată, numele fișierului sau ambele depășesc lungimea maximă definită de sistem. De exemplu, pe platformele bazate pe Windows, căile trebuie să fie mai puțin de 248 de caractere, iar numele fișierului trebuie să fie mai puțin de 260 de caractere.
Solicitantul nu are permisiunea necesară pentru a accesa directorul existent.
Dacă directorul nu există, calea conține un caracter colon (:) care nu face parte dintr-o etichetă 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 (:).
Directoriul specificat de cale este un fișier. -or- Numele rețelei nu este cunoscut.
Open()
Deschide arhiva pentru extracție și oferă un flux cu conținut de arhivă.
public Stream Open()Returns
Streamul care reprezintă conținutul arhivului.
Examples
utilizare :Stream decompressed = archive.Open();
.NET 4.0 și mai sus - utilizați metoda Stream.CopyTo:decompressed.CopyTo(httpResponse.OutputStream)
.NET 3.5 și mai devreme - copiați byte manual:
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
Războiul de destinaţie.
saveOptions Bzip2SaveOptions
Opțiuni pentru a salva un arhiv bzip2. dacă nu este specificat, se va folosi dimensiunea blocului de 900 Kb.
Examples
Scrieți datele comprese în fluxul de răspuns HTTP.
using (var archive = new Bzip2Archive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save(httpResponse.OutputStream);
}Remarks
Trebuie să fie scrisă.
Exceptions
Sursa de date care urmează să fie arhivată nu a fost furnizată.
outputStream’ is not writable.
Sursă de fișier este doar citit sau este un director.
Calea de sursă specificată a fișierului este invalidă, de exemplu, fiind pe un disc necartat.
Sursă de fișier este deja deschisă.
Save(Cuvânt cheie: Bzip2SaveOptions)
Salvează arhiva la un fișier de destinație furnizat.
public void Save(string destinationFileName, Bzip2SaveOptions saveOptions = null)Parameters
destinationFileName string
Dacă numele fișierului specific se referă la un fișier existent, acesta va fi supraîncris.
saveOptions Bzip2SaveOptions
Opțiuni pentru a salva un arhiv bzip2. dacă nu este specificat, se va folosi dimensiunea blocului de 900 Kb.
Examples
Scrieți datele comprimate pentru a fișier.
using (var archive = new Bzip2Archive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("data.bz2");
}Exceptions
destinationFileName’ is null.
Solicitantul nu are permisiunea necesară de acces.
destinationFileName’ este gol, conține doar spații albe sau conține caractere invalide.
Accesul la fișierul destinationFileName’ este refuzat.
De exemplu, pe platformele bazate pe Windows, căile trebuie să fie mai puțin de 248 de caractere, iar numele fișierului trebuie să fie mai puțin de 260 de caractere.
Fișierul la destinationFileName’ conține o coloană (:) în mijlocul stringului.
SetSource(Stream)
Puneți conținutul pentru a fi comprimat în arhivă.
public void SetSource(Stream source)Parameters
source Stream
Rata de intrare pentru arhivă.
Examples
using (Bzip2Archive archive = new Bzip2Archive())
{
archive.SetSource(new MemoryStream(new byte[] { 0x00,0xFF }));
archive.Save("archive.bz2");
}SetSource(FileInfo)
Puneți conținutul pentru a fi comprimat în arhivă.
public void SetSource(FileInfo fileInfo)Parameters
fileInfo FileInfo
Referința la un fișier care trebuie comprimat.
Examples
using (Bzip2Archive archive = new Bzip2Archive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("archive.bz2");
}SetSource(Strângere)
Puneți conținutul pentru a fi comprimat în arhivă.
public void SetSource(string path)Parameters
path string
Calea pentru a fi compresat.
Examples
using (Bzip2Archive archive = new Bzip2Archive())
{
archive.SetSource("data.bin");
archive.Save("archive.bz2");
}Exceptions
path’ is null.
Solicitantul nu are permisiunea necesară de acces.
Calea " este goală, conține doar spații albe sau conține caractere invalide.
Accesul la fișierul path" este refuzat.
Calea specificată path’, numele fișierului, sau ambele depășesc lungimea maximă definită de sistem. De exemplu, pe platformele bazate pe Windows, căile trebuie să fie mai puțin de 248 de caractere, iar numele fișierului trebuie să fie mai puțin de 260 de caractere.
Fișierul la path’ conține o coloană (:) în mijlocul stringului.
SetSource(Arhivă, TarFormat)
Puneți conținutul pentru a fi comprimat în arhivă.
public void SetSource(TarArchive tarArchive, TarFormat format = TarFormat.UsTar)Parameters
tarArchive TarArchive
Arhiva trebuie să fie comprimată.
format TarFormat
Descrierea formatului 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
Utilizați această metodă pentru a compune arhiva comună tar.bz2.
SetSource(CioArchivă, CioFormat)
Puneți conținutul pentru a fi comprimat în arhivă.
public void SetSource(CpioArchive cpioArchive, CpioFormat format = CpioFormat.OldAscii)Parameters
cpioArchive CpioArchive
Arhiva Cpio trebuie să fie comprimată.
format CpioFormat
Descrierea formatului 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
Utilizați această metodă pentru a compune arhiva conjunctivă cpio.bz2.
