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
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
source’ is not seekable.
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
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 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
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
I titoli dell’archivio e le informazioni sul servizio non sono stati letti.
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.
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
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
I titoli dell’archivio e le informazioni sul servizio non sono stati letti.
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.
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(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
output’ does not support seeking.
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
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 XzArchive())
{
archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
archive.Save("archive.xz");
}
Exceptions
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
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 XzArchive())
{
archive.SetSource("data.bin");
archive.Save("archive.xz");
}
Exceptions
sourcePath’ is null.
Il chiamante non ha il permesso di accesso richiesto.
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.