Class Lz4Archive

Class Lz4Archive

Il nome: Aspose.Zip.Lz4 Assemblea: Aspose.Zip.dll (25.5.0)

Questa classe rappresenta il file di archivio LZ4. utilizzarlo per estrarre o compilare archivi Lz4.

public class Lz4Archive : IArchive, IDisposable, IArchiveFileEntry

Inheritance

object Lz4Archive

Implements

IArchive , IDisposable , IArchiveFileEntry

I membri ereditari

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

Constructors

Lz4Archive(Stream)

Inizializza una nuova instanza della classe Aspose.Zip.Lz4.Lz4Archivato preparato per la decompressione.

public Lz4Archive(Stream sourceStream)

Parameters

sourceStream Stream

La fonte dell’archivio.

Examples

Aprire un archivio da un flusso ed estrarlo in un

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

Remarks

Questo costruttore non decomprime. vedi Aspose.Zip.Lz4.Lz4Archive.Open metodo di decompressione.

Exceptions

ArgumentException

Non si può leggere da sourceStream'

ArgumentNullException

sourceStream’ is null.

EndOfStreamException

sourceStream’ is too short.

InvalidDataException

La sourceStream’ ha una firma sbagliata.

Lz4Archive(String)

Inizia una nuova instanza della classe Aspose.Zip.Lz4.Lz4Archivio.

public Lz4Archive(string path)

Parameters

path string

Il percorso verso l’archivio.

Examples

Aprire un archivio dal file per percorso ed estrarlo in un

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

Remarks

Questo costruttore non decomprime. vedi Aspose.Zip.Lz4.Lz4Archive.Open metodo di decompressione.

Exceptions

ArgumentNullException

path’ is null.

SecurityException

Il richiedente non ha il permesso di accesso richiesto

ArgumentException

La path’ è vuota, contiene solo spazi bianchi, o contiene caratteri invalidi.

UnauthorizedAccessException

L’accesso al file path" è rifiutato.

PathTooLongException

La specifica path’, nome del file, o entrambi superano la lunghezza massima definita dal sistema. ad esempio, su piattaforme basate su Windows, i percorsi devono essere meno di 248 caratteri, e i nomi del file devono essere meno di 260 caratteri.

NotSupportedException

Il file in path’ contiene una colonna (:) nel mezzo della riga.

EndOfStreamException

Il file è troppo breve.

InvalidDataException

I dati nel file hanno la firma sbagliata.

Lz4Archive(Lz4ArchiveSetting)

Inizializza una nuova instanza della classe Aspose.Zip.Lz4.Lc4Archivio preparato per la compressione.

public Lz4Archive(Lz4ArchiveSetting settings = null)

Parameters

settings Lz4ArchiveSetting

La configurazione dell’archivio composito.

Methods

Dispose()

Esegue compiti definiti in applicazione associati al rilascio, al rilascio o al riutilizzo di risorse non gestite.

public void Dispose()

Dispose(di bool)

Esegue compiti definiti in applicazione associati al rilascio, al rilascio o al riutilizzo di risorse non gestite.

protected virtual void Dispose(bool disposing)

Parameters

disposing bool

Le risorse gestite dovrebbero essere sprecate.

Extract(String)

L’archivio viene estratto nel file per via.

public FileInfo Extract(string path)

Parameters

path string

Il percorso verso il file di destinazione. se il file esiste già, sarà sovrappeso.

Returns

FileInfo

Informazioni su un file estratto.

Exceptions

EndOfStreamException

Il flusso di sorgente è troppo breve.

InvalidDataException

I bug sbagliati trovati durante la decodifica.

NotSupportedException

Questa versione LZ4 non è supportata.

Extract(Stream)

L’archivio viene estratto nel flusso fornito.

public void Extract(Stream destination)

Parameters

destination Stream

Destinazione Stream. deve essere scritta.

Examples

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

Exceptions

ArgumentException

destination’ does not support writing.

EndOfStreamException

Il flusso di sorgente è troppo breve.

InvalidDataException

I bug sbagliati trovati durante la decodifica.

NotSupportedException

Questa versione LZ4 non è supportata.

InvalidOperationException

L’archivio è preparato per la composizione.

ExtractToDirectory(String)

Eliminare il contenuto dell’archivio nella directory fornita.

public void ExtractToDirectory(string destinationDirectory)

Parameters

destinationDirectory string

Il percorso verso il directory per posizionare i file estratti.

Remarks

Se il directory non esiste, sarà creato.

Exceptions

ArgumentNullException

destinationDirectory’ is null.

PathTooLongException

Il percorso specificato, il nome del file, o entrambi superano la lunghezza massima definita dal sistema. Ad esempio, su piattaforme basate su Windows, i percorsi devono essere meno di 248 caratteri e i nomi del file devono essere meno di 260 caratteri.

SecurityException

Il chiamante non ha il permesso richiesto per accedere al directory esistente.

NotSupportedException

Se la directory non esiste, il percorso contiene un carattere colonico (:) che non fa parte di un’etichetta drive (“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

Il directory specificato per percorso è un file. -or- Il nome della rete non è noto.

EndOfStreamException

Il flusso di sorgente è troppo breve.

InvalidDataException

I bug sbagliati sono stati trovati mentre inizializza la decodifica.

InvalidOperationException

L’archivio è preparato per la composizione.

Open()

Apri l’archivio per l’estrazione e fornisce un flusso con contenuti archivi.

public Stream Open()

Returns

Stream

Il flusso che rappresenta il contenuto dell’archivio.

Examples

Elimina l’archivio e copia il contenuto estratto al file stream.

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

Puoi usare il metodo Stream.CopyTo per .NET 4.0 e superiore: unpacked.KopiTo(estratto);

Remarks

Leggi dal flusso per ottenere il contenuto originale di un file.

Exceptions

EndOfStreamException

Il flusso di sorgente è troppo breve.

InvalidDataException

I bug sbagliati sono stati trovati mentre inizializza la decodifica.

InvalidOperationException

L’archivio è preparato per la composizione.

Save(Stream)

Salva lz4 archivio al flusso fornito.

public void Save(Stream output)

Parameters

output Stream

Il flusso di destinazione.

Examples

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

Remarks

Bisogna essere ricercabile.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

InvalidOperationException

L’archivio è preparato per l’estrazione. - o - La fonte non è stata fornita.

Save(FileInfo)

Salva lz4 archivio al file di destinazione fornito.

public void Save(FileInfo destination)

Parameters

destination FileInfo

FileInfo, che verrà aperto come flusso di destinazione.

Examples

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

Exceptions

SecurityException

Il chiamante non ha il permesso richiesto per aprire la destinazione .

ArgumentException

Il percorso di file è vuoto o contiene solo spazi bianchi.

FileNotFoundException

Il file non è trovato.

UnauthorizedAccessException

Il percorso per il file è letto solo o è un directory.

ArgumentNullException

destination’ is null.

DirectoryNotFoundException

Il percorso specificato è invalido, ad esempio essere su un drive non mappato.

IOException

Il file è già aperto.

InvalidOperationException

L’archivio è preparato per l’estrazione.

Save(String)

Salva l’archivio al file di destinazione fornito.

public void Save(string destinationFileName)

Parameters

destinationFileName string

Il percorso dell’archivio da creare.Se il nome del file specificato indica un file esistente, sarà sovrappeso.

Examples

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

Exceptions

ArgumentNullException

destinationFileName’ is null.

SecurityException

Il richiedente non ha il permesso di accesso richiesto

ArgumentException

La destinationFileName’ è vuota, contiene solo spazi bianchi, o contiene caratteri invalidi.

UnauthorizedAccessException

L’accesso al file destinationFileName’ è negato.

PathTooLongException

La specifica destinationFileName’, nome del file, o entrambi superano la lunghezza massima definita dal sistema. Ad esempio, su piattaforme basate su Windows, i percorsi devono essere meno di 248 caratteri e i nomi del file devono essere meno di 260 caratteri.

NotSupportedException

Il file in destinationFileName’ contiene una colonna (:) nel mezzo della riga.

InvalidOperationException

L’archivio è preparato per l’estrazione.

SetSource(Stream)

Metti il contenuto per essere compreso all’interno dell’archivio.

public void SetSource(Stream source)

Parameters

source Stream

Il flusso di input per l’archivio.

Examples

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

Exceptions

InvalidOperationException

L’archivio è preparato per l’estrazione.

SetSource(FileInfo)

Metti il contenuto per essere compreso all’interno dell’archivio.

public void SetSource(FileInfo fileInfo)

Parameters

fileInfo FileInfo

Il riferimento a un file da comprimere.

Examples

Aprire un archivio da un flusso ed estrarlo in un

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

Exceptions

InvalidOperationException

L’archivio è preparato per l’estrazione.

SetSource(TarArchivio, TarFormato)

Metti il contenuto per essere compreso all’interno dell’archivio.

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

Parameters

tarArchive TarArchive

L’archivio deve essere compreso.

format TarFormat

Definisce il formato 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

Utilizzare questo metodo per compilare archivio congiunto tar.lz4.

SetSource(String)

Metti il contenuto per essere compreso all’interno dell’archivio.

public void SetSource(string path)

Parameters

path string

Il modo in cui il file viene compreso.

Examples

Aprire un archivio dal file per percorso ed estrarlo in un

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

Exceptions

ArgumentNullException

path’ is null.

SecurityException

Il richiedente non ha il permesso di accesso richiesto

ArgumentException

La path’ è vuota, contiene solo spazi bianchi, o contiene caratteri invalidi.

UnauthorizedAccessException

L’accesso al file path" è rifiutato.

PathTooLongException

La specifica path’, nome del file, o entrambi superano la lunghezza massima definita dal sistema. ad esempio, su piattaforme basate su Windows, i percorsi devono essere meno di 248 caratteri, e i nomi del file devono essere meno di 260 caratteri.

NotSupportedException

Il file in path’ contiene una colonna (:) nel mezzo della riga.

InvalidOperationException

Questo archivio è preparato per l’estrazione.

 Italiano