Class ZArchive
Nom dels espais: Aspose.Zip.Z Assemblea: Aspose.Zip.dll (25.5.0)
Aquesta classe representa un fitxer d’arxiu Z (compressor). utilitzeu-lo per compondre o extreure arxius Z.
public class ZArchive : 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()
Remarks
Veure https://docs.fileformat.com/compressi ó/z/
Constructors
Arxiu()
Inicia una nova instància de la classe Aspose.Zip.ZArchive preparada per a la compressi.
public ZArchive()
Arxiu(Arxiu, Arxiu i Opcions)
Inicia una nova instància de la classe Aspose.Zip.ZArchive preparada per a la decompressi.
public ZArchive(Stream source, ZArchiveLoadOptions loadOptions = null)
Parameters
source
Stream
La font de l’arxiu.
loadOptions
ZArchiveLoadOptions
Les opcions per carregar arxius amb.
Remarks
Aquest constructor no descomprimeix. Veure Aspose.Zip.Z.ZArchive.Extract(System.IO.Stream) mètode de descompressi.
Exceptions
source’ is not seekable.
source’ is null.
Arxiu(Arxiu, Arxiu Opcions)
Inicia una nova instància de la classe Aspose.Zip.ZArchive preparada per a la decompressi.
public ZArchive(string path, ZArchiveLoadOptions loadOptions = null)
Parameters
path
string
El camí cap a la font de l’arxiu.
loadOptions
ZArchiveLoadOptions
Les opcions per carregar arxius amb.
Remarks
Aquest constructor no descomprimeix. Veure Aspose.Zip.Z.ZArchive.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)
Extracteu l’arxiu Z a un corrent.
public void Extract(Stream destination)
Parameters
destination
Stream
Flux per a l’emmagatzematge de dades decompreses.
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
Les dades no es poden descomprimir.
Extract(FileInfo)
Extracte Z arxiu a un arxiu.
public void Extract(FileInfo fileInfo)
Parameters
fileInfo
FileInfo
FileInfo per a l’emmagatzematge de dades decompreses.
Examples
using (FileStream zFile = File.Open(sourceFileName, FileMode.Open))
{
using (var archive = new ZArchive(zFile))
{
archive.Extract(new FileInfo("extracted.bin"));
}
}
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.
Les dades no es poden descomprimir.
Extract(Tàrrega)
Extracta l’arxiu Z a un arxiu per cam.
public FileInfo Extract(string path)
Parameters
path
string
El camí al fitxer que emmagatzemarà les dades decompreses.
Returns
Informació d’un arxiu extraït.
Examples
using (FileStream zFile = File.Open(sourceFileName, FileMode.Open))
{
using (var archive = new ZArchive(zFile))
{
archive.Extract("extracted.bin");
}
}
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.
Les dades no es poden descomprimir.
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(Arxiu, ArxiuSaveOptions)
Salva l’arxiu xz al corrent proporcionat.
public void Save(Stream output, ZArchiveSaveOptions settings = null)
Parameters
output
Stream
El flux de destinaci.
settings
ZArchiveSaveOptions
Configuració opcional per a la composició d’arxius.
Examples
using (FileStream zFile = File.Open("data.bin.z", FileMode.Create))
{
using (var archive = new ZArchive())
{
archive.SetSource("data.bin");
archive.Save(zFile);
}
}
Remarks
ha de ser buscable.
Exceptions
output’ does not support seeking.
output’ is null.
Save(Arxiu, ArxiuSaveOptions)
Salva l’arxiu Z al fitxer de destinació proporcionat.
public void Save(string destinationFileName, ZArchiveSaveOptions settings = null)
Parameters
destinationFileName
string
+El camí de l’arxiu a crear. Si el nom de fitxer especificat indica un fitxer existent, serà sobreescrit.
settings
ZArchiveSaveOptions
Configuració opcional per a la composició d’arxius.
Examples
using (var archive = new ZArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("data.bin.Z");
}
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 ZArchive())
{
archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
archive.Save("archive.Z");
}
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 ZArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("data.bin.Z");
}
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 ZArchive())
{
archive.SetSource("data.bin");
archive.Save("data.bin.Z");
}
Exceptions
sourcePath’ is null or empty string.
El sol·licitant no té el permís requerit per accedir a un recurs.
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.