Class Lz4Archive
Numele spaţiului: Aspose.Zip.Lz4 Asamblare: Aspose.Zip.dll (25.5.0)
Această clasă reprezintă fișierul de arhivă LZ4. Utilizați-l pentru a extrage sau compozi arhivele Lz4.
public class Lz4Archive : IArchive, IDisposable, IArchiveFileEntry
Inheritance
Implements
IArchive , IDisposable , IArchiveFileEntry
Membrii moștenitori
object.GetType() , object.MemberwiseClone() , object.ToString() , object.Equals(object?) , object.Equals(object?, object?) , object.ReferenceEquals(object?, object?) , object.GetHashCode()
Constructors
Lz4Archive(Stream)
Inițializează o nouă instanță a clasei Aspose.Zip.Lz4.Lz4Archive pregătite pentru decompresie.
public Lz4Archive(Stream sourceStream)
Parameters
sourceStream
Stream
Sursă a arhivelor.
Examples
Deschideți un arhiv dintr-un flux și extrageți-l la un
var ms = new MemoryStream();
using (Lz4Archive archive = new Lz4Archive(File.OpenRead("archive.lz4")))
archive.Open().CopyTo(ms);
Remarks
Acest constructor nu decomprime. a se vedea Aspose.Zip.Lz4.Lz4Archive.Metoda deschisă pentru decompresiune.
Exceptions
Nu se poate citi din sourceStream'
sourceStream’ is null.
sourceStream’ is too short.
sourceStream’ are semnătura greșită.
Lz4Archive(Strângere)
Inițializează o nouă instanță a clasei Aspose.Zip.Lz4.Lz4Archive.
public Lz4Archive(string path)
Parameters
path
string
Calea către arhivă.
Examples
Deschideți un arhiv din fișier pe cale și extrageți-l la un
var ms = new MemoryStream();
using (Lz4Archive archive = new Lz4Archive("archive.lz4"))
archive.Open().CopyTo(ms);
Remarks
Acest constructor nu decomprime. a se vedea Aspose.Zip.Lz4.Lz4Archive.Metoda deschisă pentru decompresiune.
Exceptions
path’ is null.
Utilizatorul nu are permisiunea necesara de a accesa
Calea " este goală, conține doar spații albe sau conține caractere invalide.
Accesul la fișierul path" este refuzat.
Calea specificată path’, numele fișierului, sau ambele depășesc lungimea maximă definită de sistem. De exemplu, pe platformele bazate pe Windows, căile trebuie să fie mai puțin de 248 de caractere, iar numele fișierului trebuie să fie mai puțin de 260 de caractere.
Fișierul la path’ conține o coloană (:) în mijlocul stringului.
Fișierul este prea scurt.
Datele din fișier au semnătura greșită.
Lz4Archive(Lz4ArchiveSetting)
Inițializează o nouă instanță a clasei Aspose.Zip.Lz4.Lc4Arhivă pregătită pentru compresie.
public Lz4Archive(Lz4ArchiveSetting settings = null)
Parameters
settings
Lz4ArchiveSetting
Afişarea arhivelor compuse.
Methods
Dispose()
Îndeplinește sarcini definite prin aplicare asociate cu eliberarea, eliberarea sau redistribuirea resurselor necontrolate.
public void Dispose()
Dispose(Boulă)
Îndeplinește sarcini definite prin aplicare asociate cu eliberarea, eliberarea sau redistribuirea resurselor necontrolate.
protected virtual void Dispose(bool disposing)
Parameters
disposing
bool
În cazul în care resursele gestionate ar trebui să fie eliminate.
Extract(Strângere)
Extrageți arhiva în fișier prin traseu.
public FileInfo Extract(string path)
Parameters
path
string
Calea către fișierul de destinație. dacă fișierul există deja, va fi supraîncris.
Returns
Informații despre un fișier extras.
Exceptions
Fluxul de surse este prea scurt.
Bite greșite găsite în timpul decodării.
Această versiune LZ4 nu este susținută.
Extract(Stream)
Extrage arhiva în fluxul furnizat.
public void Extract(Stream destination)
Parameters
destination
Stream
Destination stream. trebuie să fie scris.
Examples
using (var archive = new Lz4Archive("archive.lz4"))
{
archive.Extract(httpResponseStream);
}
Exceptions
destination’ does not support writing.
Fluxul de surse este prea scurt.
Bite greșite găsite în timpul decodării.
Această versiune LZ4 nu este susținută.
Arhiva este pregătită pentru compoziție.
ExtractToDirectory(Strângere)
Extrage conținutul arhivului în directorul furnizat.
public void ExtractToDirectory(string destinationDirectory)
Parameters
destinationDirectory
string
Calea către directorie pentru a pune în fișierele extrase.
Remarks
Dacă directorul nu există, acesta va fi creat.
Exceptions
destinationDirectory’ is null.
Calea specificată, numele fișierului sau ambele depășesc lungimea maximă definită de sistem. De exemplu, pe platformele bazate pe Windows, căile trebuie să fie mai puțin de 248 de caractere, iar numele fișierului trebuie să fie mai puțin de 260 de caractere.
Solicitantul nu are permisiunea necesară pentru a accesa directorul existent.
Dacă directorul nu există, calea conține un caracter colon (:) care nu face parte dintr-o etichetă de disc (“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 (:).
Directoriul specificat de cale este un fișier. -or- Numele rețelei nu este cunoscut.
Fluxul de surse este prea scurt.
Bite greșite găsite în timp ce inițializează decodarea.
Arhiva este pregătită pentru compoziție.
Open()
Deschide arhiva pentru extracție și oferă un flux cu conținut de arhivă.
public Stream Open()
Returns
Streamul care reprezintă conținutul arhivului.
Examples
Extrage fișierul și copiează conținutul extras în fluxul de fișiere.
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);
}
}
Puteți folosi metoda Stream.CopyTo pentru .NET 4.0 și mai înalt: unpacked.PopiTo(extract);
Remarks
Citiți din flux pentru a obține conținutul original al unui fișier.
Exceptions
Fluxul de surse este prea scurt.
Bite greșite găsite în timp ce inițializează decodarea.
Arhiva este pregătită pentru compoziție.
Save(Stream)
Salvează fișierul lz4 în fluxul furnizat.
public void Save(Stream output)
Parameters
output
Stream
Războiul de destinaţie.
Examples
using (FileStream lz4File = File.Open("archive.lz4", FileMode.Create))
{
using (var archive = new Lz4Archive())
{
archive.SetSource("data.bin");
archive.Save(lz4File);
}
}
Remarks
Trebuie să fie căutată.
Exceptions
output’ is null.
output’ is not writable.
Arhiva este pregătită pentru extracție. - sau - Sursă nu a fost furnizată.
Save(FileInfo)
Salvează arhiva lz4 la fișierul de destinație furnizat.
public void Save(FileInfo destination)
Parameters
destination
FileInfo
FileInfo, care va fi deschis ca flux de destinație.
Examples
using (var archive = new Lz4Archive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save(new FileInfo("archive.lz4"));
}
Exceptions
Solicitantul nu are permisiunea necesară pentru a deschide destinația .
Calea fișierului este goală sau conține doar spații albe.
Dosarul nu a fost găsit.
Calea către fișier este doar o lectură sau este un director.
destination’ is null.
Calea specificată este invalidă, de exemplu, fiind pe un motor necartat.
Dosarul este deja deschis.
Arhiva este pregătită pentru extracție.
Save(Strângere)
Salvează arhiva la fișierul de destinație furnizat.
public void Save(string destinationFileName)
Parameters
destinationFileName
string
Dacă numele fișierului specific se referă la un fișier existent, acesta va fi supraîncris.
Examples
using (var archive = new LZ4Archive())
{
archive.SetSource("data.bin");
archive.Save("archive.lz4");
}
Exceptions
destinationFileName’ is null.
Utilizatorul nu are permisiunea necesara de a accesa
destinationFileName’ este gol, conține doar spații albe sau conține caractere invalide.
Accesul la fișierul destinationFileName’ este refuzat.
De exemplu, pe platformele bazate pe Windows, căile trebuie să fie mai puțin de 248 de caractere, iar numele fișierului trebuie să fie mai puțin de 260 de caractere.
Fișierul la destinationFileName’ conține o coloană (:) în mijlocul stringului.
Arhiva este pregătită pentru extracție.
SetSource(Stream)
Puneți conținutul pentru a fi comprimat în arhivă.
public void SetSource(Stream source)
Parameters
source
Stream
Rata de intrare pentru arhivă.
Examples
using (var archive = new Lz4Archive())
{
archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
archive.Save("archive.lz4");
}
Exceptions
Arhiva este pregătită pentru extracție.
SetSource(FileInfo)
Puneți conținutul pentru a fi comprimat în arhivă.
public void SetSource(FileInfo fileInfo)
Parameters
fileInfo
FileInfo
Referința la un fișier care trebuie comprimat.
Examples
Deschideți un arhiv dintr-un flux și extrageți-l la un
using (var archive = new Lz4Archive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("archive.lz4");
}
Exceptions
Arhiva este pregătită pentru extracție.
SetSource(Arhivă, TarFormat)
Puneți conținutul pentru a fi comprimat în arhivă.
public void SetSource(TarArchive tarArchive, TarFormat format = TarFormat.UsTar)
Parameters
tarArchive
TarArchive
Arhiva trebuie să fie comprimată.
format
TarFormat
Descrierea formatului Tar Header.
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
Utilizați această metodă pentru a compune arhiva comună tar.lz4.
SetSource(Strângere)
Puneți conținutul pentru a fi comprimat în arhivă.
public void SetSource(string path)
Parameters
path
string
Calea pentru a fi compresat.
Examples
Deschideți un arhiv din fișier pe cale și extrageți-l la un
using (var archive = new Lz4Archive())
{
archive.SetSource("data.bin");
archive.Save("archive.lz4");
}
Exceptions
path’ is null.
Utilizatorul nu are permisiunea necesara de a accesa
Calea " este goală, conține doar spații albe sau conține caractere invalide.
Accesul la fișierul path" este refuzat.
Calea specificată path’, numele fișierului, sau ambele depășesc lungimea maximă definită de sistem. De exemplu, pe platformele bazate pe Windows, căile trebuie să fie mai puțin de 248 de caractere, iar numele fișierului trebuie să fie mai puțin de 260 de caractere.
Fișierul la path’ conține o coloană (:) în mijlocul stringului.
Acest arhiv este pregătit pentru extracție.