Class XzArchive

Class XzArchive

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

Questa classe rappresenta il file di archivio xz. Utilizza per compilare e estrarre i file xz.

public class XzArchive : IArchive, IDisposable, IArchiveFileEntry

Inheritance

object XzArchive

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

XzArchive(XzArchiveSettings)

Inizia una nuova instanza della classe Aspose.Zip.Xz.XzArchivio e compone l’archivio in formato xz.

public XzArchive(XzArchiveSettings settings = null)

Parameters

settings XzArchiveSettings

Set di impostazioni specifici xz archivio: dimensione del dizionario, dimensione del blocco, tipo di controllo.

XzArchive(Stream)

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

public XzArchive(Stream source)

Parameters

source Stream

La fonte dell’archivio.

Remarks

Questo costruttore non decomprime. vedi Aspose.Zip.Xz.XzArchive.Extract(System.IO.Stream) metodo di decompressione.

Exceptions

ArgumentException

source’ is not seekable.

ArgumentNullException

source’ is null.

XzArchive(String)

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

public XzArchive(string path)

Parameters

path string

Il percorso verso la fonte dell’archivio.

Remarks

Questo costruttore non decomprime. vedi Aspose.Zip.Xz.XzArchive.Extract(System.IO.Stream) metodo di decompressione.

Exceptions

ArgumentNullException

path’ is null.

SecurityException

Il chiamante 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.

FileNotFoundException

Il file non è trovato.

DirectoryNotFoundException

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

IOException

Il file è già aperto.

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(Stream)

Estratto xz archivio in un flusso.

public void Extract(Stream destination)

Parameters

destination Stream

Il flusso per la memorizzazione dei dati decompressi.

Examples

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

Exceptions

InvalidOperationException

I titoli dell’archivio e le informazioni sul servizio non sono stati letti.

Extract(FileInfo)

Estratto xz archivio in un file.

public void Extract(FileInfo fileInfo)

Parameters

fileInfo FileInfo

FileInfo per la memorizzazione dei dati decompressi.

Examples

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

Exceptions

InvalidOperationException

I titoli dell’archivio e le informazioni sul servizio non sono stati letti.

SecurityException

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

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

fileInfo’ is null.

DirectoryNotFoundException

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

IOException

Il file è già aperto.

Extract(String)

Estratto xz archivio a un file per percorso.

public FileInfo Extract(string path)

Parameters

path string

Il percorso verso il file che memorizzerà i dati decompressi.

Returns

FileInfo

System.IO.FileInfo instanza contenente dati estratti.

Examples

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

Exceptions

InvalidOperationException

I titoli dell’archivio e le informazioni sul servizio non sono stati letti.

ArgumentNullException

path’ is null.

SecurityException

Il chiamante 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.

FileNotFoundException

Il file non è trovato.

DirectoryNotFoundException

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

IOException

Il file è già aperto.

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.

Save(Stream)

Salva l’archivio xz al flusso fornito.

public void Save(Stream output)

Parameters

output Stream

Il flusso di destinazione.

Examples

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

Remarks

Bisogna essere ricercabile.

Exceptions

ArgumentException

output’ does not support seeking.

ArgumentNullException

output’ is null.

Save(String)

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

Exceptions

ArgumentNullException

destinationFileName’ is null.

SecurityException

Il chiamante 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.

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

Exceptions

ArgumentException

Il flusso di source è indesiderabile.

SetSource(FileInfo)

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

public void SetSource(FileInfo fileInfo)

Parameters

fileInfo FileInfo

FileInfo, che verrà aperto come flusso di input.

Examples

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

Exceptions

SecurityException

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

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

fileInfo’ is null.

DirectoryNotFoundException

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

IOException

Il file è già aperto.

SetSource(String)

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

public void SetSource(string sourcePath)

Parameters

sourcePath string

Il percorso verso il file che verrà aperto come flusso di input.

Examples

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

Exceptions

ArgumentNullException

sourcePath’ is null.

SecurityException

Il chiamante non ha il permesso di accesso richiesto.

ArgumentException

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

UnauthorizedAccessException

L’accesso al file sourcePath’ è negato.

PathTooLongException

La specifica sourcePath’, 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 sourcePath’ contiene una colonna (:) nel mezzo della riga.

 Italiano