Class ZArchive

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

object ZArchive

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

ArgumentException

source’ is not seekable.

ArgumentNullException

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

ArgumentNullException

path’ is null.

SecurityException

El client no té el permís d’accés requerit.

ArgumentException

La path’ és buida, només conté espais blancs, o conté caràcters invalidats.

UnauthorizedAccessException

L’accés al fitxer path" es nega.

PathTooLongException

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.

NotSupportedException

El fitxer a path’ conté una columna (:) al mig de la cadena.

FileNotFoundException

El fitxer no es troba.

DirectoryNotFoundException

La ruta especificada és invalidada, com per exemple estar en un disc no mapat.

IOException

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

InvalidDataException

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

SecurityException

El convocador no té el permís requerit per obrir el fileInfo'.

ArgumentException

La ruta de fitxer és buida o només conté espais blancs.

FileNotFoundException

El fitxer no es troba.

UnauthorizedAccessException

El camí a l’arxiu és només llegit o és un directori.

ArgumentNullException

fileInfo’ is null.

DirectoryNotFoundException

La ruta especificada és invalidada, com per exemple estar en un disc no mapat.

IOException

El fitxer ja està obert.

InvalidDataException

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

FileInfo

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

ArgumentNullException

path’ is null.

SecurityException

El client no té el permís d’accés requerit.

ArgumentException

La path’ és buida, només conté espais blancs, o conté caràcters invalidats.

UnauthorizedAccessException

L’accés al fitxer path" es nega.

PathTooLongException

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.

NotSupportedException

El fitxer a path’ conté una columna (:) al mig de la cadena.

InvalidDataException

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

ArgumentNullException

destinationDirectory’ is null.

PathTooLongException

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.

SecurityException

El sol·licitant no té l’autorització necessària per accedir a la direcció existent.

NotSupportedException

Si el directori no existeix, el recorregut conté un caràcter colon (:) que no forma part d’una etiqueta de disc (“C:”).

ArgumentException

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 (:).

IOException

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

ArgumentException

output’ does not support seeking.

ArgumentNullException

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

ArgumentNullException

destinationFileName’ is null.

SecurityException

El client no té el permís d’accés requerit.

ArgumentException

El destinationFileName’ és buit, només conté espais blancs, o conté caràcters invalidats.

UnauthorizedAccessException

L’accés al fitxer destinationFileName’ és negat.

PathTooLongException

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.

NotSupportedException

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

SecurityException

El convocador no té el permís requerit per obrir el fileInfo'.

ArgumentException

La ruta de fitxer és buida o només conté espais blancs.

FileNotFoundException

El fitxer no es troba.

UnauthorizedAccessException

El camí a l’arxiu és només llegit o és un directori.

ArgumentNullException

fileInfo’ is null.

DirectoryNotFoundException

La ruta especificada és invalidada, com per exemple estar en un disc no mapat.

IOException

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

ArgumentNullException

sourcePath’ is null or empty string.

SecurityException

El sol·licitant no té el permís requerit per accedir a un recurs.

ArgumentException

El sourcePath’ és buit, només conté espais blancs, o conté caràcters invalidats.

UnauthorizedAccessException

L’accés al fitxer sourcePath’ es nega.

PathTooLongException

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.

NotSupportedException

El fitxer a sourcePath’ conté una columna (:) al mig de la cadena.

 Català