Class ZArchive

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, IArchiveFileEntry

Vererbung

objectZArchive

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

ArgumentException

source ist nicht suchbar.

ArgumentNullException

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

ArgumentNullException

path ist null.

SecurityException

Der Aufrufer hat nicht die erforderliche Berechtigung zum Zugriff.

ArgumentException

Der path ist leer, enthält nur Leerzeichen oder enthält ungültige Zeichen.

UnauthorizedAccessException

Zugriff auf die Datei path ist verweigert.

PathTooLongException

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.

NotSupportedException

Die Datei unter path enthält einen Doppelpunkt (:) in der Mitte des Strings.

FileNotFoundException

Die Datei wurde nicht gefunden.

DirectoryNotFoundException

Der angegebene Pfad ist ungültig, z. B. weil er sich auf einem nicht zugeordneten Laufwerk befindet.

IOException

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

InvalidDataException

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

SecurityException

Der Aufrufer hat nicht die erforderliche Berechtigung, um die fileInfo zu öffnen.

ArgumentException

Der Dateipfad ist leer oder enthält nur Leerzeichen.

FileNotFoundException

Die Datei wurde nicht gefunden.

UnauthorizedAccessException

Der Pfad zur Datei ist schreibgeschützt oder ist ein Verzeichnis.

ArgumentNullException

fileInfo ist null.

DirectoryNotFoundException

Der angegebene Pfad ist ungültig, z. B. weil er sich auf einem nicht zugeordneten Laufwerk befindet.

IOException

Die Datei ist bereits geöffnet.

InvalidDataException

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

FileInfo

Informationen zur extrahierten Datei.

Beispiele

using (FileStream zFile = File.Open(sourceFileName, FileMode.Open))
{
    using (var archive = new ZArchive(zFile))
    {
        archive.Extract("extracted.bin");
    }
}

Ausnahmen

ArgumentNullException

path ist null.

SecurityException

Der Aufrufer hat nicht die erforderliche Berechtigung zum Zugriff.

ArgumentException

Der path ist leer, enthält nur Leerzeichen oder enthält ungültige Zeichen.

UnauthorizedAccessException

Zugriff auf die Datei path ist verweigert.

PathTooLongException

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.

NotSupportedException

Die Datei unter path enthält einen Doppelpunkt (:) in der Mitte des Strings.

InvalidDataException

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

ArgumentNullException

destinationDirectory ist null.

PathTooLongException

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.

SecurityException

Der Aufrufer hat nicht die erforderliche Berechtigung, um auf das vorhandene Verzeichnis zuzugreifen.

NotSupportedException

Wenn das Verzeichnis nicht existiert, enthält der Pfad ein Doppelpunktzeichen (:) das nicht Teil eines Laufwerkslabels ist (“C:").

ArgumentException

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.

IOException

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

ArgumentException

output unterstützt kein Suchen.

ArgumentNullException

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

ArgumentNullException

destinationFileName ist null.

SecurityException

Der Aufrufer hat nicht die erforderliche Berechtigung zum Zugriff.

ArgumentException

Der destinationFileName ist leer, enthält nur Leerzeichen oder enthält ungültige Zeichen.

UnauthorizedAccessException

Zugriff auf die Datei destinationFileName ist verweigert.

PathTooLongException

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.

NotSupportedException

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

SecurityException

Der Aufrufer hat nicht die erforderliche Berechtigung, um die fileInfo zu öffnen.

ArgumentException

Der Dateipfad ist leer oder enthält nur Leerzeichen.

FileNotFoundException

Die Datei wurde nicht gefunden.

UnauthorizedAccessException

Der Pfad zur Datei ist schreibgeschützt oder ist ein Verzeichnis.

ArgumentNullException

fileInfo ist null.

DirectoryNotFoundException

Der angegebene Pfad ist ungültig, z. B. weil er sich auf einem nicht zugeordneten Laufwerk befindet.

IOException

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

ArgumentNullException

sourcePath ist null oder eine leere Zeichenfolge.

SecurityException

Der Aufrufer hat nicht die erforderliche Berechtigung, um auf eine Ressource zuzugreifen.

ArgumentException

Der sourcePath ist leer, enthält nur Leerzeichen oder enthält ungültige Zeichen.

UnauthorizedAccessException

Zugriff auf die Datei sourcePath ist verweigert.

PathTooLongException

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.

NotSupportedException

Die Datei unter sourcePath enthält einen Doppelpunkt (:) in der Mitte des Strings.

 Deutsch