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, 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
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
sourceStream ist nicht durchsuchbar.
sourceStream ist null.
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
path ist null.
Der Aufrufer hat nicht die erforderliche Berechtigung zum Zugriff.
Der path ist leer, enthält nur Leerzeichen oder ungültige Zeichen.
Zugriff auf die Datei path ist verweigert.
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.
Die Datei unter path enthält einen Doppelpunkt (:) in der Mitte der Zeichenfolge.
Die Datei wurde nicht gefunden.
Der angegebene Pfad ist ungültig, z. B. wenn er sich auf einem nicht zugeordneten Laufwerk befindet.
Die Datei ist bereits geöffnet.
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
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
Archivheader und Dienstinformationen wurden nicht gelesen.
Fehler in den Daten im Header oder Prüfziffer.
Zielstream ist null.
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
Archivheader und Dienstinformationen wurden nicht gelesen.
Der Aufrufer hat nicht die erforderliche Berechtigung, um die fileInfo zu öffnen.
Dateipfad ist leer oder enthält nur Leerzeichen.
Die Datei wurde nicht gefunden.
Pfad zur Datei ist schreibgeschützt oder ein Verzeichnis.
fileInfo 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.
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
Archivheader 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 ungültige Zeichen.
Zugriff auf die Datei path ist verweigert.
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.
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
destinationDirectory ist null.
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.
Der Aufrufer hat nicht die erforderliche Berechtigung, um auf das vorhandene Verzeichnis zuzugreifen.
Wenn das Verzeichnis nicht existiert, enthält der Pfad ein Zeichen für einen Doppelpunkt (:) das nicht Teil eines Laufwerkslabels (“C:") ist.
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.
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
outputStream unterstützt kein Suchen.
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
destinationFileName ist null.
Der Aufrufer hat nicht die erforderliche Berechtigung zum Zugriff.
Der destinationFileName ist leer, enthält nur Leerzeichen oder ungültige Zeichen.
Zugriff auf die Datei destinationFileName ist verweigert.
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.
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
Der Aufrufer hat nicht die erforderliche Berechtigung, um die destination zu öffnen.
Dateipfad ist leer oder enthält nur Leerzeichen.
Die Datei wurde nicht gefunden.
Pfad zur Datei ist schreibgeschützt oder 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 LzipArchive())
{
archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
archive.Save("archive.lz");
}Ausnahmen
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
Der Aufrufer hat nicht die erforderliche Berechtigung, um die fileInfo zu öffnen.
Dateipfad ist leer oder enthält nur Leerzeichen.
Die Datei wurde nicht gefunden.
Pfad zur Datei ist schreibgeschützt oder ein Verzeichnis.
fileInfo 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(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
path ist null.
Der Aufrufer hat nicht die erforderliche Berechtigung zum Zugriff.
Der path ist leer, enthält nur Leerzeichen oder ungültige Zeichen.
Zugriff auf die Datei path ist verweigert.
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.
Die Datei unter path enthält einen Doppelpunkt (:) in der Mitte der Zeichenfolge.
