Class XzArchive
Nom dels espais: Aspose.Zip.Xz Assemblea: Aspose.Zip.dll (25.5.0)
Aquesta classe representa el fitxer d’arxiu xz. Utilitzeu-lo per compondre i extreure arxius xz.
public class XzArchive : IArchive, IDisposable, IArchiveFileEntry
Inheritance
Implements
IArchive , IDisposable , IArchiveFileEntry
Membres heretats
object.GetType() , object.MemberwiseClone() , object.ToString() , object.Equals(object?) , object.Equals(object?, object?) , object.ReferenceEquals(object?, object?) , object.GetHashCode()
Constructors
XzArchive(XzArchiveSettings)
Inicialitza una nova instància de la classe Aspose.Zip.Xz.XzArxiu i componeix l’arxiu en format xz.
public XzArchive(XzArchiveSettings settings = null)
Parameters
settings
XzArchiveSettings
Set de configuració específic xz arxiu: mida del diccionari, mida del bloc, tipus de comprovaci.
XzArchive(Stream)
Inicia una nova instància de la classe Aspose.Zip.Xz.XzArchive preparada per a la decompressi.
public XzArchive(Stream source)
Parameters
source
Stream
La font de l’arxiu.
Remarks
Aquest constructor no descomprimeix. Veure Aspose.Zip.Xz.XzArchive.Extract(System.IO.Stream) mètode de descompressi.
Exceptions
source’ is not seekable.
source’ is null.
XzArchive(Tàrrega)
Inicia una nova instància de la classe Aspose.Zip.Xz.XzArchive preparada per a la decompressi.
public XzArchive(string path)
Parameters
path
string
El camí cap a la font de l’arxiu.
Remarks
Aquest constructor no descomprimeix. Veure Aspose.Zip.Xz.XzArchive.Extract(System.IO.Stream) mètode de descompressi.
Exceptions
path’ is null.
El client no té el permís d’accés requerit.
La path’ és buida, només conté espais blancs, o conté caràcters invalidats.
L’accés al fitxer path" es nega.
El nom de fitxer especificat path", o tots dos superen la longitud màxima definida pel sistema. per exemple, en les plataformes basades en Windows, els passos han de ser menys de 248 caràcters, i els noms de fitxer han de ser menys de 260 caràcters.
El fitxer a path’ conté una columna (:) al mig de la cadena.
El fitxer no es troba.
La ruta especificada és invalidada, com per exemple estar en un disc no mapat.
El fitxer ja està obert.
Methods
Dispose()
Realitza tasques definides per aplicació associades amb el lliurament, el lliurament o la restauració de recursos no gestionats.
public void Dispose()
Dispose(La botiga)
Realitza tasques definides per aplicació associades amb el lliurament, el lliurament o la restauració de recursos no gestionats.
protected virtual void Dispose(bool disposing)
Parameters
disposing
bool
S’han de disposar de recursos gestionats.
Extract(Stream)
Extracte xz arxiu a un flux.
public void Extract(Stream destination)
Parameters
destination
Stream
Flux per a l’emmagatzematge de dades decompreses.
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
No s’ha llegit cap titulació d’arxiu i informació de servei.
Extract(FileInfo)
Extracte xz arxiu a un fitxer.
public void Extract(FileInfo fileInfo)
Parameters
fileInfo
FileInfo
FileInfo per a l’emmagatzematge de dades decompreses.
Examples
using (FileStream xzFile = File.Open(sourceFileName, FileMode.Open))
{
using (var archive = new XzArchive(xzFile))
{
archive.Extract(new FileInfo("extracted.bin"));
}
}
Exceptions
No s’ha llegit cap titulació d’arxiu i informació de servei.
El convocador no té el permís requerit per obrir el fileInfo'.
La ruta de fitxer és buida o només conté espais blancs.
El fitxer no es troba.
El camí a l’arxiu és només llegit o és un directori.
fileInfo’ is null.
La ruta especificada és invalidada, com per exemple estar en un disc no mapat.
El fitxer ja està obert.
Extract(Tàrrega)
Extracte xz arxiu a un arxiu per ruta.
public FileInfo Extract(string path)
Parameters
path
string
El camí al fitxer que emmagatzemarà les dades decompreses.
Returns
Sistema.IO.FileInfo instància que conté dades extraïdes.
Examples
using (FileStream xzFile = File.Open(sourceFileName, FileMode.Open))
{
using (var archive = new XzArchive(xzFile))
{
archive.Extract("extracted.bin");
}
}
Exceptions
No s’ha llegit cap titulació d’arxiu i informació de servei.
path’ is null.
El client no té el permís d’accés requerit.
La path’ és buida, només conté espais blancs, o conté caràcters invalidats.
L’accés al fitxer path" es nega.
El nom de fitxer especificat path", o tots dos superen la longitud màxima definida pel sistema. per exemple, en les plataformes basades en Windows, els passos han de ser menys de 248 caràcters, i els noms de fitxer han de ser menys de 260 caràcters.
El fitxer a path’ conté una columna (:) al mig de la cadena.
El fitxer no es troba.
La ruta especificada és invalidada, com per exemple estar en un disc no mapat.
El fitxer ja està obert.
ExtractToDirectory(Tàrrega)
Extreu el contingut de l’arxiu a la direcció proporcionada.
public void ExtractToDirectory(string destinationDirectory)
Parameters
destinationDirectory
string
El camí a la direcció per col·locar els arxius extraïts.
Remarks
Si la direcció no existeix, es crear.
Exceptions
destinationDirectory’ is null.
Per exemple, en les plataformes basades en Windows, els camins han de ser menys de 248 caràcters i els noms de fitxers han de ser menys de 260 caràcters.
El sol·licitant no té l’autorització necessària per accedir a la direcció existent.
Si el directori no existeix, el recorregut conté un caràcter colon (:) que no forma part d’una etiqueta de disc (“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 (:).
El directori especificat per ruta és un arxiu. -o- El nom de la xarxa no és conegut.
Save(Stream)
Salva l’arxiu xz al corrent proporcionat.
public void Save(Stream output)
Parameters
output
Stream
El flux de destinaci.
Examples
using (FileStream xzFile = File.Open("archive.xz", FileMode.Create))
{
using (var archive = new XzArchive())
{
archive.SetSource("data.bin");
archive.Save(xzFile);
}
}
Remarks
ha de ser buscable.
Exceptions
output’ does not support seeking.
output’ is null.
Save(Tàrrega)
Salva l’arxiu xz al fitxer de destinació proporcionat.
public void Save(string destinationFileName)
Parameters
destinationFileName
string
El camí de l’arxiu que s’ha de crear. Si el nom de fitxer especificat indica un fitxer existent, serà sobreescrit.
Examples
using (var archive = new XzArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("result.xz");
}
Exceptions
destinationFileName’ is null.
El client no té el permís d’accés requerit.
El destinationFileName’ és buit, només conté espais blancs, o conté caràcters invalidats.
L’accés al fitxer destinationFileName’ és negat.
El nom de fitxer especificat destinationFileName, o ambdós superen la longitud màxima definida pel sistema. Per exemple, en les plataformes basades en Windows, els camins han de ser menys de 248 caràcters, i els noms de fitxer han de ser menys de 260 caràcters.
El fitxer a destinationFileName’ conté una columna (:) al mig de la cadena.
SetSource(Stream)
Establir el contingut per a ser comprès dins de l’arxiu.
public void SetSource(Stream source)
Parameters
source
Stream
El flux d’entrada per a l’arxiu.
Examples
using (var archive = new XzArchive())
{
archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
archive.Save("archive.xz");
}
Exceptions
El flux de font és indesitjable.
SetSource(FileInfo)
Establir el contingut per a ser comprès dins de l’arxiu.
public void SetSource(FileInfo fileInfo)
Parameters
fileInfo
FileInfo
FileInfo, que s’obrirà com a flux d’entrada.
Examples
using (var archive = new XzArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("archive.xz");
}
Exceptions
El convocador no té el permís requerit per obrir el fileInfo'.
La ruta de fitxer és buida o només conté espais blancs.
El fitxer no es troba.
El camí a l’arxiu és només llegit o és un directori.
fileInfo’ is null.
La ruta especificada és invalidada, com per exemple estar en un disc no mapat.
El fitxer ja està obert.
SetSource(Tàrrega)
Establir el contingut per a ser comprès dins de l’arxiu.
public void SetSource(string sourcePath)
Parameters
sourcePath
string
El camí al fitxer que s’obrirà com a flux d’entrada.
Examples
using (var archive = new XzArchive())
{
archive.SetSource("data.bin");
archive.Save("archive.xz");
}
Exceptions
sourcePath’ is null.
El client no té el permís d’accés requerit.
El sourcePath’ és buit, només conté espais blancs, o conté caràcters invalidats.
L’accés al fitxer sourcePath’ es nega.
L’especificada sourcePath’, nom de fitxer, o ambdós superen la longitud màxima definida pel sistema. Per exemple, en les plataformes basades en Windows, els camins han de ser menys de 248 caràcters, i els noms de fitxer han de ser menys de 260 caràcters.
El fitxer a sourcePath’ conté una columna (:) al mig de la cadena.