Class LzmaArchive

Class LzmaArchive

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

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

public class LzmaArchive : IArchive, IDisposable, IArchiveFileEntry

Ereditarietà

objectLzmaArchive

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

LzmaArchive(LzmaArchiveSettings)

Inizializza una nuova istanza della classe Aspose.Zip.LZMA.LzmaArchive e compone l’archivio in formato lzma.

public LzmaArchive(LzmaArchiveSettings settings = null)

Parametri

settings LzmaArchiveSettings

Set di impostazioni particolari per l’archivio lzma.

LzmaArchive(Stream)

Inizializza una nuova istanza della classe Aspose.Zip.LZMA.LzmaArchive preparata per la decompressione.

public LzmaArchive(Stream source)

Parametri

source Stream

La sorgente dell’archivio.

Osservazioni

Questo costruttore non decomprime. Vedi il metodo Aspose.Zip.LZMA.LzmaArchive.Extract(System.IO.Stream) per decomprimere.

Eccezioni

ArgumentException

source non è cercabile.

ArgumentNullException

source è nullo.

LzmaArchive(string)

Inizializza una nuova istanza della classe Aspose.Zip.LZMA.LzmaArchive preparata per la decompressione.

public LzmaArchive(string path)

Parametri

path string

Percorso alla sorgente dell’archivio.

Esempi

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

Osservazioni

Questo costruttore non decomprime. Vedi il metodo Aspose.Zip.LZMA.LzmaArchive.Extract(System.IO.Stream) per decomprimere.

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 specificato, il nome del file, o entrambi superano la lunghezza massima definita dal sistema. Ad esempio, nelle 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 a path contiene un due punti (:) nel mezzo della stringa.

Metodi

Dispose()

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

public void Dispose()

Dispose(bool)

Esegue attività definite dall’applicazione associate alla liberazione, al rilascio o al ripristino 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 lzma in uno stream.

public void Extract(Stream destination)

Parametri

destination Stream

Stream per memorizzare i dati decompressi.

Esempi

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

Eccezioni

InvalidOperationException

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

InvalidDataException

L’archivio è corrotto.

ArgumentNullException

Lo stream di destinazione è nullo.

ArgumentException

Lo stream di destinazione non supporta la scrittura.

Extract(FileInfo)

Estrae l’archivio lzma in un file.

public void Extract(FileInfo fileInfo)

Parametri

fileInfo FileInfo

FileInfo per memorizzare i dati decompressi.

Esempi

using (FileStream lzmaFile = File.Open(sourceFileName, FileMode.Open))
{
    using (var archive = new LzmaArchive(lzmaFile))
    {
        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.

InvalidDataException

L’archivio è corrotto.

Extract(string)

Estrae l’archivio lzma in un file tramite percorso.

public void Extract(string path)

Parametri

path string

Percorso del file che memorizzerà i dati decompressi.

Esempi

using (FileStream lzmaFile = File.Open(sourceFileName, FileMode.Open))
{
    using (var archive = new LzmaArchive(lzmaFile))
    {
        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 specificato, il nome del file, o entrambi superano la lunghezza massima definita dal sistema. Ad esempio, nelle 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 a path contiene un due punti (:) nel mezzo della stringa.

InvalidDataException

L’archivio è corrotto.

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, nelle 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 verificare i caratteri non validi utilizzando il metodo System.IO.Path.GetInvalidPathChars. -o- il percorso è preceduto o contiene solo un carattere due punti (:).

IOException

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

InvalidDataException

L’archivio è corrotto.

Save(Stream)

Salva l’archivio lzma nello stream fornito.

public void Save(Stream output)

Parametri

output Stream

Stream di destinazione.

Esempi

using (FileStream lzmaFile = File.Open("archive.lzma", FileMode.Create))
{
    using (var archive = new LzmaArchive())
    {
        archive.SetSource("data.bin");
        archive.Save(lzmaFile);
     }
}

Osservazioni

output deve essere cercabile.

Eccezioni

ArgumentException

output non supporta la ricerca.

ArgumentNullException

output è nullo.

Save(FileInfo)

Salva l’archivio lzma 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 LzmaArchive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save(new FileInfo("archive.lzma"));
}

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.

Save(string)

Salva l’archivio lzma 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 LzmaArchive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save("result.lzma");
}

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 specificato, il nome del file, o entrambi superano la lunghezza massima definita dal sistema. Ad esempio, nelle 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 a destinationFileName contiene un due punti (:) nel mezzo della stringa.

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 LzmaArchive())
{
    archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
    archive.Save("archive.lzma");
}

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 LzmaArchive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save("archive.lzma");
}

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 sourcePath)

Parametri

sourcePath string

Percorso del file che verrà aperto come stream di input.

Esempi

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

Eccezioni

ArgumentNullException

sourcePath è nullo.

SecurityException

Il chiamante non ha il permesso richiesto per accedere.

ArgumentException

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

UnauthorizedAccessException

Accesso al file sourcePath negato.

PathTooLongException

Il sourcePath specificato, il nome del file, o entrambi superano la lunghezza massima definita dal sistema. Ad esempio, nelle 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 a sourcePath contiene un due punti (:) nel mezzo della stringa.

 Italiano