Class ZArchive

Class ZArchive

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

Questa classe rappresenta un file di archivio Z (compressore). utilizzarlo per compilare o estrarre archivi Z.

public class ZArchive : IArchive, IDisposable, IArchiveFileEntry

Inheritance

object ZArchive

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

Remarks

Vedi https://docs.fileformat.com/compression/z/

Constructors

Archivi()

Inizia una nuova instanza della classe Aspose.Zip.Z.Archive preparata per la compressione.

public ZArchive()

Archivi(Strumento, ZArchiveLoadOptions)

Inizia una nuova instanza della classe Aspose.Zip.Z.Archive preparata per la decompressione.

public ZArchive(Stream source, ZArchiveLoadOptions loadOptions = null)

Parameters

source Stream

La fonte dell’archivio.

loadOptions ZArchiveLoadOptions

Le opzioni per caricare archivio con.

Remarks

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

Exceptions

ArgumentException

source’ is not seekable.

ArgumentNullException

source’ is null.

Archivi(String, ZArchiveLoadOptions)

Inizia una nuova instanza della classe Aspose.Zip.Z.Archive preparata per la decompressione.

public ZArchive(string path, ZArchiveLoadOptions loadOptions = null)

Parameters

path string

Il percorso verso la fonte dell’archivio.

loadOptions ZArchiveLoadOptions

Le opzioni per caricare archivio con.

Remarks

Questo costruttore non decomprime. vedi Aspose.Zip.Z.ZArchive.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 Z archivato in un flusso.

public void Extract(Stream destination)

Parameters

destination Stream

Il flusso per la memorizzazione dei dati decompressi.

Examples

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

Exceptions

InvalidDataException

I dati non possono essere decompressi.

Extract(FileInfo)

Estratto Z archivio in un file.

public void Extract(FileInfo fileInfo)

Parameters

fileInfo FileInfo

FileInfo per la memorizzazione dei dati decompressi.

Examples

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

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.

InvalidDataException

I dati non possono essere decompressi.

Extract(String)

Estratto Z 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

Informazioni su un file estratto.

Examples

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

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.

InvalidDataException

I dati non possono essere decompressi.

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(Strumento, ZArchiveSaveOptions)

Salva l’archivio xz al flusso fornito.

public void Save(Stream output, ZArchiveSaveOptions settings = null)

Parameters

output Stream

Il flusso di destinazione.

settings ZArchiveSaveOptions

Impostazioni opzionali per la composizione di archivi.

Examples

using (FileStream zFile = File.Open("data.bin.z", FileMode.Create))
{
    using (var archive = new ZArchive())
    {
        archive.SetSource("data.bin");
        archive.Save(zFile);
     }
}

Remarks

Bisogna essere ricercabile.

Exceptions

ArgumentException

output’ does not support seeking.

ArgumentNullException

output’ is null.

Save(String, ZArchiveSaveOptions)

Salva Z archivio al file di destinazione fornito.

public void Save(string destinationFileName, ZArchiveSaveOptions settings = null)

Parameters

destinationFileName string

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

settings ZArchiveSaveOptions

Impostazioni opzionali per la composizione di archivi.

Examples

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

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

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

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 ZArchive()) 
{
    archive.SetSource("data.bin");
    archive.Save("data.bin.Z");
}

Exceptions

ArgumentNullException

sourcePath’ is null or empty string.

SecurityException

Il chiamante non ha il permesso richiesto per accedere a una risorsa.

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