Class ZstandardArchive
Namespace: Aspose.Zip.Zstandard
Assembly: Aspose.Zip.dll (25.1.0)
Diese Klasse repräsentiert eine Zstandard-Archivdatei. Verwenden Sie sie, um Zstandard-Archive zu erstellen.
public class ZstandardArchive : 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()
Konstruktoren
ZstandardArchive()
Initialisiert eine neue Instanz der Klasse Aspose.Zip.Zstandard.ZstandardArchive, die zum Komprimieren vorbereitet ist.
public ZstandardArchive()Beispiele
Das folgende Beispiel zeigt, wie man eine Datei komprimiert.
using (ZstandardArchive archive = new ZstandardArchive())
{
archive.SetSource("data.bin");
archive.Save("archive.zst");
}ZstandardArchive(Stream, ZstandardLoadOptions)
Initialisiert eine neue Instanz der Klasse Aspose.Zip.Zstandard.ZstandardArchive, die zum Dekomprimieren vorbereitet ist.
public ZstandardArchive(Stream sourceStream, ZstandardLoadOptions options = null)Parameter
sourceStream Stream
Die Quelle des Archivs.
options ZstandardLoadOptions
Die Optionen zum Laden des Archivs.
Beispiele
Öffnen Sie ein Archiv aus einem Stream und extrahieren Sie es in einen MemoryStream
var ms = new MemoryStream();
using (GzipArchive archive = new ZstandardArchive(File.OpenRead("archive.zst")))
archive.Open().CopyTo(ms);Bemerkungen
Dieser Konstruktor dekomprimiert nicht. Siehe die Methode Aspose.Zip.Zstandard.ZstandardArchive.Open zum Dekomprimieren.
ZstandardArchive(string, ZstandardLoadOptions)
Initialisiert eine neue Instanz der Klasse Aspose.Zip.Zstandard.ZstandardArchive.
public ZstandardArchive(string path, ZstandardLoadOptions options = null)Parameter
path string
Der Pfad zur Archivdatei.
options ZstandardLoadOptions
Die Optionen zum Laden des Archivs.
Beispiele
Öffnen Sie ein Archiv von einer Datei über den Pfad und extrahieren Sie es in einen MemoryStream
var ms = new MemoryStream();
using (ZstandardArchive archive = new ZstandardArchive("archive.zst"))
archive.Open().CopyTo(ms);Bemerkungen
Dieser Konstruktor dekomprimiert nicht. Siehe die Methode Aspose.Zip.Zstandard.ZstandardArchive.Open zum Dekomprimieren.
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.
Der Zugriff auf die Datei path ist verweigert.
Der angegebene path, Dateiname oder beides überschreiten die vom System definierten maximalen Längen. Zum Beispiel müssen Pfade auf Windows-basierten Plattformen weniger als 248 Zeichen und Dateinamen weniger als 260 Zeichen lang sein.
Die Datei unter path enthält einen Doppelpunkt (:) in der Mitte des Strings.
Methoden
Dispose()
Führt anwendungsspezifische Aufgaben aus, die mit dem Freigeben, Zurücksetzen oder Freigeben nicht verwalteter Ressourcen verbunden sind.
public void Dispose()Dispose(bool)
Führt anwendungsspezifische Aufgaben aus, die mit dem Freigeben, Zurücksetzen oder Freigeben nicht verwalteter Ressourcen verbunden sind.
protected virtual void Dispose(bool disposing)Parameter
disposing bool
Ob verwaltete Ressourcen freigegeben werden sollen.
Extract(Stream)
Extrahiert das Archiv in den bereitgestellten Stream.
public void Extract(Stream destination)Parameter
destination Stream
Zielstream. Muss beschreibbar sein.
Beispiele
using (var archive = new GzipArchive("archive.zst"))
{
archive.Extract(httpResponseStream);
}Ausnahmen
destination unterstützt kein Schreiben.
Extract(string)
Extrahiert das Archiv in die Datei über den Pfad.
public FileInfo Extract(string path)Parameter
path string
Der Pfad zur Zieldatei. Wenn die Datei bereits existiert, wird sie überschrieben.
Rückgaben
Informationen zur extrahierten Datei.
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.
Der Zugriff auf die Datei path ist verweigert.
Der angegebene path, Dateiname oder beides überschreiten die vom System definierten maximalen Längen. Zum Beispiel müssen Pfade auf Windows-basierten Plattformen weniger als 248 Zeichen und Dateinamen weniger als 260 Zeichen lang sein.
Die Datei unter path enthält einen Doppelpunkt (:) in der Mitte des Strings.
ExtractToDirectory(string)
Extrahiert den Inhalt des Archivs in das bereitgestellte Verzeichnis.
public void ExtractToDirectory(string destinationDirectory)Parameter
destinationDirectory string
Der Pfad zum Verzeichnis, in das 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 vom System definierten maximalen Längen. Zum Beispiel müssen Pfade auf Windows-basierten Plattformen weniger als 248 Zeichen und Dateinamen weniger als 260 Zeichen lang sein.
Der Aufrufer hat nicht die erforderliche Berechtigung zum Zugriff auf das vorhandene Verzeichnis.
Wenn das Verzeichnis nicht existiert, enthält der Pfad ein Doppelpunktzeichen (:) das nicht Teil eines Laufwerkslabels (“C:") ist.
destinationDirectory ist eine Nullzeichenfolge, enthält nur Leerzeichen oder enthält ein oder mehrere ungültige Zeichen. Sie können nach ungültigen Zeichen suchen, indem Sie die Methode System.IO.Path.GetInvalidPathChars verwenden.
-oder- Der Pfad ist mit einem Doppelpunktzeichen (:) vorangestellt oder enthält nur ein Doppelpunktzeichen (:).
Das Verzeichnis, das durch den Pfad angegeben ist, ist eine Datei. -oder- Der Netzwerkname ist nicht bekannt.
Open()
Öffnet das Archiv zur Extraktion und stellt einen Stream mit dem Archivinhalt bereit.
public Stream Open()Rückgaben
Der Stream, der die Inhalte des Archivs darstellt.
Beispiele
Extrahiert das Archiv und kopiert den extrahierten Inhalt in den Dateistream.
using (var archive = new ZstandardArchive("archive.zst"))
{
using (var extracted = File.Create("data.bin"))
{
var unpacked = archive.Open();
byte[] b = new byte[8192];
int bytesRead;
while (0 < (bytesRead = unpacked.Read(b, 0, b.Length)))
extracted.Write(b, 0, bytesRead);
}
}Sie können die Methode Stream.CopyTo für .NET 4.0 und höher verwenden: `unpacked.CopyTo(extracted);`
Bemerkungen
Lesen Sie aus dem Stream, um den ursprünglichen Inhalt der Datei zu erhalten. Siehe Abschnitt Beispiele.
Save(Stream, ZstandardSaveOptions)
Speichert das Archiv im bereitgestellten Stream.
public void Save(Stream outputStream, ZstandardSaveOptions settings = null)Parameter
outputStream Stream
Zielstream.
settings ZstandardSaveOptions
Optionale Einstellungen für die Archivzusammenstellung.
Beispiele
Schreibt komprimierte Daten in den HTTP-Antwortstream.
using (var archive = new ZstandardArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save(httpResponse.OutputStream);
}Bemerkungen
outputStream muss beschreibbar sein.
Ausnahmen
outputStream ist nicht beschreibbar.
Die Quelle wurde nicht bereitgestellt.
Save(string, ZstandardSaveOptions)
Speichert das Archiv in der bereitgestellten Zieldatei.
public void Save(string destinationFileName, ZstandardSaveOptions settings = null)Parameter
destinationFileName string
Der Pfad des zu erstellenden Archivs. Wenn der angegebene Dateiname auf eine vorhandene Datei verweist, wird sie überschrieben.
settings ZstandardSaveOptions
Optionale Einstellungen für die Archivzusammenstellung.
Beispiele
using (var archive = new ZstandardArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("result.zst");
}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.
Der Zugriff auf die Datei destinationFileName ist verweigert.
Der angegebene destinationFileName, Dateiname oder beides überschreiten die vom System definierten maximalen Längen. Zum Beispiel müssen Pfade auf Windows-basierten Plattformen weniger als 248 Zeichen und Dateinamen weniger als 260 Zeichen lang sein.
Die Datei unter destinationFileName enthält einen Doppelpunkt (:) in der Mitte des Strings.
Save(FileInfo, ZstandardSaveOptions)
Speichert das Archiv in der bereitgestellten Zieldatei.
public void Save(FileInfo destination, ZstandardSaveOptions settings = null)Parameter
destination FileInfo
FileInfo, das als Zielstream geöffnet wird.
settings ZstandardSaveOptions
Optionale Einstellungen für die Archivzusammenstellung.
Beispiele
using (var archive = new ZstandardArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save(new FileInfo("archive.zst"));
}Ausnahmen
Der Aufrufer hat nicht die erforderliche Berechtigung, um die destination 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.
destination ist null.
Der angegebene Pfad ist ungültig, z. B. wenn er sich auf einem nicht zugeordneten Laufwerk befindet.
Die Datei ist bereits geöffnet.
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 ZstandardArchive())
{
archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
archive.Save("archive.zst");
}SetSource(FileInfo)
Legt den Inhalt fest, der im Archiv komprimiert werden soll.
public void SetSource(FileInfo fileInfo)Parameter
fileInfo FileInfo
Die Referenz auf eine Datei, die komprimiert werden soll.
Beispiele
using (var archive = new ZstandardArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("archive.zst");
}SetSource(string)
Legt den Inhalt fest, der im Archiv komprimiert werden soll.
public void SetSource(string path)Parameter
path string
Pfad zur Datei, die komprimiert werden soll.
Beispiele
using (var archive = new ZstandardArchive())
{
archive.SetSource("data.bin");
archive.Save("archive.zst");
}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.
Der Zugriff auf die Datei path ist verweigert.
Der angegebene path, Dateiname oder beides überschreiten die vom System definierten maximalen Längen. Zum Beispiel müssen Pfade auf Windows-basierten Plattformen weniger als 248 Zeichen und Dateinamen weniger als 260 Zeichen lang sein.
Die Datei unter path enthält einen Doppelpunkt (:) in der Mitte des Strings.
