Class SnappyArchive

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

objectSnappyArchive

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

ArgumentException

source ist nicht suchbar.

ArgumentNullException

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

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

Der Zugriff auf die Datei path ist verweigert.

PathTooLongException

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.

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 auf einem nicht zugeordneten Laufwerk liegt.

IOException

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

InvalidOperationException

Archivüberschriften und Dienstinformationen wurden nicht gelesen.

InvalidDataException

Fehler in den Daten im Header oder der Prüfziffer.

ArgumentNullException

Der Zielstream ist null.

ArgumentException

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

InvalidOperationException

Archivüberschriften und Dienstinformationen wurden nicht gelesen.

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 ein Verzeichnis.

ArgumentNullException

fileInfo ist null.

DirectoryNotFoundException

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

IOException

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

FileInfo

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

InvalidOperationException

Archivüberschriften und Dienstinformationen wurden nicht gelesen.

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

Der Zugriff auf die Datei path ist verweigert.

PathTooLongException

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.

NotSupportedException

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

ArgumentNullException

destinationDirectory ist null.

PathTooLongException

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.

SecurityException

Der Aufrufer hat nicht die erforderliche Berechtigung zum Zugriff auf das vorhandene Verzeichnis.

NotSupportedException

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

ArgumentException

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.

IOException

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

ArgumentException

output unterstützt kein Suchen.

ArgumentNullException

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

SecurityException

Der Aufrufer hat nicht die erforderliche Berechtigung, um die destination 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 ein Verzeichnis.

ArgumentNullException

destination ist null.

DirectoryNotFoundException

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

IOException

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

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

Der Zugriff auf die Datei destinationFileName ist verweigert.

PathTooLongException

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.

NotSupportedException

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

ArgumentException

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

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 ein Verzeichnis.

ArgumentNullException

fileInfo ist null.

DirectoryNotFoundException

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

IOException

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

ArgumentNullException

sourcePath ist null.

SecurityException

Der Aufrufer hat nicht die erforderliche Berechtigung zum Zugriff.

ArgumentException

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

UnauthorizedAccessException

Der Zugriff auf die Datei sourcePath ist verweigert.

PathTooLongException

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.

NotSupportedException

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

 Deutsch