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