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à
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
source
non è cercabile.
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
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 in path
contiene un due punti (:) nel mezzo della stringa.
Il file non è stato trovato.
Il percorso specificato non è valido, ad esempio si trova su un’unità non mappata.
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
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
Le intestazioni dell’archivio e le informazioni di servizio non sono state lette.
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.
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
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
Le intestazioni dell’archivio e le informazioni di servizio non sono state lette.
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 in path
contiene un 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.
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 è preceduto da, o contiene, solo un carattere due punti (:).
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
output
non supporta la ricerca.
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
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 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
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
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 flusso di input.
Esempi
using (var archive = new XzArchive())
{
archive.SetSource("data.bin");
archive.Save("archive.xz");
}
Eccezioni
sourcePath
è nullo.
Il chiamante non ha il permesso richiesto per accedere.
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 in sourcePath
contiene un due punti (:) nel mezzo della stringa.