Class SnappyArchive
Namespace: Aspose.Zip.Snappy
Assembly: Aspose.Zip.dll (25.1.0)
Diese Klasse repräsentiert eine Snappy-Archivdatei. Verwenden Sie sie, um Snappy-Archive zu erstellen oder zu extrahieren.
public class SnappyArchive : IArchive, IDisposable, IArchiveFileEntry
Vererbung
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
SnappyArchive()
Initialisiert eine neue Instanz der Aspose.Zip.Snappy.SnappyArchive-Klasse, die für die Komprimierung vorbereitet ist.
public SnappyArchive()
Beispiele
Das folgende Beispiel zeigt, wie man eine Datei komprimiert.
using (SnappyArchive archive = new SnappyArchive())
{
archive.SetSource("data.bin");
archive.Save("archive.snapy");
}
SnappyArchive(Stream)
Initialisiert eine neue Instanz der Aspose.Zip.Snappy.SnappyArchive-Klasse, die für die Dekomprimierung vorbereitet ist.
public SnappyArchive(Stream source)
Parameter
source
Stream
Die Quelle des Archivs.
Hinweise
Dieser Konstruktor führt keine Dekomprimierung durch. Siehe die Methode Aspose.Zip.Snappy.SnappyArchive.Extract(System.IO.Stream) für die Dekomprimierung.
Ausnahmen
source
ist nicht suchbar.
source
ist null.
SnappyArchive(string)
Initialisiert eine neue Instanz der Aspose.Zip.Snappy.SnappyArchive-Klasse, die für die Dekomprimierung vorbereitet ist.
public SnappyArchive(string path)
Parameter
path
string
Pfad zur Quelle des Archivs.
Beispiele
using (FileStream extractedFile = File.Open(extractedFileName, FileMode.Create))
{
using (var archive = new SnappyArchive(sourceSnappyFile))
{
archive.Extract(extractedFile);
}
}
Hinweise
Dieser Konstruktor führt keine Dekomprimierung durch. Siehe die Methode Aspose.Zip.Snappy.SnappyArchive.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.
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 auf Windows-basierten Plattformen Pfade kürzer als 248 Zeichen und Dateinamen kürzer als 260 Zeichen 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 auf einem nicht zugeordneten Laufwerk liegt.
Die Datei ist bereits geöffnet.
Methoden
Dispose()
Führt anwendungsspezifische Aufgaben durch, die mit dem Freigeben, Zurücksetzen oder Freigeben von nicht verwalteten Ressourcen verbunden sind.
public void Dispose()
Dispose(bool)
Führt anwendungsspezifische Aufgaben durch, die mit dem Freigeben, Zurücksetzen oder Freigeben von nicht verwalteten Ressourcen verbunden sind.
protected virtual void Dispose(bool disposing)
Parameter
disposing
bool
Ob verwaltete Ressourcen freigegeben werden sollen.
Extract(Stream)
Extrahiert das Snappy-Archiv in einen Stream.
public void Extract(Stream destination)
Parameter
destination
Stream
Stream zum Speichern der dekomprimierten Daten.
Beispiele
using (FileStream sourceSnappyFile = File.Open(sourceFileName, FileMode.Open))
{
using (FileStream extractedFile = File.Open(extractedFileName, FileMode.Create))
{
using (var archive = new SnappyArchive(sourceSnappyFile))
{
archive.Extract(extractedFile);
}
}
}
Ausnahmen
Archivüberschriften und Dienstinformationen wurden nicht gelesen.
Fehler in den Daten im Header oder der Prüfziffer.
Der Zielstream ist null.
Der Zielstream unterstützt kein Schreiben.
Extract(FileInfo)
Extrahiert das Snappy-Archiv in eine Datei.
public void Extract(FileInfo fileInfo)
Parameter
fileInfo
FileInfo
FileInfo zum Speichern der dekomprimierten Daten.
Beispiele
using (FileStream snappyFile = File.Open(sourceFileName, FileMode.Open))
{
using (var archive = new SnappyArchive(snappyFile))
{
archive.Extract(new FileInfo("extracted.bin"));
}
}
Ausnahmen
Archivüberschriften und Dienstinformationen wurden nicht gelesen.
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 ein Verzeichnis.
fileInfo
ist null.
Der angegebene Pfad ist ungültig, z.B. weil er auf einem nicht zugeordneten Laufwerk liegt.
Die Datei ist bereits geöffnet.
Extract(string)
Extrahiert das Snappy-Archiv in eine Datei nach Pfad.
public FileInfo Extract(string path)
Parameter
path
string
Pfad zur Datei, die die dekomprimierten Daten speichern wird.
Rückgaben
Eine Instanz von System.IO.FileInfo, die die extrahierten Daten enthält.
Beispiele
using (FileStream snappyFile = File.Open(sourceFileName, FileMode.Open))
{
using (var archive = new SnappyArchive(snappyFile))
{
archive.Extract("extracted.bin");
}
}
Ausnahmen
Archivüberschriften und Dienstinformationen wurden nicht gelesen.
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 auf Windows-basierten Plattformen Pfade kürzer als 248 Zeichen und Dateinamen kürzer als 260 Zeichen sein.
Die Datei unter path
enthält einen Doppelpunkt (:) in der Mitte des Strings.
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.
Hinweise
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 auf Windows-basierten Plattformen Pfade kürzer als 248 Zeichen und Dateinamen kürzer als 260 Zeichen 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 Nullzeichenkette, enthält nur Leerzeichen oder enthält eines oder mehrere ungültige Zeichen. Ungültige Zeichen können mit der Methode System.IO.Path.GetInvalidPathChars abgefragt werden.
-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)
Speichert das Snappy-Archiv im angegebenen Stream.
public void Save(Stream output)
Parameter
output
Stream
Zielstream.
Beispiele
using (FileStream snappyFile = File.Open("archive.snappy", FileMode.Create))
{
using (var archive = new SnappyArchive())
{
archive.SetSource("data.bin");
archive.Save(snappyFile);
}
}
Hinweise
output
muss suchbar sein.
Ausnahmen
output
unterstützt kein Suchen.
output
ist null.
Save(FileInfo)
Speichert das Snappy-Archiv in der angegebenen Zieldatei.
public void Save(FileInfo destination)
Parameter
destination
FileInfo
FileInfo, die als Zielstream geöffnet wird.
Beispiele
using (var archive = new SnappyArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save(new FileInfo("archive.snappy"));
}
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 ein Verzeichnis.
destination
ist null.
Der angegebene Pfad ist ungültig, z.B. weil er auf einem nicht zugeordneten Laufwerk liegt.
Die Datei ist bereits geöffnet.
Save(string)
Speichert das Snappy-Archiv in der angegebenen Zieldatei.
public void Save(string destinationFileName)
Parameter
destinationFileName
string
Der Pfad des zu erstellenden Archivs. Wenn der angegebene Dateiname auf eine vorhandene Datei verweist, wird diese überschrieben.
Beispiele
using (var archive = new SnappyArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("result.snappy");
}
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 auf Windows-basierten Plattformen Pfade kürzer als 248 Zeichen und Dateinamen kürzer als 260 Zeichen sein.
Die Datei unter destinationFileName
enthält einen Doppelpunkt (:) in der Mitte des Strings.
SetSource(Stream)
Setzt den Inhalt, 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 SnappyArchive())
{
archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
archive.Save("archive.snappy");
}
Ausnahmen
Der source
Stream ist nicht suchbar.
SetSource(FileInfo)
Setzt den Inhalt, 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 SnappyArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("archive.snappy");
}
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 ein Verzeichnis.
fileInfo
ist null.
Der angegebene Pfad ist ungültig, z.B. weil er auf einem nicht zugeordneten Laufwerk liegt.
Die Datei ist bereits geöffnet.
SetSource(string)
Setzt den Inhalt, 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 SnappyArchive())
{
archive.SetSource("data.bin");
archive.Save("archive.snappy");
}
Ausnahmen
sourcePath
ist null.
Der Aufrufer hat nicht die erforderliche Berechtigung zum Zugriff.
Der sourcePath
ist leer, enthält nur Leerzeichen oder enthält ungültige Zeichen.
Der Zugriff auf die Datei sourcePath
ist verweigert.
Der angegebene sourcePath
, Dateiname oder beides überschreiten die vom System definierten maximalen Längen. Zum Beispiel müssen auf Windows-basierten Plattformen Pfade kürzer als 248 Zeichen und Dateinamen kürzer als 260 Zeichen sein.
Die Datei unter sourcePath
enthält einen Doppelpunkt (:) in der Mitte des Strings.