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
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
source’ is not seekable.
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
path’ is null.
Il chiamante non ha il permesso di accesso richiesto.
La path’ è vuota, contiene solo spazi bianchi, o contiene caratteri invalidi.
L’accesso al file path" è rifiutato.
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.
Il file in path’ contiene una colonna (:) nel mezzo della riga.
Il file non è trovato.
Il percorso specificato è invalido, ad esempio essere su un drive non mappato.
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
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
Il chiamante non ha il permesso richiesto per aprire il fileInfo'.
Il percorso di file è vuoto o contiene solo spazi bianchi.
Il file non è trovato.
Il percorso per il file è letto solo o è un directory.
fileInfo’ is null.
Il percorso specificato è invalido, ad esempio essere su un drive non mappato.
Il file è già aperto.
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
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
path’ is null.
Il chiamante non ha il permesso di accesso richiesto.
La path’ è vuota, contiene solo spazi bianchi, o contiene caratteri invalidi.
L’accesso al file path" è rifiutato.
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.
Il file in path’ contiene una colonna (:) nel mezzo della riga.
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
destinationDirectory’ is null.
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.
Il chiamante non ha il permesso richiesto per accedere al directory esistente.
Se la directory non esiste, il percorso contiene un carattere colonico (:) che non fa parte di un’etichetta drive (“C:”).
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 (:).
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
output’ does not support seeking.
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
destinationFileName’ is null.
Il chiamante non ha il permesso di accesso richiesto.
La destinationFileName’ è vuota, contiene solo spazi bianchi, o contiene caratteri invalidi.
L’accesso al file destinationFileName’ è negato.
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.
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
Il chiamante non ha il permesso richiesto per aprire il fileInfo'.
Il percorso di file è vuoto o contiene solo spazi bianchi.
Il file non è trovato.
Il percorso per il file è letto solo o è un directory.
fileInfo’ is null.
Il percorso specificato è invalido, ad esempio essere su un drive non mappato.
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
sourcePath’ is null or empty string.
Il chiamante non ha il permesso richiesto per accedere a una risorsa.
La sourcePath’ è vuota, contiene solo spazi bianchi, o contiene caratteri invalidi.
L’accesso al file sourcePath’ è negato.
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.
Il file in sourcePath’ contiene una colonna (:) nel mezzo della riga.