Class LzipArchive

Class LzipArchive

Namespace: Aspose.Zip.Lzip
Assembly: Aspose.Zip.dll (25.1.0)

Diese Klasse repräsentiert eine Lzip-Archivdatei. Verwenden Sie sie, um Lzip-Archive zu erstellen oder zu extrahieren.

public class LzipArchive : IArchive, IDisposable, IArchiveFileEntry

Vererbung

objectLzipArchive

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

LzipArchive(LzipArchiveSettings)

Initialisiert eine neue Instanz von Aspose.Zip.Lzip.LzipArchive.

public LzipArchive(LzipArchiveSettings settings = null)

Parameter

settings LzipArchiveSettings

Einstellung des bestimmten Lzip-Archivs mit Definition der Wörterbuchgröße.

LzipArchive(Stream)

Initialisiert eine neue Instanz der Aspose.Zip.Lzip.LzipArchive-Klasse, die zum Dekomprimieren vorbereitet ist.

public LzipArchive(Stream sourceStream)

Parameter

sourceStream Stream

Die Quelle des Archivs.

Bemerkungen

Dieser Konstruktor dekomprimiert nicht. Siehe die Methode Aspose.Zip.Lzip.LzipArchive.Extract(System.IO.Stream) zum Dekomprimieren.

Ausnahmen

ArgumentException

sourceStream ist nicht durchsuchbar.

ArgumentNullException

sourceStream ist null.

InvalidDataException

Die Header stimmen nicht mit dem Lzip-Typ des Archivs überein.

LzipArchive(string)

Initialisiert eine neue Instanz der Aspose.Zip.Lzip.LzipArchive-Klasse, die zum Dekomprimieren vorbereitet ist.

public LzipArchive(string path)

Parameter

path string

Pfad zur Quelle des Archivs.

Beispiele

using (FileStream extractedFile = File.Open(extractedFileName, FileMode.Create))
{
    using (var archive = new LzipArchive(sourceLzipFile))
    {
         archive.Extract(extractedFile);
       }
   }

Bemerkungen

Dieser Konstruktor dekomprimiert nicht. Siehe die Methode Aspose.Zip.Lzip.LzipArchive.Extract(System.IO.Stream) zum Dekomprimieren.

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 ungültige Zeichen.

UnauthorizedAccessException

Zugriff auf die Datei path ist verweigert.

PathTooLongException

Der angegebene path, Dateiname oder beides überschreiten die systemdefinierte maximale Länge. Zum Beispiel müssen unter Windows-basierten Plattformen Pfade weniger als 248 Zeichen und Dateinamen weniger als 260 Zeichen enthalten.

NotSupportedException

Die Datei unter path enthält einen Doppelpunkt (:) in der Mitte der Zeichenfolge.

FileNotFoundException

Die Datei wurde nicht gefunden.

DirectoryNotFoundException

Der angegebene Pfad ist ungültig, z. B. wenn er sich auf einem nicht zugeordneten Laufwerk befindet.

IOException

Die Datei ist bereits geöffnet.

InvalidDataException

Die Header stimmen nicht mit dem Lzip-Typ des Archivs überein.

Eigenschaften

Settings

Erhält die Einstellung des bestimmten Lzip-Archivs.

public LzipArchiveSettings Settings { get; }

Eigenschaftswert

LzipArchiveSettings

Methoden

Dispose()

Führt anwendungsdefinierte Aufgaben aus, die mit dem Freigeben, Zurücksetzen oder Freigeben nicht verwalteter Ressourcen verbunden sind.

public void Dispose()

Dispose(bool)

Führt anwendungsdefinierte 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 Lzip-Archiv in einen Stream.

public void Extract(Stream destination)

Parameter

destination Stream

Stream zum Speichern der dekomprimierten Daten.

Beispiele

using (FileStream sourceLzipFile = File.Open(sourceFileName, FileMode.Open))
{
   using (FileStream extractedFile = File.Open(extractedFileName, FileMode.Create))
   {
        using (var archive = new LzipArchive(sourceLzipFile))
        {
               archive.Extract(extractedFile);
        }
   }
}

Ausnahmen

InvalidOperationException

Archivheader und Dienstinformationen wurden nicht gelesen.

InvalidDataException

Fehler in den Daten im Header oder Prüfziffer.

ArgumentNullException

Zielstream ist null.

ArgumentException

Zielstream unterstützt kein Schreiben.

Extract(FileInfo)

Extrahiert das Lzip-Archiv in eine Datei.

public void Extract(FileInfo fileInfo)

Parameter

fileInfo FileInfo

FileInfo zum Speichern der dekomprimierten Daten.

Beispiele

using (FileStream lzipFile = File.Open(sourceFileName, FileMode.Open))
{
    using (var archive = new LzipArchive(lzipFile))
    {
        archive.Extract(new FileInfo("extracted.bin"));
    }
}

Ausnahmen

InvalidOperationException

Archivheader und Dienstinformationen wurden nicht gelesen.

SecurityException

Der Aufrufer hat nicht die erforderliche Berechtigung, um die fileInfo zu öffnen.

ArgumentException

Dateipfad ist leer oder enthält nur Leerzeichen.

FileNotFoundException

Die Datei wurde nicht gefunden.

UnauthorizedAccessException

Pfad zur Datei ist schreibgeschützt oder ein Verzeichnis.

ArgumentNullException

fileInfo ist null.

DirectoryNotFoundException

Der angegebene Pfad ist ungültig, z. B. wenn er sich auf einem nicht zugeordneten Laufwerk befindet.

IOException

Die Datei ist bereits geöffnet.

Extract(string)

Extrahiert das Lzip-Archiv in eine Datei nach Pfad.

public void Extract(string path)

Parameter

path string

Pfad zur Datei, die die dekomprimierten Daten speichern wird.

Beispiele

using (FileStream lzipFile = File.Open(sourceFileName, FileMode.Open))
{
    using (var archive = new LzipArchive(xzFile))
    {
        archive.Extract("extracted.bin");
    }
}

Ausnahmen

InvalidOperationException

Archivheader 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 ungültige Zeichen.

UnauthorizedAccessException

Zugriff auf die Datei path ist verweigert.

PathTooLongException

Der angegebene path, Dateiname oder beides überschreiten die systemdefinierte maximale Länge. Zum Beispiel müssen unter Windows-basierten Plattformen Pfade weniger als 248 Zeichen und Dateinamen weniger als 260 Zeichen enthalten.

NotSupportedException

Die Datei unter path enthält einen Doppelpunkt (:) in der Mitte der Zeichenfolge.

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 sollen.

Bemerkungen

Wenn das Verzeichnis nicht existiert, wird es erstellt.

Ausnahmen

ArgumentNullException

destinationDirectory ist null.

PathTooLongException

Der angegebene Pfad, Dateiname oder beides überschreiten die systemdefinierte maximale Länge. Zum Beispiel müssen unter Windows-basierten Plattformen Pfade weniger als 248 Zeichen und Dateinamen weniger als 260 Zeichen enthalten.

SecurityException

Der Aufrufer hat nicht die erforderliche Berechtigung, um auf das vorhandene Verzeichnis zuzugreifen.

NotSupportedException

Wenn das Verzeichnis nicht existiert, enthält der Pfad ein Zeichen für einen Doppelpunkt (:) das nicht Teil eines Laufwerkslabels (“C:") ist.

ArgumentException

destinationDirectory ist eine Null-Zeichenfolge, enthält nur Leerzeichen oder enthält ein oder mehrere ungültige Zeichen. Sie können ungültige Zeichen mit der Methode System.IO.Path.GetInvalidPathChars abfragen. -oder- Der Pfad ist mit nur einem Doppelpunkt (:) vorangestellt oder enthält nur einen Doppelpunkt.

IOException

Das durch den Pfad angegebene Verzeichnis ist eine Datei. -oder- Der Netzwerkname ist nicht bekannt.

Save(Stream)

Speichert das Lzip-Archiv im angegebenen Stream.

public void Save(Stream outputStream)

Parameter

outputStream Stream

Zielstream.

Beispiele

using (FileStream lzFile = File.Open("archive.lz", FileMode.Create))
{
    using (var archive = new LzipArchive())
    {
        archive.SetSource("data.bin");
        archive.Save(lzFile);
     }
}

Bemerkungen

outputStream muss durchsuchbar sein.

Ausnahmen

ArgumentException

outputStream unterstützt kein Suchen.

ArgumentNullException

outputStream ist null.

Save(string)

Speichert das Lzip-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 LzipArchive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save("result.lz");
}

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 ungültige Zeichen.

UnauthorizedAccessException

Zugriff auf die Datei destinationFileName ist verweigert.

PathTooLongException

Der angegebene destinationFileName, Dateiname oder beides überschreiten die systemdefinierte maximale Länge. Zum Beispiel müssen unter Windows-basierten Plattformen Pfade weniger als 248 Zeichen und Dateinamen weniger als 260 Zeichen enthalten.

NotSupportedException

Die Datei unter destinationFileName enthält einen Doppelpunkt (:) in der Mitte der Zeichenfolge.

Save(FileInfo)

Speichert das Lzip-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 LzipArchive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save(new FileInfo("archive.lz"));
}

Ausnahmen

SecurityException

Der Aufrufer hat nicht die erforderliche Berechtigung, um die destination zu öffnen.

ArgumentException

Dateipfad ist leer oder enthält nur Leerzeichen.

FileNotFoundException

Die Datei wurde nicht gefunden.

UnauthorizedAccessException

Pfad zur Datei ist schreibgeschützt oder ein Verzeichnis.

ArgumentNullException

destination ist null.

DirectoryNotFoundException

Der angegebene Pfad ist ungültig, z. B. wenn er sich auf einem nicht zugeordneten Laufwerk befindet.

IOException

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 LzipArchive())
   {
       archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
       archive.Save("archive.lz");
}

Ausnahmen

ArgumentException

Der source Stream ist nicht durchsuchbar.

SetSource(FileInfo)

Legt den Inhalt fest, 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 LzipArchive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save("archive.lz");
}

Ausnahmen

SecurityException

Der Aufrufer hat nicht die erforderliche Berechtigung, um die fileInfo zu öffnen.

ArgumentException

Dateipfad ist leer oder enthält nur Leerzeichen.

FileNotFoundException

Die Datei wurde nicht gefunden.

UnauthorizedAccessException

Pfad zur Datei ist schreibgeschützt oder ein Verzeichnis.

ArgumentNullException

fileInfo ist null.

DirectoryNotFoundException

Der angegebene Pfad ist ungültig, z. B. wenn er sich auf einem nicht zugeordneten Laufwerk befindet.

IOException

Die Datei ist bereits geöffnet.

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 LzipArchive()) 
{
    archive.SetSource("data.bin");
    archive.Save("archive.lz");
}

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 ungültige Zeichen.

UnauthorizedAccessException

Zugriff auf die Datei path ist verweigert.

PathTooLongException

Der angegebene path, Dateiname oder beides überschreiten die systemdefinierte maximale Länge. Zum Beispiel müssen unter Windows-basierten Plattformen Pfade weniger als 248 Zeichen und Dateinamen weniger als 260 Zeichen enthalten.

NotSupportedException

Die Datei unter path enthält einen Doppelpunkt (:) in der Mitte der Zeichenfolge.

 Deutsch