Class ZArchive
Namespace: Aspose.Zip.Z
Assembly: Aspose.Zip.dll (25.1.0)
Questa classe rappresenta un file di archivio Z (compress). Usala per comporre o estrarre archivi Z.
public class ZArchive : IArchive, IDisposable, IArchiveFileEntryEreditarietà
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()
Osservazioni
Vedi https://docs.fileformat.com/compression/z/
Costruttori
ZArchive()
Inizializza una nuova istanza della classe Aspose.Zip.Z.ZArchive preparata per la compressione.
public ZArchive()ZArchive(Stream, ZArchiveLoadOptions)
Inizializza una nuova istanza della classe Aspose.Zip.Z.ZArchive preparata per la decompressione.
public ZArchive(Stream source, ZArchiveLoadOptions loadOptions = null)Parametri
source Stream
La sorgente dell’archivio.
loadOptions ZArchiveLoadOptions
Le opzioni per caricare l’archivio.
Osservazioni
Questo costruttore non decomprime. Vedi il metodo Aspose.Zip.Z.ZArchive.Extract(System.IO.Stream) per la decompressione.
Eccezioni
source non è cercabile.
source è nullo.
ZArchive(string, ZArchiveLoadOptions)
Inizializza una nuova istanza della classe Aspose.Zip.Z.ZArchive preparata per la decompressione.
public ZArchive(string path, ZArchiveLoadOptions loadOptions = null)Parametri
path string
Percorso alla sorgente dell’archivio.
loadOptions ZArchiveLoadOptions
Le opzioni per caricare l’archivio.
Osservazioni
Questo costruttore non decomprime. Vedi il metodo Aspose.Zip.Z.ZArchive.Extract(System.IO.Stream) per la decompressione.
Eccezioni
path è nullo.
Il chiamante non ha il permesso richiesto per accedere.
Il path è vuoto, contiene solo spazi bianchi o contiene caratteri non validi.
Accesso al file path negato.
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.
Il file a path contiene due punti (:) nel mezzo della stringa.
Il file non è stato trovato.
Il percorso specificato non è valido, come ad esempio essere su un’unità non mappata.
Il file è già aperto.
Metodi
Dispose()
Esegue attività definite dall’applicazione associate al rilascio, liberazione o reimpostazione delle risorse non gestite.
public void Dispose()Dispose(bool)
Esegue attività definite dall’applicazione associate al rilascio, liberazione 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 Z in uno stream.
public void Extract(Stream destination)Parametri
destination Stream
Stream per memorizzare i dati decompressi.
Esempi
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);
}
}
}Eccezioni
I dati non possono essere decompressi.
Extract(FileInfo)
Estrae l’archivio Z in un file.
public void Extract(FileInfo fileInfo)Parametri
fileInfo FileInfo
FileInfo per memorizzare i dati decompressi.
Esempi
using (FileStream zFile = File.Open(sourceFileName, FileMode.Open))
{
using (var archive = new ZArchive(zFile))
{
archive.Extract(new FileInfo("extracted.bin"));
}
}Eccezioni
Il chiamante non ha il permesso richiesto per aprire il fileInfo.
Il percorso del file è vuoto o contiene solo spazi bianchi.
Il file non è stato trovato.
Il percorso del file è di sola lettura o è una directory.
fileInfo è nullo.
Il percorso specificato non è valido, come ad esempio essere su un’unità non mappata.
Il file è già aperto.
I dati non possono essere decompressi.
Extract(string)
Estrae l’archivio Z in un file tramite percorso.
public FileInfo Extract(string path)Parametri
path string
Percorso del file che memorizzerà i dati decompressi.
Restituisce
Info del file estratto.
Esempi
using (FileStream zFile = File.Open(sourceFileName, FileMode.Open))
{
using (var archive = new ZArchive(zFile))
{
archive.Extract("extracted.bin");
}
}Eccezioni
path è nullo.
Il chiamante non ha il permesso richiesto per accedere.
Il path è vuoto, contiene solo spazi bianchi o contiene caratteri non validi.
Accesso al file path negato.
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.
Il file a path contiene due punti (:) nel mezzo della stringa.
I dati non possono essere decompressi.
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
destinationDirectory è nullo.
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.
Il chiamante non ha il permesso richiesto per accedere alla directory esistente.
Se la directory non esiste, il percorso contiene un carattere due punti (:) che non fa parte di un’etichetta di unità (“C:").
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 (:).
La directory specificata dal percorso è un file. -o- Il nome della rete non è conosciuto.
Save(Stream, ZArchiveSaveOptions)
Salva l’archivio xz nello stream fornito.
public void Save(Stream output, ZArchiveSaveOptions settings = null)Parametri
output Stream
Stream di destinazione.
settings ZArchiveSaveOptions
Impostazioni opzionali per la composizione dell’archivio.
Esempi
using (FileStream zFile = File.Open("data.bin.z", FileMode.Create))
{
using (var archive = new ZArchive())
{
archive.SetSource("data.bin");
archive.Save(zFile);
}
}Osservazioni
output deve essere cercabile.
Eccezioni
output non supporta la ricerca.
output è nullo.
Save(string, ZArchiveSaveOptions)
Salva l’archivio Z nel file di destinazione fornito.
public void Save(string destinationFileName, ZArchiveSaveOptions settings = null)Parametri
destinationFileName string
+Il percorso dell’archivio da creare. Se il nome del file specificato punta a un file esistente, verrà sovrascritto.
settings ZArchiveSaveOptions
Impostazioni opzionali per la composizione dell’archivio.
Esempi
using (var archive = new ZArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("data.bin.Z");
}Eccezioni
destinationFileName è nullo.
Il chiamante non ha il permesso richiesto per accedere.
Il destinationFileName è vuoto, contiene solo spazi bianchi o contiene caratteri non validi.
Accesso al file destinationFileName negato.
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.
Il file a destinationFileName contiene 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 ZArchive())
{
archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
archive.Save("archive.Z");
}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 ZArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("data.bin.Z");
}Eccezioni
Il chiamante non ha il permesso richiesto per aprire il fileInfo.
Il percorso del file è vuoto o contiene solo spazi bianchi.
Il file non è stato trovato.
Il percorso del file è di sola lettura o è una directory.
fileInfo è nullo.
Il percorso specificato non è valido, come ad esempio essere su un’unità non mappata.
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 ZArchive())
{
archive.SetSource("data.bin");
archive.Save("data.bin.Z");
}Eccezioni
sourcePath è nullo o una stringa vuota.
Il chiamante non ha il permesso richiesto per accedere a una risorsa.
Il sourcePath è vuoto, contiene solo spazi bianchi o contiene caratteri non validi.
Accesso al file sourcePath negato.
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.
Il file a sourcePath contiene due punti (:) nel mezzo della stringa.
