Class ZArchive
Namespace: Aspose.Zip.Z
Assembly: Aspose.Zip.dll (25.1.0)
Diese Klasse stellt eine Z (komprimieren) Archivdatei dar. Verwenden Sie sie, um Z-Archive zu erstellen oder zu extrahieren.
public class ZArchive : IArchive, IDisposable, IArchiveFileEntryVererbung
Implementiert
IArchive, IDisposable, IArchiveFileEntry
Vererbte Mitglieder
object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
Bemerkungen
Siehe https://docs.fileformat.com/compression/z/
Konstruktoren
ZArchive()
Initialisiert eine neue Instanz der Aspose.Zip.Z.ZArchive-Klasse, die für die Komprimierung vorbereitet ist.
public ZArchive()ZArchive(Stream, ZArchiveLoadOptions)
Initialisiert eine neue Instanz der Aspose.Zip.Z.ZArchive-Klasse, die für die Dekomprimierung vorbereitet ist.
public ZArchive(Stream source, ZArchiveLoadOptions loadOptions = null)Parameter
source Stream
Die Quelle des Archivs.
loadOptions ZArchiveLoadOptions
Die Optionen, um das Archiv zu laden.
Bemerkungen
Dieser Konstruktor führt keine Dekomprimierung durch. Siehe die Methode Aspose.Zip.Z.ZArchive.Extract(System.IO.Stream) für die Dekomprimierung.
Ausnahmen
source ist nicht suchbar.
source ist null.
ZArchive(string, ZArchiveLoadOptions)
Initialisiert eine neue Instanz der Aspose.Zip.Z.ZArchive-Klasse, die für die Dekomprimierung vorbereitet ist.
public ZArchive(string path, ZArchiveLoadOptions loadOptions = null)Parameter
path string
Pfad zur Quelle des Archivs.
loadOptions ZArchiveLoadOptions
Die Optionen, um das Archiv zu laden.
Bemerkungen
Dieser Konstruktor führt keine Dekomprimierung durch. Siehe die Methode Aspose.Zip.Z.ZArchive.Extract(System.IO.Stream) für die Dekomprimierung.
Ausnahmen
path ist null.
Der Aufrufer hat nicht die erforderliche Berechtigung zum Zugriff.
Der path ist leer, enthält nur Leerzeichen oder enthält ungültige Zeichen.
Zugriff auf die Datei path ist verweigert.
Der angegebene path, Dateiname oder beides überschreiten die systemdefinierte maximale Länge. Zum Beispiel müssen Pfade unter Windows-basierten Plattformen weniger als 248 Zeichen lang sein, und Dateinamen müssen weniger als 260 Zeichen lang sein.
Die Datei unter path enthält einen Doppelpunkt (:) in der Mitte des Strings.
Die Datei wurde nicht gefunden.
Der angegebene Pfad ist ungültig, z. B. weil er sich auf einem nicht zugeordneten Laufwerk befindet.
Die Datei ist bereits geöffnet.
Methoden
Dispose()
Führt anwendungsdefinierte Aufgaben aus, die mit dem Freigeben, Freisetzen oder Zurücksetzen nicht verwalteter Ressourcen verbunden sind.
public void Dispose()Dispose(bool)
Führt anwendungsdefinierte Aufgaben aus, die mit dem Freigeben, Freisetzen oder Zurücksetzen nicht verwalteter Ressourcen verbunden sind.
protected virtual void Dispose(bool disposing)Parameter
disposing bool
Ob verwaltete Ressourcen freigegeben werden sollen.
Extract(Stream)
Extrahiert das Z-Archiv in einen Stream.
public void Extract(Stream destination)Parameter
destination Stream
Stream zum Speichern der dekomprimierten Daten.
Beispiele
using (FileStream zFile = File.Open(sourceFileName, FileMode.Open))
{
using (FileStream extractedFile = File.Open(extractedFileName, FileMode.Create))
{
using (var archive = new ZArchive(zFile))
{
archive.Extract(extractedFile);
}
}
}Ausnahmen
Daten können nicht dekomprimiert werden.
Extract(FileInfo)
Extrahiert das Z-Archiv in eine Datei.
public void Extract(FileInfo fileInfo)Parameter
fileInfo FileInfo
FileInfo zum Speichern der dekomprimierten Daten.
Beispiele
using (FileStream zFile = File.Open(sourceFileName, FileMode.Open))
{
using (var archive = new ZArchive(zFile))
{
archive.Extract(new FileInfo("extracted.bin"));
}
}Ausnahmen
Der Aufrufer hat nicht die erforderliche Berechtigung, um die fileInfo zu öffnen.
Der Dateipfad ist leer oder enthält nur Leerzeichen.
Die Datei wurde nicht gefunden.
Der Pfad zur Datei ist schreibgeschützt oder ist ein Verzeichnis.
fileInfo ist null.
Der angegebene Pfad ist ungültig, z. B. weil er sich auf einem nicht zugeordneten Laufwerk befindet.
Die Datei ist bereits geöffnet.
Daten können nicht dekomprimiert werden.
Extract(string)
Extrahiert das Z-Archiv in eine Datei über den Pfad.
public FileInfo Extract(string path)Parameter
path string
Pfad zur Datei, die die dekomprimierten Daten speichern wird.
Rückgabewert
Informationen zur extrahierten Datei.
Beispiele
using (FileStream zFile = File.Open(sourceFileName, FileMode.Open))
{
using (var archive = new ZArchive(zFile))
{
archive.Extract("extracted.bin");
}
}Ausnahmen
path ist null.
Der Aufrufer hat nicht die erforderliche Berechtigung zum Zugriff.
Der path ist leer, enthält nur Leerzeichen oder enthält ungültige Zeichen.
Zugriff auf die Datei path ist verweigert.
Der angegebene path, Dateiname oder beides überschreiten die systemdefinierte maximale Länge. Zum Beispiel müssen Pfade unter Windows-basierten Plattformen weniger als 248 Zeichen lang sein, und Dateinamen müssen weniger als 260 Zeichen lang sein.
Die Datei unter path enthält einen Doppelpunkt (:) in der Mitte des Strings.
Daten können nicht dekomprimiert werden.
ExtractToDirectory(string)
Extrahiert den Inhalt des Archivs in das angegebene Verzeichnis.
public void ExtractToDirectory(string destinationDirectory)Parameter
destinationDirectory string
Der Pfad zum Verzeichnis, in dem die extrahierten Dateien abgelegt werden sollen.
Bemerkungen
Wenn das Verzeichnis nicht existiert, wird es erstellt.
Ausnahmen
destinationDirectory ist null.
Der angegebene Pfad, Dateiname oder beides überschreiten die systemdefinierte maximale Länge. Zum Beispiel müssen Pfade unter Windows-basierten Plattformen weniger als 248 Zeichen lang sein und Dateinamen müssen weniger als 260 Zeichen lang sein.
Der Aufrufer hat nicht die erforderliche Berechtigung, um auf das vorhandene Verzeichnis zuzugreifen.
Wenn das Verzeichnis nicht existiert, enthält der Pfad ein Doppelpunktzeichen (:) das nicht Teil eines Laufwerkslabels ist (“C:").
destinationDirectory ist eine Nullzeichenfolge, enthält nur Leerzeichen oder enthält ein oder mehrere ungültige Zeichen. Sie können ungültige Zeichen ermitteln, indem Sie die Methode System.IO.Path.GetInvalidPathChars verwenden.
-oder- der Pfad ist mit einem Doppelpunktzeichen (:) vorangestellt oder enthält nur ein Doppelpunktzeichen.
Das durch den Pfad angegebene Verzeichnis ist eine Datei. -oder- Der Netzwerkname ist unbekannt.
Save(Stream, ZArchiveSaveOptions)
Speichert das xz-Archiv im angegebenen Stream.
public void Save(Stream output, ZArchiveSaveOptions settings = null)Parameter
output Stream
Zielstream.
settings ZArchiveSaveOptions
Optionale Einstellungen für die Archivkomposition.
Beispiele
using (FileStream zFile = File.Open("data.bin.z", FileMode.Create))
{
using (var archive = new ZArchive())
{
archive.SetSource("data.bin");
archive.Save(zFile);
}
}Bemerkungen
output muss suchbar sein.
Ausnahmen
output unterstützt kein Suchen.
output ist null.
Save(string, ZArchiveSaveOptions)
Speichert das Z-Archiv in der angegebenen Zieldatei.
public void Save(string destinationFileName, ZArchiveSaveOptions settings = null)Parameter
destinationFileName string
+Der Pfad des zu erstellenden Archivs. Wenn der angegebene Dateiname auf eine vorhandene Datei verweist, wird diese überschrieben.
settings ZArchiveSaveOptions
Optionale Einstellungen für die Archivkomposition.
Beispiele
using (var archive = new ZArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("data.bin.Z");
}Ausnahmen
destinationFileName ist null.
Der Aufrufer hat nicht die erforderliche Berechtigung zum Zugriff.
Der destinationFileName ist leer, enthält nur Leerzeichen oder enthält ungültige Zeichen.
Zugriff auf die Datei destinationFileName ist verweigert.
Der angegebene destinationFileName, Dateiname oder beides überschreiten die systemdefinierte maximale Länge. Zum Beispiel müssen Pfade unter Windows-basierten Plattformen weniger als 248 Zeichen lang sein, und Dateinamen müssen weniger als 260 Zeichen lang sein.
Die Datei unter destinationFileName enthält einen Doppelpunkt (:) in der Mitte des Strings.
SetSource(Stream)
Legt den Inhalt fest, der im Archiv komprimiert werden soll.
public void SetSource(Stream source)Parameter
source Stream
Der Eingabestream für das Archiv.
Beispiele
using (var archive = new ZArchive())
{
archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
archive.Save("archive.Z");
}SetSource(FileInfo)
Legt den Inhalt fest, der im Archiv komprimiert werden soll.
public void SetSource(FileInfo fileInfo)Parameter
fileInfo FileInfo
FileInfo, die als Eingabestream geöffnet wird.
Beispiele
using (var archive = new ZArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("data.bin.Z");
}Ausnahmen
Der Aufrufer hat nicht die erforderliche Berechtigung, um die fileInfo zu öffnen.
Der Dateipfad ist leer oder enthält nur Leerzeichen.
Die Datei wurde nicht gefunden.
Der Pfad zur Datei ist schreibgeschützt oder ist ein Verzeichnis.
fileInfo ist null.
Der angegebene Pfad ist ungültig, z. B. weil er sich auf einem nicht zugeordneten Laufwerk befindet.
Die Datei ist bereits geöffnet.
SetSource(string)
Legt den Inhalt fest, der im Archiv komprimiert werden soll.
public void SetSource(string sourcePath)Parameter
sourcePath string
Pfad zur Datei, die als Eingabestream geöffnet wird.
Beispiele
using (var archive = new ZArchive())
{
archive.SetSource("data.bin");
archive.Save("data.bin.Z");
}Ausnahmen
sourcePath ist null oder eine leere Zeichenfolge.
Der Aufrufer hat nicht die erforderliche Berechtigung, um auf eine Ressource zuzugreifen.
Der sourcePath ist leer, enthält nur Leerzeichen oder enthält ungültige Zeichen.
Zugriff auf die Datei sourcePath ist verweigert.
Der angegebene sourcePath, Dateiname oder beides überschreiten die systemdefinierte maximale Länge. Zum Beispiel müssen Pfade unter Windows-basierten Plattformen weniger als 248 Zeichen lang sein, und Dateinamen müssen weniger als 260 Zeichen lang sein.
Die Datei unter sourcePath enthält einen Doppelpunkt (:) in der Mitte des Strings.
