Class XzArchive

Class XzArchive

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

Questa classe rappresenta un file di archivio xz. Usala per comporre ed estrarre archivi xz.

public class XzArchive : IArchive, IDisposable, IArchiveFileEntry

Ereditarietà

objectXzArchive

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

XzArchive(XzArchiveSettings)

Inizializza una nuova istanza della classe Aspose.Zip.Xz.XzArchive e compone l’archivio in formato xz.

public XzArchive(XzArchiveSettings settings = null)

Parametri

settings XzArchiveSettings

Set di impostazioni particolari per l’archivio xz: dimensione del dizionario, dimensione del blocco, tipo di controllo.

XzArchive(Stream)

Inizializza una nuova istanza della classe Aspose.Zip.Xz.XzArchive preparata per la decompressione.

public XzArchive(Stream source)

Parametri

source Stream

La sorgente dell’archivio.

Osservazioni

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

Eccezioni

ArgumentException

source non è cercabile.

ArgumentNullException

source è nullo.

XzArchive(string)

Inizializza una nuova istanza della classe Aspose.Zip.Xz.XzArchive preparata per la decompressione.

public XzArchive(string path)

Parametri

path string

Percorso alla sorgente dell’archivio.

Osservazioni

Questo costruttore non decomprime. Vedi il metodo Aspose.Zip.Xz.XzArchive.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, su 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 si trova su un’unità non mappata.

IOException

Il file è già aperto.

Metodi

Dispose()

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

public void Dispose()

Dispose(bool)

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

protected virtual void Dispose(bool disposing)

Parametri

disposing bool

Se le risorse gestite devono essere liberate.

Extract(Stream)

Estrae l’archivio xz in un flusso.

public void Extract(Stream destination)

Parametri

destination Stream

Flusso per memorizzare i dati decompressi.

Esempi

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

Eccezioni

InvalidOperationException

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

Extract(FileInfo)

Estrae l’archivio xz in un file.

public void Extract(FileInfo fileInfo)

Parametri

fileInfo FileInfo

FileInfo per memorizzare i dati decompressi.

Esempi

using (FileStream xzFile = File.Open(sourceFileName, FileMode.Open))
{
    using (var archive = new XzArchive(xzFile))
    {
        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, come ad esempio essere su un’unità non mappata.

IOException

Il file è già aperto.

Extract(string)

Estrae l’archivio xz in un file tramite percorso.

public FileInfo Extract(string path)

Parametri

path string

Percorso del file che memorizzerà i dati decompressi.

Restituisce

FileInfo

Istanza di System.IO.FileInfo contenente i dati estratti.

Esempi

using (FileStream xzFile = File.Open(sourceFileName, FileMode.Open))
{
    using (var archive = new XzArchive(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, su 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, come ad esempio essere su un’unità non mappata.

IOException

Il file è già aperto.

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, su 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 è preceduto da, o contiene, solo un carattere due punti (:).

IOException

La directory specificata dal percorso è un file. -o- Il nome di rete non è noto.

Save(Stream)

Salva l’archivio xz nel flusso fornito.

public void Save(Stream output)

Parametri

output Stream

Flusso di destinazione.

Esempi

using (FileStream xzFile = File.Open("archive.xz", FileMode.Create))
{
    using (var archive = new XzArchive())
    {
        archive.SetSource("data.bin");
        archive.Save(xzFile);
     }
}

Osservazioni

output deve essere cercabile.

Eccezioni

ArgumentException

output non supporta la ricerca.

ArgumentNullException

output è nullo.

Save(string)

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

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, su 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.

SetSource(Stream)

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

public void SetSource(Stream source)

Parametri

source Stream

Il flusso di input per l’archivio.

Esempi

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

Eccezioni

ArgumentException

Il source flusso 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 flusso di input.

Esempi

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

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, come ad esempio essere 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 flusso di input.

Esempi

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

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

 Italiano