Class ZArchive
Der Name: Aspose.Zip.Z Versammlung: Aspose.Zip.dll (25.5.0)
Diese Klasse repräsentiert eine Z (Compress) Archivdatei. Verwenden Sie es, um Z-Archive zu komponieren oder zu extrahieren.
public class ZArchive : 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
Sehen Sie https://docs.fileformat.com/compression/z/
Constructors
Archiv()
Initialisiert eine neue Instanz der Aspose.Zip.Z.Archive-Klasse, die für die Kompression vorbereitet ist.
public ZArchive()Archiv(Stream, ZArchiveLoadOptions)
Initialisiert eine neue Instanz der Aspose.Zip.Z.Archive-Klasse, die für die Decompression vorbereitet ist.
public ZArchive(Stream source, ZArchiveLoadOptions loadOptions = null)Parameters
source Stream
Die Quelle des Archivs.
loadOptions ZArchiveLoadOptions
Die Optionen zum Laden von Archiv mit.
Remarks
Sehen Sie Aspose.Zip.Z.ZArchive.Extract(System.IO.Stream) Methode für die Decompression.
Exceptions
source’ is not seekable.
source’ is null.
Archiv(String, ZArchiveLoadOptions)
Initialisiert eine neue Instanz der Aspose.Zip.Z.Archive-Klasse, die für die Decompression vorbereitet ist.
public ZArchive(string path, ZArchiveLoadOptions loadOptions = null)Parameters
path string
Der Weg zur Quelle des Archivs.
loadOptions ZArchiveLoadOptions
Die Optionen zum Laden von Archiv mit.
Remarks
Sehen Sie Aspose.Zip.Z.ZArchive.Extract(System.IO.Stream) Methode für die Decompression.
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.
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)
Z-Archiv zu einem Stream extrahieren.
public void Extract(Stream destination)Parameters
destination Stream
Stream für die Speicherung dekomprimierter Daten.
Examples
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);
}
}
}Exceptions
Daten können nicht dekomprimiert werden.
Extract(FileInfo)
Z-Archiv in eine Datei extrahieren.
public void Extract(FileInfo fileInfo)Parameters
fileInfo FileInfo
FileInfo für die Speicherung dekomprimierter Daten.
Examples
using (FileStream zFile = File.Open(sourceFileName, FileMode.Open))
{
using (var archive = new ZArchive(zFile))
{
archive.Extract(new FileInfo("extracted.bin"));
}
}Exceptions
Der Anrufgeber hat nicht die erforderliche Erlaubnis, die fileInfo’s zu öffnen'.
Der Dateiweg ist leer oder enthält nur weiße Räume.
Die Datei ist nicht gefunden.
Der Weg zum Datei ist nur lesbar oder ist ein Katalog.
fileInfo’ is null.
Der angegebenen Weg ist ungültig, z. B. auf einem unmapped Drive.
Die Datei ist bereits geöffnet.
Daten können nicht dekomprimiert werden.
Extract(String)
Z-Archiv zu einer Datei nach Path extrahieren.
public FileInfo Extract(string path)Parameters
path string
Weg zum Datei, der dekomprimierte Daten speichert.
Returns
Informationen zu einem extrahierten Datei.
Examples
using (FileStream zFile = File.Open(sourceFileName, FileMode.Open))
{
using (var archive = new ZArchive(zFile))
{
archive.Extract("extracted.bin");
}
}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.
Daten können nicht dekomprimiert werden.
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.
Save(Stream, ZArchiveSaveOptions)
Speichert xz-Archiv auf den angebotenen Strom.
public void Save(Stream output, ZArchiveSaveOptions settings = null)Parameters
output Stream
Der Destinationstrom.
settings ZArchiveSaveOptions
Optionelle Einstellungen für die Archivkomposition.
Examples
using (FileStream zFile = File.Open("data.bin.z", FileMode.Create))
{
using (var archive = new ZArchive())
{
archive.SetSource("data.bin");
archive.Save(zFile);
}
}Remarks
muss erforschbar sein.
Exceptions
output’ does not support seeking.
output’ is null.
Save(String, ZArchiveSaveOptions)
Speichern Sie Z-Archiv in das angebotene Zieldatei.
public void Save(string destinationFileName, ZArchiveSaveOptions settings = null)Parameters
destinationFileName string
+Der Weg des Archivs zu erstellen.Wenn der angegebenen Datei-Name auf eine bestehende Datei angibt, wird sie übergeschrieben.
settings ZArchiveSaveOptions
Optionelle Einstellungen für die Archivkomposition.
Examples
using (var archive = new ZArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("data.bin.Z");
}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 (var archive = new ZArchive())
{
archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
archive.Save("archive.Z");
}SetSource(FileInfo)
Setzen Sie die Inhalte, die im Archiv komprimiert werden sollen.
public void SetSource(FileInfo fileInfo)Parameters
fileInfo FileInfo
FileInfo, das als Eintrittsstrom geöffnet wird.
Examples
using (var archive = new ZArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("data.bin.Z");
}Exceptions
Der Anrufgeber hat nicht die erforderliche Erlaubnis, die fileInfo’s zu öffnen'.
Der Dateiweg ist leer oder enthält nur weiße Räume.
Die Datei ist nicht gefunden.
Der Weg zum Datei ist nur lesbar oder ist ein Katalog.
fileInfo’ is null.
Der angegebenen Weg ist ungültig, z. B. auf einem unmapped Drive.
Die Datei ist bereits geöffnet.
SetSource(String)
Setzen Sie die Inhalte, die im Archiv komprimiert werden sollen.
public void SetSource(string sourcePath)Parameters
sourcePath string
Weg zum Datei, der als Eingangsstrom geöffnet wird.
Examples
using (var archive = new ZArchive())
{
archive.SetSource("data.bin");
archive.Save("data.bin.Z");
}Exceptions
sourcePath’ is null or empty string.
Der Anrufgeber hat nicht die erforderliche Erlaubnis, eine Ressource zuzugreifen.
Die sourcePath’ ist leer, enthält nur weiße Räume oder enthält ungültige Zeichen.
Der Zugriff auf die Datei sourcePath’ wird abgelehnt.
Die angegebenen sourcePath’, Dateinamen, oder beide überschreiten die Systemdefinierte maximale Länge. Zum Beispiel auf Windows-basierten Plattformen müssen Paths weniger als 248 Zeichen und Dateinamen weniger als 260 Zeichen sein.
Die Datei bei sourcePath’ enthält eine Kolonne (:) in der Mitte der Zeile.
