Class Lz4Archive

Class Lz4Archive

Nom dels espais: Aspose.Zip.Lz4 Assemblea: Aspose.Zip.dll (25.5.0)

Aquesta classe representa el fitxer de l’arxiu LZ4. utilitzeu-lo per extreure o compondre els arxius Lz4.

public class Lz4Archive : IArchive, IDisposable, IArchiveFileEntry

Inheritance

object Lz4Archive

Implements

IArchive , IDisposable , IArchiveFileEntry

Membres heretats

object.GetType() , object.MemberwiseClone() , object.ToString() , object.Equals(object?) , object.Equals(object?, object?) , object.ReferenceEquals(object?, object?) , object.GetHashCode()

Constructors

Lz4Archive(Stream)

Inicia una nova instància de la classe Aspose.Zip.Lz4.Lz4Arxiu preparat per a la decompressi.

public Lz4Archive(Stream sourceStream)

Parameters

sourceStream Stream

La font de l’arxiu.

Examples

Obre un arxiu d’un corrent i extreure’l a un

var ms = new MemoryStream();
using (Lz4Archive archive = new Lz4Archive(File.OpenRead("archive.lz4")))
  archive.Open().CopyTo(ms);

Remarks

Aquest constructor no descomprimeix. Veure Aspose.Zip.Lz4.Lz4Archive.Open mètode per descomprimir.

Exceptions

ArgumentException

No es pot llegir de sourceStream'

ArgumentNullException

sourceStream’ is null.

EndOfStreamException

sourceStream’ is too short.

InvalidDataException

El sourceStream’ té la signatura equivocada.

Lz4Archive(Tàrrega)

Inicialitza una nova instància de la classe Aspose.Zip.Lz4.Lz4Arxiu.

public Lz4Archive(string path)

Parameters

path string

El camí cap a l’arxiu.

Examples

Obre un arxiu del fitxer per ruta i extreure-lo a un

var ms = new MemoryStream();
using (Lz4Archive archive = new Lz4Archive("archive.lz4"))
  archive.Open().CopyTo(ms);

Remarks

Aquest constructor no descomprimeix. Veure Aspose.Zip.Lz4.Lz4Archive.Open mètode per descomprimir.

Exceptions

ArgumentNullException

path’ is null.

SecurityException

El client no té el permís requerit per accedir

ArgumentException

La path’ és buida, només conté espais blancs, o conté caràcters invalidats.

UnauthorizedAccessException

L’accés al fitxer path" es nega.

PathTooLongException

El nom de fitxer especificat path", o tots dos superen la longitud màxima definida pel sistema. per exemple, en les plataformes basades en Windows, els passos han de ser menys de 248 caràcters, i els noms de fitxer han de ser menys de 260 caràcters.

NotSupportedException

El fitxer a path’ conté una columna (:) al mig de la cadena.

EndOfStreamException

El fitxer és massa curt.

InvalidDataException

Les dades del fitxer tenen la signatura equivocada.

Lz4Archive(Lz4ArchiveSetting)

Inicialitza una nova instància de la classe d’arxiu Aspose.Zip.Lz4. Lz4 preparada per a la compressió.

public Lz4Archive(Lz4ArchiveSetting settings = null)

Parameters

settings Lz4ArchiveSetting

La configuració de l’arxiu compost.

Methods

Dispose()

Realitza tasques definides per aplicació associades amb el lliurament, el lliurament o la restauració de recursos no gestionats.

public void Dispose()

Dispose(La botiga)

Realitza tasques definides per aplicació associades amb el lliurament, el lliurament o la restauració de recursos no gestionats.

protected virtual void Dispose(bool disposing)

Parameters

disposing bool

S’han de disposar de recursos gestionats.

Extract(Tàrrega)

Extreure l’arxiu al fitxer per cam.

public FileInfo Extract(string path)

Parameters

path string

El camí a l’arxiu de destinació. Si el fitxer ja existeix, serà sobreescrit.

Returns

FileInfo

Informació d’un arxiu extraït.

Exceptions

EndOfStreamException

El flux de font és massa curt.

InvalidDataException

Fets equivocats trobats durant la decodificaci.

NotSupportedException

Aquesta versió LZ4 no es dóna suport.

Extract(Stream)

L’arxiu s’extreu al flux proporcionat.

public void Extract(Stream destination)

Parameters

destination Stream

La destinació ha de ser escrita.

Examples

using (var archive = new Lz4Archive("archive.lz4"))
{
     archive.Extract(httpResponseStream);
}

Exceptions

ArgumentException

destination’ does not support writing.

EndOfStreamException

El flux de font és massa curt.

InvalidDataException

Fets equivocats trobats durant la decodificaci.

NotSupportedException

Aquesta versió LZ4 no es dóna suport.

InvalidOperationException

L’arxiu està preparat per a la composició.

ExtractToDirectory(Tàrrega)

Extreu el contingut de l’arxiu a la direcció proporcionada.

public void ExtractToDirectory(string destinationDirectory)

Parameters

destinationDirectory string

El camí a la direcció per col·locar els arxius extraïts.

Remarks

Si la direcció no existeix, es crear.

Exceptions

ArgumentNullException

destinationDirectory’ is null.

PathTooLongException

Per exemple, en les plataformes basades en Windows, els camins han de ser menys de 248 caràcters i els noms de fitxers han de ser menys de 260 caràcters.

SecurityException

El sol·licitant no té l’autorització necessària per accedir a la direcció existent.

NotSupportedException

Si el directori no existeix, el recorregut conté un caràcter colon (:) que no forma part d’una etiqueta 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

El directori especificat per ruta és un arxiu. -o- El nom de la xarxa no és conegut.

EndOfStreamException

El flux de font és massa curt.

InvalidDataException

Es troben bugs equivocats en iniciar la decodificaci.

InvalidOperationException

L’arxiu està preparat per a la composició.

Open()

Obre l’arxiu per a l’extracció i proporciona un flux amb contingut d’arxiu.

public Stream Open()

Returns

Stream

El corrent que representa el contingut de l’arxiu.

Examples

Extrata l’arxiu i copia el contingut extraït al flux de fitxers.

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);
    }            
}

Podeu utilitzar el mètode Stream.CopyTo per a .NET 4.0 i més alt: ‘unpacked.KopiTo(extraït);’

Remarks

Llegeix des del flux per obtenir el contingut original d’un fitxer. Veure secció exemples.

Exceptions

EndOfStreamException

El flux de font és massa curt.

InvalidDataException

Es troben bugs equivocats en iniciar la decodificaci.

InvalidOperationException

L’arxiu està preparat per a la composició.

Save(Stream)

Salva lz4 arxiu al corrent proporcionat.

public void Save(Stream output)

Parameters

output Stream

El flux de destinaci.

Examples

using (FileStream lz4File = File.Open("archive.lz4", FileMode.Create))
{
    using (var archive = new Lz4Archive())
    {
        archive.SetSource("data.bin");
        archive.Save(lz4File);
     }
}

Remarks

ha de ser buscable.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

InvalidOperationException

L’arxiu està preparat per a l’extracció. - o - Font no es va proporcionar.

Save(FileInfo)

Salva lz4 arxiu al fitxer de destinació proporcionat.

public void Save(FileInfo destination)

Parameters

destination FileInfo

FileInfo, que s’obrirà com a flux de destinació.

Examples

using (var archive = new Lz4Archive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save(new FileInfo("archive.lz4"));
}

Exceptions

SecurityException

El convocador no té el permís requerit per obrir la destinació <code class=“paramref'.

ArgumentException

La ruta de fitxer és buida o només conté espais blancs.

FileNotFoundException

El fitxer no es troba.

UnauthorizedAccessException

El camí a l’arxiu és només llegit o és un directori.

ArgumentNullException

destination’ is null.

DirectoryNotFoundException

La ruta especificada és invalidada, com per exemple estar en un disc no mapat.

IOException

El fitxer ja està obert.

InvalidOperationException

L’arxiu està preparat per a l’extracció.

Save(Tàrrega)

Salva l’arxiu al fitxer de destinació proporcionat.

public void Save(string destinationFileName)

Parameters

destinationFileName string

El camí de l’arxiu que s’ha de crear. Si el nom de fitxer especificat indica un fitxer existent, serà sobreescrit.

Examples

using (var archive = new LZ4Archive())
{
    archive.SetSource("data.bin");
    archive.Save("archive.lz4");
}

Exceptions

ArgumentNullException

destinationFileName’ is null.

SecurityException

El client no té el permís requerit per accedir

ArgumentException

El destinationFileName’ és buit, només conté espais blancs, o conté caràcters invalidats.

UnauthorizedAccessException

L’accés al fitxer destinationFileName’ és negat.

PathTooLongException

El nom de fitxer especificat destinationFileName, o ambdós superen la longitud màxima definida pel sistema. Per exemple, en les plataformes basades en Windows, els camins han de ser menys de 248 caràcters, i els noms de fitxer han de ser menys de 260 caràcters.

NotSupportedException

El fitxer a destinationFileName’ conté una columna (:) al mig de la cadena.

InvalidOperationException

L’arxiu està preparat per a l’extracció.

SetSource(Stream)

Establir el contingut per a ser comprès dins de l’arxiu.

public void SetSource(Stream source)

Parameters

source Stream

El flux d’entrada per a l’arxiu.

Examples

using (var archive = new Lz4Archive())
{
    archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
    archive.Save("archive.lz4");
}

Exceptions

InvalidOperationException

L’arxiu està preparat per a l’extracció.

SetSource(FileInfo)

Establir el contingut per a ser comprès dins de l’arxiu.

public void SetSource(FileInfo fileInfo)

Parameters

fileInfo FileInfo

La referència a un arxiu a ser comprès.

Examples

Obre un arxiu d’un corrent i extreure’l a un

using (var archive = new Lz4Archive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save("archive.lz4");
}

Exceptions

InvalidOperationException

L’arxiu està preparat per a l’extracció.

SetSource(Tàrrega, Tàrrega)

Establir el contingut per a ser comprès dins de l’arxiu.

public void SetSource(TarArchive tarArchive, TarFormat format = TarFormat.UsTar)

Parameters

tarArchive TarArchive

Arxiu per a ser comprès.

format TarFormat

Defineix el format 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

Utilitza aquest mètode per compondre l’arxiu conjunta tar.lz4.

SetSource(Tàrrega)

Establir el contingut per a ser comprès dins de l’arxiu.

public void SetSource(string path)

Parameters

path string

El camí per a arxiu per a ser comprès.

Examples

Obre un arxiu del fitxer per ruta i extreure-lo a un

using (var archive = new Lz4Archive()) 
{
    archive.SetSource("data.bin");
    archive.Save("archive.lz4");
}

Exceptions

ArgumentNullException

path’ is null.

SecurityException

El client no té el permís requerit per accedir

ArgumentException

La path’ és buida, només conté espais blancs, o conté caràcters invalidats.

UnauthorizedAccessException

L’accés al fitxer path” es nega.

PathTooLongException

El nom de fitxer especificat path", o tots dos superen la longitud màxima definida pel sistema. per exemple, en les plataformes basades en Windows, els passos han de ser menys de 248 caràcters, i els noms de fitxer han de ser menys de 260 caràcters.

NotSupportedException

El fitxer a path’ conté una columna (:) al mig de la cadena.

InvalidOperationException

Aquest arxiu està preparat per a l’extracció.

 Català