Class Lz4Archive
Der Name: Aspose.Zip.Lz4 Versammlung: Aspose.Zip.dll (25.5.0)
Diese Klasse repräsentiert die LZ4 Archivdatei. Verwenden Sie es, um zu extrahieren oder zu komposieren Lz4 Archiven.
public class Lz4Archive : IArchive, IDisposable, IArchiveFileEntryInheritance
Implements
IArchive , IDisposable , IArchiveFileEntry
Vererbte Mitglieder
object.GetType() , object.MemberwiseClone() , object.ToString() , object.Equals(object?) , object.Equals(object?, object?) , object.ReferenceEquals(object?, object?) , object.GetHashCode()
Constructors
Lz4Archive(Stream)
Initialisiert eine neue Instanz der Aspose.Zip.Lz4.Lz4Archivklasse, die für die Decompression vorbereitet ist.
public Lz4Archive(Stream sourceStream)Parameters
sourceStream Stream
Die Quelle des Archivs.
Examples
Öffnen Sie ein Archiv aus einem Stream und extrahieren Sie es in eine
var ms = new MemoryStream();
using (Lz4Archive archive = new Lz4Archive(File.OpenRead("archive.lz4")))
archive.Open().CopyTo(ms);Remarks
Dieser Konstruktor dekomprimiert nicht. siehe Aspose.Zip.Lz4.Lz4Archive.Open Methode für dekomprimierung.
Exceptions
Es kann nicht gelesen werden von sourceStream'
sourceStream’ is null.
sourceStream’ is too short.
Die sourceStream’ hat eine falsche Signatur.
Lz4Archive(String)
Initialisiert eine neue Instanz der Aspose.Zip.Lz4.Lz4Archivklasse.
public Lz4Archive(string path)Parameters
path string
Der Weg zum Archiv.
Examples
Öffnen Sie ein Archiv aus dem Datei nach Pfad und extrahieren Sie es in eine
var ms = new MemoryStream();
using (Lz4Archive archive = new Lz4Archive("archive.lz4"))
archive.Open().CopyTo(ms);Remarks
Dieser Konstruktor dekomprimiert nicht. siehe Aspose.Zip.Lz4.Lz4Archive.Open Methode für dekomprimierung.
Exceptions
path’ is null.
Der Anrufgeber hat nicht die erforderliche Genehmigung zum Zugriff
Die path’ ist leer, enthält nur weiße Räume oder enthält ungültige Zeichen.
Der Zugriff auf die Datei path" wird abgelehnt.
Die angegebenen path’, Dateinamen, oder beide überschreiten die Systemdefinierte maximale Länge. Zum Beispiel auf Windows-basierten Plattformen müssen die Paths weniger als 248 Zeichen und Dateinamen weniger als 260 Zeichen sein.
Die Datei bei path’ enthält eine Kolonne (:) in der Mitte der Zeile.
Die Datei ist zu kurz.
Die Daten im Datei haben die falsche Unterschrift.
Lz4Archive(Lz4ArchiveSetting)
Initialisiert eine neue Instanz der Aspose.Zip.Lz4. Lz4Archiv-Klasse, die für die Kompression vorbereitet ist.
public Lz4Archive(Lz4ArchiveSetting settings = null)Parameters
settings Lz4ArchiveSetting
Die Einrichtung des zusammengeführten Archivs.
Methods
Dispose()
Er erfüllt anwendungsdefinierte Aufgaben, die mit der Freisetzung, Freisetzung oder Wiederherstellung unverwalter Ressourcen verbunden sind.
public void Dispose()Dispose(Bool)
Er erfüllt anwendungsdefinierte Aufgaben, die mit der Freisetzung, Freisetzung oder Wiederherstellung unverwalter Ressourcen verbunden sind.
protected virtual void Dispose(bool disposing)Parameters
disposing bool
Ob verwaltete Ressourcen abgeschieden werden sollten.
Extract(String)
Entfernen Sie das Archiv in die Datei per Pfad.
public FileInfo Extract(string path)Parameters
path string
Der Weg zum Zieldatei.Wenn die Datei bereits existiert, wird sie übergeschrieben.
Returns
Informationen zu einem extrahierten Datei.
Exceptions
Der Quellstrom ist zu kurz.
falsche Byte während der Dekodierung gefunden.
Diese LZ4 Version wird nicht unterstützt.
Extract(Stream)
Entfernen Sie das Archiv in den bereitgestellten Strom.
public void Extract(Stream destination)Parameters
destination Stream
Destination Stream. muss geschrieben werden.
Examples
using (var archive = new Lz4Archive("archive.lz4"))
{
archive.Extract(httpResponseStream);
}Exceptions
destination’ does not support writing.
Der Quellstrom ist zu kurz.
falsche Byte während der Dekodierung gefunden.
Diese LZ4 Version wird nicht unterstützt.
Das Archiv ist für die Zusammensetzung vorbereitet.
ExtractToDirectory(String)
Entfernen Sie die Inhalte des Archivs in die bereitgestellte Kataloge.
public void ExtractToDirectory(string destinationDirectory)Parameters
destinationDirectory string
Der Weg zum Katalog, um die extrahierten Dateien in.
Remarks
Wenn das Katalog nicht existiert, wird es erstellt.
Exceptions
destinationDirectory’ is null.
Die angegebenen Path, Dateinamen oder beide überschreiten die Systemdefinierte maximale Länge. Zum Beispiel müssen auf Windows-basierten Plattformen Paths weniger als 248 Zeichen und Dateinamen weniger als 260 Zeichen sein.
Der Anrufgeber hat nicht die erforderliche Erlaubnis, das bestehende Direktorium zuzugreifen.
Wenn der Direktor nicht existiert, enthält der Pfad einen Zollkarakter (:) der nicht Teil eines Labels ist (“C:”).
destinationDirectory’ is a zero-length string, contains only white space, or contains one or more invalid characters. You can query for invalid characters by using the System.IO.Path.GetInvalidPathChars method.-or- path is prefixed with, or contains, only a colon character (:).
Die durch den Weg angegebenen Katalog ist eine Datei. -or- Der Netzwerkname ist nicht bekannt.
Der Quellstrom ist zu kurz.
Fehler byte gefunden, während initialisierung der dekodierung.
Das Archiv ist für die Zusammensetzung vorbereitet.
Open()
ffnet das Archiv für die Extraktion und bietet einen Strom mit Archivinhalt.
public Stream Open()Returns
Der Strom, der die Inhalte des Archivs darstellt.
Examples
Er extrahiert das Archiv und kopiert extrahierte Inhalte zum Stream von Dateien.
using (var archive = new Lz4Archive("archive.lz4"))
{
using (var extracted = File.Create("data.bin"))
{
var unpacked = archive.Open();
byte[] b = new byte[8192];
int bytesRead;
while (0 < (bytesRead = unpacked.Read(b, 0, b.Length)))
extracted.Write(b, 0, bytesRead);
}
}Sie können die Methode Stream.CopyTo für .NET 4.0 und höher verwenden: unpacked.KopieTo(extracted);
Remarks
Lesen Sie aus dem Stream, um den ursprünglichen Inhalt einer Datei zu erhalten.
Exceptions
Der Quellstrom ist zu kurz.
Fehler byte gefunden, während initialisierung der dekodierung.
Das Archiv ist für die Zusammensetzung vorbereitet.
Save(Stream)
Er spart das lz4 Archiv auf den bereitgestellten Strom.
public void Save(Stream output)Parameters
output Stream
Der Destinationstrom.
Examples
using (FileStream lz4File = File.Open("archive.lz4", FileMode.Create))
{
using (var archive = new Lz4Archive())
{
archive.SetSource("data.bin");
archive.Save(lz4File);
}
}Remarks
muss erforschbar sein.
Exceptions
output’ is null.
output’ is not writable.
Das Archiv ist für die Extraction vorbereitet. - oder - Quelle wurde nicht bereitgestellt.
Save(FileInfo)
Speichert lz4 Archiv auf die angebotene Zieldatei.
public void Save(FileInfo destination)Parameters
destination FileInfo
FileInfo, das als Zielstrom geöffnet wird.
Examples
using (var archive = new Lz4Archive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save(new FileInfo("archive.lz4"));
}Exceptions
Der Anrufgeber hat nicht die erforderliche Erlaubnis, die Destination zu öffnen'.
Der Dateiweg ist leer oder enthält nur weiße Räume.
Die Datei ist nicht gefunden.
Der Weg zum Datei ist nur lesbar oder ist ein Katalog.
destination’ is null.
Der angegebenen Weg ist ungültig, z. B. auf einem unmapped Drive.
Die Datei ist bereits geöffnet.
Das Archiv ist für die Extraction vorbereitet.
Save(String)
Speichern Sie das Archiv auf die bereitgestellte Zieldatei.
public void Save(string destinationFileName)Parameters
destinationFileName string
Wenn der angegebenen Datei-Name auf eine bestehende Datei bezieht, wird sie übergeschrieben.
Examples
using (var archive = new LZ4Archive())
{
archive.SetSource("data.bin");
archive.Save("archive.lz4");
}Exceptions
destinationFileName’ is null.
Der Anrufgeber hat nicht die erforderliche Genehmigung zum Zugriff
Die destinationFileName’ ist leer, enthält nur weiße Räume oder enthält ungültige Zeichen.
Der Zugriff auf die Datei destinationFileName’ wird abgelehnt.
Die angegebenen destinationFileName’, Dateiname, oder beide überschreiten die Systemdefinierte maximale Länge. Zum Beispiel auf Windows-basierten Plattformen müssen die Spuren weniger als 248 Zeichen und die Dateinamen weniger als 260 Zeichen sein.
Datei bei destinationFileName’ enthält eine Kolonne (:) in der Mitte der Zeile.
Das Archiv ist für die Extraction vorbereitet.
SetSource(Stream)
Setzen Sie die Inhalte, die im Archiv komprimiert werden sollen.
public void SetSource(Stream source)Parameters
source Stream
Der Eintrittsstrom für das Archiv.
Examples
using (var archive = new Lz4Archive())
{
archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
archive.Save("archive.lz4");
}Exceptions
Das Archiv ist für die Extraction vorbereitet.
SetSource(FileInfo)
Setzen Sie die Inhalte, die im Archiv komprimiert werden sollen.
public void SetSource(FileInfo fileInfo)Parameters
fileInfo FileInfo
Die Bezugnahme auf eine Datei, die komprimiert werden soll.
Examples
Öffnen Sie ein Archiv aus einem Stream und extrahieren Sie es in eine
using (var archive = new Lz4Archive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("archive.lz4");
}Exceptions
Das Archiv ist für die Extraction vorbereitet.
SetSource(TarArchive und TarFormat)
Setzen Sie die Inhalte, die im Archiv komprimiert werden sollen.
public void SetSource(TarArchive tarArchive, TarFormat format = TarFormat.UsTar)Parameters
tarArchive TarArchive
Das Archiv muss komprimiert werden.
format TarFormat
Definieren Sie das Tar Header Format.
Examples
using (var tarArchive = new TarArchive())
{
tarArchive.CreateEntry("first.bin", "data1.bin");
tarArchive.CreateEntry("second.bin", "data2.bin");
using (var lz4Archive = new Lz4Archive())
{
lz4Archive.SetSource(tarArchive);
lz4Archive.Save("archive.tar.lz4");
}
}Remarks
Verwenden Sie diese Methode, um die gemeinsame tar.lz4 Archiv zu erstellen.
SetSource(String)
Setzen Sie die Inhalte, die im Archiv komprimiert werden sollen.
public void SetSource(string path)Parameters
path string
Der Weg zum Datei zu komprimieren.
Examples
Öffnen Sie ein Archiv aus dem Datei nach Pfad und extrahieren Sie es in eine
using (var archive = new Lz4Archive())
{
archive.SetSource("data.bin");
archive.Save("archive.lz4");
}Exceptions
path’ is null.
Der Anrufgeber hat nicht die erforderliche Genehmigung zum Zugriff
Die path’ ist leer, enthält nur weiße Räume oder enthält ungültige Zeichen.
Der Zugriff auf die Datei path" wird abgelehnt.
Die angegebenen path’, Dateinamen, oder beide überschreiten die Systemdefinierte maximale Länge. Zum Beispiel auf Windows-basierten Plattformen müssen die Paths weniger als 248 Zeichen und Dateinamen weniger als 260 Zeichen sein.
Die Datei bei path’ enthält eine Kolonne (:) in der Mitte der Zeile.
Dieses Archiv ist für die Extraction vorbereitet.
