Class LzipArchive

Class LzipArchive

Namespace: Aspose.Zip.Lzip
Assembly: Aspose.Zip.dll (25.1.0)

Questa classe rappresenta un file di archivio Lzip. Usala per comporre o estrarre archivi Lzip.

public class LzipArchive : IArchive, IDisposable, IArchiveFileEntry

Ereditarietà

objectLzipArchive

Implementa

IArchive, IDisposable, IArchiveFileEntry

Membri ereditati

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

Costruttori

LzipArchive(LzipArchiveSettings)

Inizializza una nuova istanza di Aspose.Zip.Lzip.LzipArchive.

public LzipArchive(LzipArchiveSettings settings = null)

Parametri

settings LzipArchiveSettings

Impostazione di un particolare archivio lzip con definizione della dimensione del dizionario.

LzipArchive(Stream)

Inizializza una nuova istanza della classe Aspose.Zip.Lzip.LzipArchive preparata per la decompressione.

public LzipArchive(Stream sourceStream)

Parametri

sourceStream Stream

La sorgente dell’archivio.

Osservazioni

Questo costruttore non decomprime. Vedi il metodo Aspose.Zip.Lzip.LzipArchive.Extract(System.IO.Stream) per la decompressione.

Eccezioni

ArgumentException

sourceStream non è cercabile.

ArgumentNullException

sourceStream è nullo.

InvalidDataException

Le intestazioni non corrispondono al tipo di archivio lzip.

LzipArchive(string)

Inizializza una nuova istanza della classe Aspose.Zip.Lzip.LzipArchive preparata per la decompressione.

public LzipArchive(string path)

Parametri

path string

Percorso alla sorgente dell’archivio.

Esempi

using (FileStream extractedFile = File.Open(extractedFileName, FileMode.Create))
{
    using (var archive = new LzipArchive(sourceLzipFile))
    {
         archive.Extract(extractedFile);
       }
   }

Osservazioni

Questo costruttore non decomprime. Vedi il metodo Aspose.Zip.Lzip.LzipArchive.Extract(System.IO.Stream) per la decompressione.

Eccezioni

ArgumentNullException

path è nullo.

SecurityException

Il chiamante non ha il permesso richiesto per accedere.

ArgumentException

Il path è vuoto, contiene solo spazi bianchi o contiene caratteri non validi.

UnauthorizedAccessException

Accesso al file path negato.

PathTooLongException

Il path, il nome del file o entrambi superano la lunghezza massima definita dal sistema. Ad esempio, sulle piattaforme basate su Windows, i percorsi devono essere inferiori a 248 caratteri e i nomi dei file devono essere inferiori a 260 caratteri.

NotSupportedException

Il file in path contiene un due punti (:) nel mezzo della stringa.

FileNotFoundException

Il file non è stato trovato.

DirectoryNotFoundException

Il percorso specificato non è valido, ad esempio se si trova su un’unità non mappata.

IOException

Il file è già aperto.

InvalidDataException

Le intestazioni non corrispondono al tipo di archivio lzip.

Proprietà

Settings

Ottiene l’impostazione di un particolare archivio lzip.

public LzipArchiveSettings Settings { get; }

Valore della Proprietà

LzipArchiveSettings

Metodi

Dispose()

Esegue attività definite dall’applicazione associate alla liberazione, rilascio o reimpostazione delle risorse non gestite.

public void Dispose()

Dispose(bool)

Esegue attività definite dall’applicazione associate alla liberazione, rilascio o reimpostazione delle risorse non gestite.

protected virtual void Dispose(bool disposing)

Parametri

disposing bool

Se le risorse gestite devono essere liberate.

Extract(Stream)

Estrae l’archivio lzip in uno stream.

public void Extract(Stream destination)

Parametri

destination Stream

Stream per memorizzare i dati decompressi.

Esempi

using (FileStream sourceLzipFile = File.Open(sourceFileName, FileMode.Open))
{
   using (FileStream extractedFile = File.Open(extractedFileName, FileMode.Create))
   {
        using (var archive = new LzipArchive(sourceLzipFile))
        {
               archive.Extract(extractedFile);
        }
   }
}

Eccezioni

InvalidOperationException

Le intestazioni dell’archivio e le informazioni di servizio non sono state lette.

InvalidDataException

Errore nei dati nell’intestazione o nel checksum.

ArgumentNullException

Lo stream di destinazione è nullo.

ArgumentException

Lo stream di destinazione non supporta la scrittura.

Extract(FileInfo)

Estrae l’archivio lzip in un file.

public void Extract(FileInfo fileInfo)

Parametri

fileInfo FileInfo

FileInfo per memorizzare i dati decompressi.

Esempi

using (FileStream lzipFile = File.Open(sourceFileName, FileMode.Open))
{
    using (var archive = new LzipArchive(lzipFile))
    {
        archive.Extract(new FileInfo("extracted.bin"));
    }
}

Eccezioni

InvalidOperationException

Le intestazioni dell’archivio e le informazioni di servizio non sono state lette.

SecurityException

Il chiamante non ha il permesso richiesto per aprire il fileInfo.

ArgumentException

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

FileNotFoundException

Il file non è stato trovato.

UnauthorizedAccessException

Il percorso del file è di sola lettura o è una directory.

ArgumentNullException

fileInfo è nullo.

DirectoryNotFoundException

Il percorso specificato non è valido, ad esempio se si trova su un’unità non mappata.

IOException

Il file è già aperto.

Extract(string)

Estrae l’archivio lzip in un file tramite percorso.

public void Extract(string path)

Parametri

path string

Percorso al file che memorizzerà i dati decompressi.

Esempi

using (FileStream lzipFile = File.Open(sourceFileName, FileMode.Open))
{
    using (var archive = new LzipArchive(xzFile))
    {
        archive.Extract("extracted.bin");
    }
}

Eccezioni

InvalidOperationException

Le intestazioni dell’archivio e le informazioni di servizio non sono state lette.

ArgumentNullException

path è nullo.

SecurityException

Il chiamante non ha il permesso richiesto per accedere.

ArgumentException

Il path è vuoto, contiene solo spazi bianchi o contiene caratteri non validi.

UnauthorizedAccessException

Accesso al file path negato.

PathTooLongException

Il path, il nome del file o entrambi superano la lunghezza massima definita dal sistema. Ad esempio, sulle piattaforme basate su Windows, i percorsi devono essere inferiori a 248 caratteri e i nomi dei file devono essere inferiori a 260 caratteri.

NotSupportedException

Il file in path contiene un due punti (:) nel mezzo della stringa.

ExtractToDirectory(string)

Estrae il contenuto dell’archivio nella directory fornita.

public void ExtractToDirectory(string destinationDirectory)

Parametri

destinationDirectory string

Il percorso della directory in cui posizionare i file estratti.

Osservazioni

Se la directory non esiste, verrà creata.

Eccezioni

ArgumentNullException

destinationDirectory è nullo.

PathTooLongException

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

SecurityException

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

NotSupportedException

Se la directory non esiste, il percorso contiene un carattere due punti (:) che non fa parte di un’etichetta di unità (“C:").

ArgumentException

destinationDirectory è una stringa di lunghezza zero, contiene solo spazi bianchi o contiene uno o più caratteri non validi. Puoi interrogare i caratteri non validi utilizzando il metodo System.IO.Path.GetInvalidPathChars. -o- il percorso è prefissato con, o contiene, solo un carattere due punti (:).

IOException

La directory specificata dal percorso è un file. -o- Il nome della rete non è conosciuto.

Save(Stream)

Salva l’archivio lzip nello stream fornito.

public void Save(Stream outputStream)

Parametri

outputStream Stream

Stream di destinazione.

Esempi

using (FileStream lzFile = File.Open("archive.lz", FileMode.Create))
{
    using (var archive = new LzipArchive())
    {
        archive.SetSource("data.bin");
        archive.Save(lzFile);
     }
}

Osservazioni

outputStream deve essere cercabile.

Eccezioni

ArgumentException

outputStream non supporta la ricerca.

ArgumentNullException

outputStream è nullo.

Save(string)

Salva l’archivio lzip nel file di destinazione fornito.

public void Save(string destinationFileName)

Parametri

destinationFileName string

Il percorso dell’archivio da creare. Se il nome del file specificato punta a un file esistente, verrà sovrascritto.

Esempi

using (var archive = new LzipArchive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save("result.lz");
}

Eccezioni

ArgumentNullException

destinationFileName è nullo.

SecurityException

Il chiamante non ha il permesso richiesto per accedere.

ArgumentException

Il destinationFileName è vuoto, contiene solo spazi bianchi o contiene caratteri non validi.

UnauthorizedAccessException

Accesso al file destinationFileName negato.

PathTooLongException

Il destinationFileName, il nome del file o entrambi superano la lunghezza massima definita dal sistema. Ad esempio, sulle piattaforme basate su Windows, i percorsi devono essere inferiori a 248 caratteri e i nomi dei file devono essere inferiori a 260 caratteri.

NotSupportedException

Il file in destinationFileName contiene un due punti (:) nel mezzo della stringa.

Save(FileInfo)

Salva l’archivio lzip nel file di destinazione fornito.

public void Save(FileInfo destination)

Parametri

destination FileInfo

FileInfo che verrà aperto come stream di destinazione.

Esempi

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

Eccezioni

SecurityException

Il chiamante non ha il permesso richiesto per aprire il destination.

ArgumentException

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

FileNotFoundException

Il file non è stato trovato.

UnauthorizedAccessException

Il percorso del file è di sola lettura o è una directory.

ArgumentNullException

destination è nullo.

DirectoryNotFoundException

Il percorso specificato non è valido, ad esempio se si trova su un’unità non mappata.

IOException

Il file è già aperto.

SetSource(Stream)

Imposta il contenuto da comprimere all’interno dell’archivio.

public void SetSource(Stream source)

Parametri

source Stream

Lo stream di input per l’archivio.

Esempi

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

Eccezioni

ArgumentException

Lo stream source non è cercabile.

SetSource(FileInfo)

Imposta il contenuto da comprimere all’interno dell’archivio.

public void SetSource(FileInfo fileInfo)

Parametri

fileInfo FileInfo

FileInfo che verrà aperto come stream di input.

Esempi

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

Eccezioni

SecurityException

Il chiamante non ha il permesso richiesto per aprire il fileInfo.

ArgumentException

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

FileNotFoundException

Il file non è stato trovato.

UnauthorizedAccessException

Il percorso del file è di sola lettura o è una directory.

ArgumentNullException

fileInfo è nullo.

DirectoryNotFoundException

Il percorso specificato non è valido, ad esempio se si trova su un’unità non mappata.

IOException

Il file è già aperto.

SetSource(string)

Imposta il contenuto da comprimere all’interno dell’archivio.

public void SetSource(string path)

Parametri

path string

Percorso al file da comprimere.

Esempi

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

Eccezioni

ArgumentNullException

path è nullo.

SecurityException

Il chiamante non ha il permesso richiesto per accedere.

ArgumentException

Il path è vuoto, contiene solo spazi bianchi o contiene caratteri non validi.

UnauthorizedAccessException

Accesso al file path negato.

PathTooLongException

Il path, il nome del file o entrambi superano la lunghezza massima definita dal sistema. Ad esempio, sulle piattaforme basate su Windows, i percorsi devono essere inferiori a 248 caratteri e i nomi dei file devono essere inferiori a 260 caratteri.

NotSupportedException

Il file in path contiene un due punti (:) nel mezzo della stringa.

 Italiano