Class Bzip2Archive
Der Name: Aspose.Zip.Bzip2 Versammlung: Aspose.Zip.dll (25.5.0)
Diese Klasse repräsentiert bzip2 Archivdatei. Verwenden Sie es, um bzip2 Archiv zu komponieren oder zu extrahieren.
public class Bzip2Archive : IArchive, IDisposable, IArchiveFileEntryInheritance
Implements
IArchive , IDisposable , IArchiveFileEntry
Vererbte Mitglieder
object.GetType() , object.MemberwiseClone() , object.ToString() , object.Equals(object?) , object.Equals(object?, object?) , object.ReferenceEquals(object?, object?) , object.GetHashCode()
Remarks
bzip2 komprimiert Dateien mit dem Burrows-Wheeler Block Sortierung Text Kompression-Algorithmus, und Huffman Codierung. Mehr sehen: https://en.wikipedia.org/wiki/Bzip2
Constructors
Bzip2Archive()
Initialisiert eine neue Instanz der Aspose.Zip.Bzip2.Bzip2Archiv-Klasse, die für die Kompression vorbereitet ist.
public Bzip2Archive()Examples
Das folgende Beispiel zeigt, wie man eine Datei komprimiert.
using (Bzip2Archive archive = new Bzip2Archive())
{
archive.SetSource("data.bin");
archive.Save("archive.bz2");
}Bzip2Archive(Stream, Bzip2LoadOptions)
Initialisiert eine neue Instanz der Aspose.Zip.Bzip2.Bzip2Archivklasse, die für die Decompression vorbereitet ist.
public Bzip2Archive(Stream sourceStream, Bzip2LoadOptions loadOptions = null)Parameters
sourceStream Stream
Die Quelle des Archivs.
loadOptions Bzip2LoadOptions
Die Optionen zum Laden von Archiv mit.
Examples
Öffnen Sie ein Archiv aus einem Stream und extrahieren Sie es in eine
var ms = new MemoryStream();
using (Bzip2Archive archive = new Bzip2Archive(File.OpenRead("archive.bz2")))
archive.Open().CopyTo(ms);Remarks
Dieser Konstruktor dekomprimiert nicht. siehe Aspose.Zip.Bzip2.Bzip2Archive.Open Methode für dekomprimieren.
Exceptions
Frühes Stream endet.
Fehler unterschrift byte.
Bzip2Archive(String, Bzip2LoadOptions)
Initialisiert eine neue Instanz der Aspose.Zip.Bzip2.Bzip2Archivklasse, die für die Decompression vorbereitet ist.
public Bzip2Archive(string path, Bzip2LoadOptions loadOptions = null)Parameters
path string
Der Weg zum Archiv.
loadOptions Bzip2LoadOptions
Die Optionen zum Laden von Archiv mit.
Examples
Öffnen Sie ein Archiv aus dem Datei nach Pfad und extrahieren Sie es in eine
var ms = new MemoryStream();
using (Bzip2Archive archive = new Bzip2Archive("archive.bz2"))
archive.Open().CopyTo(ms);Remarks
Dieser Konstruktor dekomprimiert nicht. siehe Aspose.Zip.Bzip2.Bzip2Archive.Open Methode für dekomprimieren.
Exceptions
path’ is null.
Der Anrufgeber hat nicht die erforderliche Erlaubnis für den Zugang.
Die path’ ist leer, enthält nur weiße Räume oder enthält ungültige Zeichen.
Der Zugriff auf die Datei path" wird abgelehnt.
Die angegebenen path’, Dateinamen, oder beide überschreiten die Systemdefinierte maximale Länge. Zum Beispiel auf Windows-basierten Plattformen müssen die Paths weniger als 248 Zeichen und Dateinamen weniger als 260 Zeichen sein.
Die Datei bei path’ enthält eine Kolonne (:) in der Mitte der Zeile.
Die Datei ist nicht gefunden.
Der angegebenen Weg ist ungültig, z. B. auf einem unmapped Drive.
Die Datei ist bereits geöffnet.
Frühes Stream endet.
Fehler unterschrift byte.
Methods
Dispose()
Er erfüllt anwendungsdefinierte Aufgaben, die mit der Freisetzung, Freisetzung oder Wiederherstellung unverwalter Ressourcen verbunden sind.
public void Dispose()Dispose(Bool)
Er erfüllt anwendungsdefinierte Aufgaben, die mit der Freisetzung, Freisetzung oder Wiederherstellung unverwalter Ressourcen verbunden sind.
protected virtual void Dispose(bool disposing)Parameters
disposing bool
Ob verwaltete Ressourcen abgeschieden werden sollten.
Extract(Stream)
Entfernen Sie das Archiv in den bereitgestellten Strom.
public void Extract(Stream destination)Parameters
destination Stream
Destination Stream. muss geschrieben werden.
Examples
using (Bzip2Archive archive = new Bzip2Archive("archive.bz2"))
{
archive.Extract(httpResponseStream);
}Exceptions
destination’ does not support writing.
Extract(String)
Entfernen Sie das Archiv in die Datei per Pfad.
public FileInfo Extract(string path)Parameters
path string
Der Weg zum Zieldatei.Wenn die Datei bereits existiert, wird sie übergeschrieben.
Returns
Informationen zu der extrahierten Datei.
Exceptions
path’ is null.
Der Anrufgeber hat nicht die erforderliche Erlaubnis für den Zugang.
Die path’ ist leer, enthält nur weiße Räume oder enthält ungültige Zeichen.
Der Zugriff auf die Datei path" wird abgelehnt.
Die angegebenen path’, Dateinamen, oder beide überschreiten die Systemdefinierte maximale Länge. Zum Beispiel auf Windows-basierten Plattformen müssen die Paths weniger als 248 Zeichen und Dateinamen weniger als 260 Zeichen sein.
Die Datei bei path’ enthält eine Kolonne (:) in der Mitte der Zeile.
Die Datei ist nicht gefunden.
Der angegebenen Weg ist ungültig, z. B. auf einem unmapped Drive.
Die Datei ist bereits geöffnet.
ExtractToDirectory(String)
Entfernen Sie die Inhalte des Archivs in die bereitgestellte Kataloge.
public void ExtractToDirectory(string destinationDirectory)Parameters
destinationDirectory string
Der Weg zum Katalog, um die extrahierten Dateien in.
Remarks
Wenn das Katalog nicht existiert, wird es erstellt.
Exceptions
destinationDirectory’ is null.
Die angegebenen Path, Dateinamen oder beide überschreiten die Systemdefinierte maximale Länge. Zum Beispiel müssen auf Windows-basierten Plattformen Paths weniger als 248 Zeichen und Dateinamen weniger als 260 Zeichen sein.
Der Anrufgeber hat nicht die erforderliche Erlaubnis, das bestehende Direktorium zuzugreifen.
Wenn der Direktor nicht existiert, enthält der Pfad einen Zollkarakter (:) der nicht Teil eines Labels ist (“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 (:).
Die durch den Weg angegebenen Katalog ist eine Datei. -or- Der Netzwerkname ist nicht bekannt.
Open()
ffnet das Archiv für die Extraktion und bietet einen Strom mit Archivinhalt.
public Stream Open()Returns
Der Strom, der die Inhalte des Archivs darstellt.
Examples
Verwendung:Stream decompressed = archive.Open();
.NET 4.0 und höher - verwenden Sie Stream.CopyTo Methode:decompressed.CopyTo(httpResponse.OutputStream)
.NET 3.5 und früher - Kopieren von Byten manuell:
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
Der Destinationstrom.
saveOptions Bzip2SaveOptions
Optionen für die Speicherung eines bzip2-Archives. wenn nicht angegeben, 900 Kb Blockgröße wird verwendet.
Examples
Schreiben Sie komprimierte Daten in den HTTP-Reaktionsstrom.
using (var archive = new Bzip2Archive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save(httpResponse.OutputStream);
}Remarks
Es muss geschrieben werden.
Exceptions
Die Datenquelle, die archiviert werden soll, wurde nicht bereitgestellt.
outputStream’ is not writable.
Die Dateiquelle ist nur gelesen oder ist ein Katalog.
Der angegebenen Datei-Quellweg ist ungültig, z. B. auf einem unmapped-Drive.
Die Dateiquelle ist bereits geöffnet.
Save(String, Bzip2SaveOptions)
Speichern Sie das Archiv zu einem bereitgestellten Zieldatei.
public void Save(string destinationFileName, Bzip2SaveOptions saveOptions = null)Parameters
destinationFileName string
Wenn der angegebenen Datei-Name auf eine bestehende Datei bezieht, wird sie übergeschrieben.
saveOptions Bzip2SaveOptions
Optionen für die Speicherung eines bzip2-Archives. wenn nicht angegeben, 900 Kb Blockgröße wird verwendet.
Examples
Sie schreiben komprimierte Daten zum Datei.
using (var archive = new Bzip2Archive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("data.bz2");
}Exceptions
destinationFileName’ is null.
Der Anrufgeber hat nicht die erforderliche Erlaubnis für den Zugang.
Die destinationFileName’ ist leer, enthält nur weiße Räume oder enthält ungültige Zeichen.
Der Zugriff auf die Datei destinationFileName’ wird abgelehnt.
Die angegebenen destinationFileName’, Dateiname, oder beide überschreiten die Systemdefinierte maximale Länge. Zum Beispiel auf Windows-basierten Plattformen müssen die Spuren weniger als 248 Zeichen und die Dateinamen weniger als 260 Zeichen sein.
Datei bei destinationFileName’ enthält eine Kolonne (:) in der Mitte der Zeile.
SetSource(Stream)
Setzen Sie die Inhalte, die im Archiv komprimiert werden sollen.
public void SetSource(Stream source)Parameters
source Stream
Der Eintrittsstrom für das Archiv.
Examples
using (Bzip2Archive archive = new Bzip2Archive())
{
archive.SetSource(new MemoryStream(new byte[] { 0x00,0xFF }));
archive.Save("archive.bz2");
}SetSource(FileInfo)
Setzen Sie die Inhalte, die im Archiv komprimiert werden sollen.
public void SetSource(FileInfo fileInfo)Parameters
fileInfo FileInfo
Die Bezugnahme auf eine Datei, die komprimiert werden soll.
Examples
using (Bzip2Archive archive = new Bzip2Archive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("archive.bz2");
}SetSource(String)
Setzen Sie die Inhalte, die im Archiv komprimiert werden sollen.
public void SetSource(string path)Parameters
path string
Der Weg zum Datei zu komprimieren.
Examples
using (Bzip2Archive archive = new Bzip2Archive())
{
archive.SetSource("data.bin");
archive.Save("archive.bz2");
}Exceptions
path’ is null.
Der Anrufgeber hat nicht die erforderliche Erlaubnis für den Zugang.
Die path’ ist leer, enthält nur weiße Räume oder enthält ungültige Zeichen.
Der Zugriff auf die Datei path" wird abgelehnt.
Die angegebenen path’, Dateinamen, oder beide überschreiten die Systemdefinierte maximale Länge. Zum Beispiel auf Windows-basierten Plattformen müssen die Paths weniger als 248 Zeichen und Dateinamen weniger als 260 Zeichen sein.
Die Datei bei path’ enthält eine Kolonne (:) in der Mitte der Zeile.
SetSource(TarArchive und TarFormat)
Setzen Sie die Inhalte, die im Archiv komprimiert werden sollen.
public void SetSource(TarArchive tarArchive, TarFormat format = TarFormat.UsTar)Parameters
tarArchive TarArchive
Das Archiv muss komprimiert werden.
format TarFormat
Definieren Sie das Tar Header Format.
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
Verwenden Sie diese Methode, um die gemeinsame tar.bz2 Archiv zu erstellen.
SetSource(CpioArchive und CpioFormat)
Setzen Sie die Inhalte, die im Archiv komprimiert werden sollen.
public void SetSource(CpioArchive cpioArchive, CpioFormat format = CpioFormat.OldAscii)Parameters
cpioArchive CpioArchive
Cpio-Archiv zu komprimieren.
format CpioFormat
Definiert das Cpio Header Format.
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
Verwenden Sie diese Methode, um das gemeinsame cpio.bz2 Archiv zu erstellen.
