Class LzmaArchive
Namespace: Aspose.Zip.LZMA
Assembly: Aspose.Zip.dll (25.1.0)
Diese Klasse repräsentiert eine LZMA-Archivdatei. Verwenden Sie sie, um LZMA-Archive zu erstellen oder zu extrahieren.
public class LzmaArchive : 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
LzmaArchive(LzmaArchiveSettings)
Initialisiert eine neue Instanz der Aspose.Zip.LZMA.LzmaArchive-Klasse und erstellt das Archiv im LZMA-Format.
public LzmaArchive(LzmaArchiveSettings settings = null)Parameter
settings LzmaArchiveSettings
Eine Gruppe von Einstellungen für das bestimmte LZMA-Archiv.
LzmaArchive(Stream)
Initialisiert eine neue Instanz der Aspose.Zip.LZMA.LzmaArchive-Klasse, die für die Dekompression vorbereitet ist.
public LzmaArchive(Stream source)Parameter
source Stream
Die Quelle des Archivs.
Bemerkungen
Dieser Konstruktor führt keine Dekompression durch. Siehe die Methode Aspose.Zip.LZMA.LzmaArchive.Extract(System.IO.Stream) zur Dekompression.
Ausnahmen
source ist nicht suchbar.
source ist null.
LzmaArchive(string)
Initialisiert eine neue Instanz der Aspose.Zip.LZMA.LzmaArchive-Klasse, die für die Dekompression vorbereitet ist.
public LzmaArchive(string path)Parameter
path string
Pfad zur Quelle des Archivs.
Beispiele
using (FileStream extractedFile = File.Open(extractedFileName, FileMode.Create))
{
using (var archive = new LzmaArchive(sourceLzmaFile))
{
archive.Extract(extractedFile);
}
}Bemerkungen
Dieser Konstruktor führt keine Dekompression durch. Siehe die Methode Aspose.Zip.LZMA.LzmaArchive.Extract(System.IO.Stream) zur Dekompression.
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.
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 Pfade auf Windows-basierten Plattformen weniger als 248 Zeichen und Dateinamen weniger als 260 Zeichen lang sein.
Die Datei unter path enthält einen Doppelpunkt (:) in der Mitte des Strings.
Methoden
Dispose()
Führt anwendungsdefinierte Aufgaben durch, die mit der Freigabe, Rücksetzung oder dem Zurücksetzen von nicht verwalteten Ressourcen verbunden sind.
public void Dispose()Dispose(bool)
Führt anwendungsdefinierte Aufgaben durch, die mit der Freigabe, Rücksetzung oder dem Zurücksetzen 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 LZMA-Archiv in einen Stream.
public void Extract(Stream destination)Parameter
destination Stream
Stream zum Speichern der dekomprimierten Daten.
Beispiele
using (FileStream sourceLzmaFile = File.Open(sourceFileName, FileMode.Open))
{
using (FileStream extractedFile = File.Open(extractedFileName, FileMode.Create))
{
using (var archive = new LzmaArchive(sourceLzmaFile))
{
archive.Extract(extractedFile);
}
}
}Ausnahmen
Die Archiv-Header und Dienstinformationen wurden nicht gelesen.
Das Archiv ist beschädigt.
Der Zielstream ist null.
Der Zielstream unterstützt kein Schreiben.
Extract(FileInfo)
Extrahiert das LZMA-Archiv in eine Datei.
public void Extract(FileInfo fileInfo)Parameter
fileInfo FileInfo
FileInfo zum Speichern der dekomprimierten Daten.
Beispiele
using (FileStream lzmaFile = File.Open(sourceFileName, FileMode.Open))
{
using (var archive = new LzmaArchive(lzmaFile))
{
archive.Extract(new FileInfo("extracted.bin"));
}
}Ausnahmen
Die Archiv-Header 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 ist 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.
Das Archiv ist beschädigt.
Extract(string)
Extrahiert das LZMA-Archiv in eine Datei über den Pfad.
public void Extract(string path)Parameter
path string
Pfad zur Datei, die die dekomprimierten Daten speichern wird.
Beispiele
using (FileStream lzmaFile = File.Open(sourceFileName, FileMode.Open))
{
using (var archive = new LzmaArchive(lzmaFile))
{
archive.Extract("extracted.bin");
}
}Ausnahmen
Die Archiv-Header 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.
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 Pfade auf Windows-basierten Plattformen weniger als 248 Zeichen und Dateinamen weniger als 260 Zeichen lang sein.
Die Datei unter path enthält einen Doppelpunkt (:) in der Mitte des Strings.
Das Archiv ist beschädigt.
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.
Bemerkungen
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 Pfade auf Windows-basierten Plattformen weniger als 248 Zeichen und Dateinamen weniger als 260 Zeichen lang 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 (:) welches nicht Teil eines Laufwerkslabels ist (“C:").
destinationDirectory ist eine Nullzeichenfolge, 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 einem oder enthält nur ein Doppelpunktzeichen (:).
Das durch den Pfad angegebene Verzeichnis ist eine Datei. -oder- Der Netzwerkname ist nicht bekannt.
Das Archiv ist beschädigt.
Save(Stream)
Speichert das LZMA-Archiv im bereitgestellten Stream.
public void Save(Stream output)Parameter
output Stream
Zielstream.
Beispiele
using (FileStream lzmaFile = File.Open("archive.lzma", FileMode.Create))
{
using (var archive = new LzmaArchive())
{
archive.SetSource("data.bin");
archive.Save(lzmaFile);
}
}Bemerkungen
output muss suchbar sein.
Ausnahmen
output unterstützt kein Suchen.
output ist null.
Save(FileInfo)
Speichert das LZMA-Archiv in der bereitgestellten Zieldatei.
public void Save(FileInfo destination)Parameter
destination FileInfo
FileInfo, die als Zielstream geöffnet wird.
Beispiele
using (var archive = new LzmaArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save(new FileInfo("archive.lzma"));
}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 ist 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.
Save(string)
Speichert das LZMA-Archiv in der bereitgestellten 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 LzmaArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("result.lzma");
}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.
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 Pfade auf Windows-basierten Plattformen weniger als 248 Zeichen und Dateinamen weniger als 260 Zeichen lang sein.
Die Datei unter destinationFileName enthält einen Doppelpunkt (:) in der Mitte des Strings.
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 LzmaArchive())
{
archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
archive.Save("archive.lzma");
}Ausnahmen
Der source-Stream ist nicht suchbar.
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 LzmaArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("archive.lzma");
}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 ist 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 sourcePath)Parameter
sourcePath string
Pfad zur Datei, die als Eingabestream geöffnet wird.
Beispiele
using (var archive = new LzmaArchive())
{
archive.SetSource("data.bin");
archive.Save("archive.lzma");
}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.
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 Pfade auf Windows-basierten Plattformen weniger als 248 Zeichen und Dateinamen weniger als 260 Zeichen lang sein.
Die Datei unter sourcePath enthält einen Doppelpunkt (:) in der Mitte des Strings.
