Class ZstandardArchive
Der Name: Aspose.Zip.Zstandard Versammlung: Aspose.Zip.dll (25.5.0)
Diese Klasse repräsentiert eine Zstandard-Archivdatei. Verwenden Sie es, um Zstandard-Archive zu erstellen.
public class ZstandardArchive : 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()
Constructors
ZstandardArchive()
Initialisiert eine neue Instanz der Aspose.Zip.Zstandard.ZstandardArchive-Klasse, die für die Kompression vorbereitet ist.
public ZstandardArchive()Examples
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 Aspose.Zip.Zstandard.ZstandardArchive-Klasse, die für die Decompression vorbereitet ist.
public ZstandardArchive(Stream sourceStream, ZstandardLoadOptions options = null)Parameters
sourceStream Stream
Die Quelle des Archivs.
options ZstandardLoadOptions
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 (GzipArchive archive = new ZstandardArchive(File.OpenRead("archive.zst")))
archive.Open().CopyTo(ms);Remarks
Dieser Konstruktor dekomprimiert nicht. siehe Aspose.Zip.Zstandard.ZstandardArchive.Open Methode für dekomprimieren.
ZstandardArchive(String, ZstandardLoadOptions)
Initialisiert eine neue Instanz der Aspose.Zip.Zstandard.ZstandardArchive Klasse.
public ZstandardArchive(string path, ZstandardLoadOptions options = null)Parameters
path string
Der Weg zum Archiv.
options ZstandardLoadOptions
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 (ZstandardArchive archive = new ZstandardArchive("archive.zst"))
archive.Open().CopyTo(ms);Remarks
Dieser Konstruktor dekomprimiert nicht. siehe Aspose.Zip.Zstandard.ZstandardArchive.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.
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 (var archive = new GzipArchive("archive.zst"))
{
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 einem 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.
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
Er extrahiert das Archiv und kopiert extrahierte Inhalte zum Stream von Dateien.
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.KopieTo(extracted);
Remarks
Lesen Sie aus dem Stream, um den ursprünglichen Inhalt einer Datei zu erhalten.
Save(Stream, ZstandardSaveOptions)
Speichern Sie Archive für den bereitgestellten Strom.
public void Save(Stream outputStream, ZstandardSaveOptions settings = null)Parameters
outputStream Stream
Der Destinationstrom.
settings ZstandardSaveOptions
Optionelle Einstellungen für die Archivkomposition.
Examples
Schreiben Sie komprimierte Daten in den HTTP-Reaktionsstrom.
using (var archive = new ZstandardArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save(httpResponse.OutputStream);
}Remarks
Es muss geschrieben werden.
Exceptions
outputStream’ is not writable.
Quelle wurde nicht bereitgestellt.
Save(String, ZstandardSaveOptions)
Speichern Sie das Archiv auf die bereitgestellte Zieldatei.
public void Save(string destinationFileName, ZstandardSaveOptions settings = null)Parameters
destinationFileName string
Wenn der angegebenen Datei-Name auf eine bestehende Datei bezieht, wird sie übergeschrieben.
settings ZstandardSaveOptions
Optionelle Einstellungen für die Archivkomposition.
Examples
using (var archive = new ZstandardArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("result.zst");
}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.
Save(FileInfo und ZstandardSaveOptions)
Speichern Sie das Archiv auf die bereitgestellte Zieldatei.
public void Save(FileInfo destination, ZstandardSaveOptions settings = null)Parameters
destination FileInfo
FileInfo, das als Zielstrom geöffnet wird.
settings ZstandardSaveOptions
Optionelle Einstellungen für die Archivkomposition.
Examples
using (var archive = new ZstandardArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save(new FileInfo("archive.zst"));
}Exceptions
Der Anrufgeber hat nicht die erforderliche Erlaubnis, die Destination 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.
destination’ is null.
Der angegebenen Weg ist ungültig, z. B. auf einem unmapped Drive.
Die Datei ist bereits geöffnet.
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 ZstandardArchive())
{
archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
archive.Save("archive.zst");
}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 (var archive = new ZstandardArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("archive.zst");
}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 (var archive = new ZstandardArchive())
{
archive.SetSource("data.bin");
archive.Save("archive.zst");
}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.
