Class Lz4Archive

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

object Lz4Archive

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

ArgumentException

Nu se poate citi din sourceStream'

ArgumentNullException

sourceStream’ is null.

EndOfStreamException

sourceStream’ is too short.

InvalidDataException

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

ArgumentNullException

path’ is null.

SecurityException

Utilizatorul nu are permisiunea necesara de a accesa

ArgumentException

Calea " este goală, conține doar spații albe sau conține caractere invalide.

UnauthorizedAccessException

Accesul la fișierul path" este refuzat.

PathTooLongException

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.

NotSupportedException

Fișierul la path’ conține o coloană (:) în mijlocul stringului.

EndOfStreamException

Fișierul este prea scurt.

InvalidDataException

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

FileInfo

Informații despre un fișier extras.

Exceptions

EndOfStreamException

Fluxul de surse este prea scurt.

InvalidDataException

Bite greșite găsite în timpul decodării.

NotSupportedException

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

ArgumentException

destination’ does not support writing.

EndOfStreamException

Fluxul de surse este prea scurt.

InvalidDataException

Bite greșite găsite în timpul decodării.

NotSupportedException

Această versiune LZ4 nu este susținută.

InvalidOperationException

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

ArgumentNullException

destinationDirectory’ is null.

PathTooLongException

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.

SecurityException

Solicitantul nu are permisiunea necesară pentru a accesa directorul existent.

NotSupportedException

Dacă directorul nu există, calea conține un caracter colon (:) care nu face parte dintr-o etichetă de disc (“C:”).

ArgumentException

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 (:).

IOException

Directoriul specificat de cale este un fișier. -or- Numele rețelei nu este cunoscut.

EndOfStreamException

Fluxul de surse este prea scurt.

InvalidDataException

Bite greșite găsite în timp ce inițializează decodarea.

InvalidOperationException

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

Stream

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

EndOfStreamException

Fluxul de surse este prea scurt.

InvalidDataException

Bite greșite găsite în timp ce inițializează decodarea.

InvalidOperationException

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

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

InvalidOperationException

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

SecurityException

Solicitantul nu are permisiunea necesară pentru a deschide destinația .

ArgumentException

Calea fișierului este goală sau conține doar spații albe.

FileNotFoundException

Dosarul nu a fost găsit.

UnauthorizedAccessException

Calea către fișier este doar o lectură sau este un director.

ArgumentNullException

destination’ is null.

DirectoryNotFoundException

Calea specificată este invalidă, de exemplu, fiind pe un motor necartat.

IOException

Dosarul este deja deschis.

InvalidOperationException

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

ArgumentNullException

destinationFileName’ is null.

SecurityException

Utilizatorul nu are permisiunea necesara de a accesa

ArgumentException

destinationFileName’ este gol, conține doar spații albe sau conține caractere invalide.

UnauthorizedAccessException

Accesul la fișierul destinationFileName’ este refuzat.

PathTooLongException

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.

NotSupportedException

Fișierul la destinationFileName’ conține o coloană (:) în mijlocul stringului.

InvalidOperationException

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

InvalidOperationException

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

InvalidOperationException

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

ArgumentNullException

path’ is null.

SecurityException

Utilizatorul nu are permisiunea necesara de a accesa

ArgumentException

Calea " este goală, conține doar spații albe sau conține caractere invalide.

UnauthorizedAccessException

Accesul la fișierul path" este refuzat.

PathTooLongException

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.

NotSupportedException

Fișierul la path’ conține o coloană (:) în mijlocul stringului.

InvalidOperationException

Acest arhiv este pregătit pentru extracție.

 Română