Class ZArchive

Class ZArchive

Numele spaţiului: Aspose.Zip.Z Asamblare: Aspose.Zip.dll (25.5.0)

Această clasă reprezintă un fișier de arhivă Z (comprimat). utilizați-l pentru a compune sau extrage arhivele Z.

public class ZArchive : IArchive, IDisposable, IArchiveFileEntry

Inheritance

object ZArchive

Implements

IArchive , IDisposable , IArchiveFileEntry

Membrii moștenitori

object.GetType() , object.MemberwiseClone() , object.ToString() , object.Equals(object?) , object.Equals(object?, object?) , object.ReferenceEquals(object?, object?) , object.GetHashCode()

Remarks

Vezi https://docs.fileformat.com/compression/z/

Constructors

Arhiva()

Inițializează o nouă instanță a clasei Aspose.Zip.ZArchive pregătite pentru compresie.

public ZArchive()

Arhiva(Cuvânt cheie, ZArchiveLoadOptions)

Inițializează o nouă instanță a clasei Aspose.Zip.ZArchive pregătite pentru decompresie.

public ZArchive(Stream source, ZArchiveLoadOptions loadOptions = null)

Parameters

source Stream

Sursă a arhivelor.

loadOptions ZArchiveLoadOptions

Opțiunile de încărcare a arhivelor cu.

Remarks

Acest constructor nu decomprime. a se vedea Aspose.Zip.Z.ZArchive.Extract(System.IO.Stream) metoda de decomprimare.

Exceptions

ArgumentException

source’ is not seekable.

ArgumentNullException

source’ is null.

Arhiva(Cuvânt cheie, ZArchiveLoadOptions)

Inițializează o nouă instanță a clasei Aspose.Zip.ZArchive pregătite pentru decompresie.

public ZArchive(string path, ZArchiveLoadOptions loadOptions = null)

Parameters

path string

Calea spre sursa arhivelor.

loadOptions ZArchiveLoadOptions

Opțiunile de încărcare a arhivelor cu.

Remarks

Acest constructor nu decomprime. a se vedea Aspose.Zip.Z.ZArchive.Extract(System.IO.Stream) metoda de decomprimare.

Exceptions

ArgumentNullException

path’ is null.

SecurityException

Solicitantul nu are permisiunea necesară de acces.

ArgumentException

Calea " este goală, conține doar spații albe sau conține caractere invalide.

UnauthorizedAccessException

Accesul la fișierul path" este refuzat.

PathTooLongException

Calea specificată path’, numele fișierului, sau ambele depășesc lungimea maximă definită de sistem. De exemplu, pe platformele bazate pe Windows, căile trebuie să fie mai puțin de 248 de caractere, iar numele fișierului trebuie să fie mai puțin de 260 de caractere.

NotSupportedException

Fișierul la path’ conține o coloană (:) în mijlocul stringului.

FileNotFoundException

Dosarul nu a fost găsit.

DirectoryNotFoundException

Calea specificată este invalidă, de exemplu, fiind pe un motor necartat.

IOException

Dosarul este deja deschis.

Methods

Dispose()

Îndeplinește sarcini definite prin aplicare asociate cu eliberarea, eliberarea sau redistribuirea resurselor necontrolate.

public void Dispose()

Dispose(Boulă)

Îndeplinește sarcini definite prin aplicare asociate cu eliberarea, eliberarea sau redistribuirea resurselor necontrolate.

protected virtual void Dispose(bool disposing)

Parameters

disposing bool

În cazul în care resursele gestionate ar trebui să fie eliminate.

Extract(Stream)

Extractează Z în arhivă într-un flux.

public void Extract(Stream destination)

Parameters

destination Stream

Stream pentru stocarea datelor decomprimate.

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

Datele nu pot fi decomprimate.

Extract(FileInfo)

Extrage Z arhivă într-un fișier.

public void Extract(FileInfo fileInfo)

Parameters

fileInfo FileInfo

FileInfo pentru stocarea datelor decomprimate.

Examples

using (FileStream zFile = File.Open(sourceFileName, FileMode.Open))
{
    using (var archive = new ZArchive(zFile))
    {
        archive.Extract(new FileInfo("extracted.bin"));
    }
}

Exceptions

SecurityException

Solicitantul nu are permisiunea necesară pentru a deschide fileInfo'.

ArgumentException

Calea fișierului este goală sau conține doar spații albe.

FileNotFoundException

Dosarul nu a fost găsit.

UnauthorizedAccessException

Calea către fișier este doar o lectură sau este un director.

ArgumentNullException

fileInfo’ is null.

DirectoryNotFoundException

Calea specificată este invalidă, de exemplu, fiind pe un motor necartat.

IOException

Dosarul este deja deschis.

InvalidDataException

Datele nu pot fi decomprimate.

Extract(Strângere)

Extrage Z arhivă la un fișier pe cale.

public FileInfo Extract(string path)

Parameters

path string

Calea către fișier care va stoca datele decomprimate.

Returns

FileInfo

Informații despre un fișier extras.

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

Solicitantul nu are permisiunea necesară de acces.

ArgumentException

Calea " este goală, conține doar spații albe sau conține caractere invalide.

UnauthorizedAccessException

Accesul la fișierul path" este refuzat.

PathTooLongException

Calea specificată path’, numele fișierului, sau ambele depășesc lungimea maximă definită de sistem. De exemplu, pe platformele bazate pe Windows, căile trebuie să fie mai puțin de 248 de caractere, iar numele fișierului trebuie să fie mai puțin de 260 de caractere.

NotSupportedException

Fișierul la path’ conține o coloană (:) în mijlocul stringului.

InvalidDataException

Datele nu pot fi decomprimate.

ExtractToDirectory(Strângere)

Extrage conținutul arhivului în directorul furnizat.

public void ExtractToDirectory(string destinationDirectory)

Parameters

destinationDirectory string

Calea către directorie pentru a pune în fișierele extrase.

Remarks

Dacă directorul nu există, acesta va fi creat.

Exceptions

ArgumentNullException

destinationDirectory’ is null.

PathTooLongException

Calea specificată, numele fișierului sau ambele depășesc lungimea maximă definită de sistem. De exemplu, pe platformele bazate pe Windows, căile trebuie să fie mai puțin de 248 de caractere, iar numele fișierului trebuie să fie mai puțin de 260 de caractere.

SecurityException

Solicitantul nu are permisiunea necesară pentru a accesa directorul existent.

NotSupportedException

Dacă directorul nu există, calea conține un caracter colon (:) care nu face parte dintr-o etichetă 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

Directoriul specificat de cale este un fișier. -or- Numele rețelei nu este cunoscut.

Save(Arhivă, ZArchiveSaveOptions)

Salvează arhiva xz în fluxul furnizat.

public void Save(Stream output, ZArchiveSaveOptions settings = null)

Parameters

output Stream

Războiul de destinaţie.

settings ZArchiveSaveOptions

Setări opționale pentru compoziția arhivelor.

Examples

using (FileStream zFile = File.Open("data.bin.z", FileMode.Create))
{
    using (var archive = new ZArchive())
    {
        archive.SetSource("data.bin");
        archive.Save(zFile);
     }
}

Remarks

Trebuie să fie căutată.

Exceptions

ArgumentException

output’ does not support seeking.

ArgumentNullException

output’ is null.

Save(Cuvânt cheie, ZArchiveSaveOptions)

Salvează arhiva Z în fișierul de destinație furnizat.

public void Save(string destinationFileName, ZArchiveSaveOptions settings = null)

Parameters

destinationFileName string

Dacă numele fișierului specific se referă la un fișier existent, acesta va fi supraîncris.

settings ZArchiveSaveOptions

Setări opționale pentru compoziția arhivelor.

Examples

using (var archive = new ZArchive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save("data.bin.Z");
}

Exceptions

ArgumentNullException

destinationFileName’ is null.

SecurityException

Solicitantul nu are permisiunea necesară de acces.

ArgumentException

destinationFileName’ este gol, conține doar spații albe sau conține caractere invalide.

UnauthorizedAccessException

Accesul la fișierul destinationFileName’ este refuzat.

PathTooLongException

De exemplu, pe platformele bazate pe Windows, căile trebuie să fie mai puțin de 248 de caractere, iar numele fișierului trebuie să fie mai puțin de 260 de caractere.

NotSupportedException

Fișierul la destinationFileName’ conține o coloană (:) în mijlocul stringului.

SetSource(Stream)

Puneți conținutul pentru a fi comprimat în arhivă.

public void SetSource(Stream source)

Parameters

source Stream

Rata de intrare pentru arhivă.

Examples

using (var archive = new ZArchive())
{
    archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
    archive.Save("archive.Z");
}

SetSource(FileInfo)

Puneți conținutul pentru a fi comprimat în arhivă.

public void SetSource(FileInfo fileInfo)

Parameters

fileInfo FileInfo

FileInfo, care va fi deschis ca flux de intrare.

Examples

using (var archive = new ZArchive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save("data.bin.Z");
}

Exceptions

SecurityException

Solicitantul nu are permisiunea necesară pentru a deschide fileInfo'.

ArgumentException

Calea fișierului este goală sau conține doar spații albe.

FileNotFoundException

Dosarul nu a fost găsit.

UnauthorizedAccessException

Calea către fișier este doar o lectură sau este un director.

ArgumentNullException

fileInfo’ is null.

DirectoryNotFoundException

Calea specificată este invalidă, de exemplu, fiind pe un motor necartat.

IOException

Dosarul este deja deschis.

SetSource(Strângere)

Puneți conținutul pentru a fi comprimat în arhivă.

public void SetSource(string sourcePath)

Parameters

sourcePath string

Calea către fișier care va fi deschisă ca flux de intrare.

Examples

using (var archive = new ZArchive()) 
{
    archive.SetSource("data.bin");
    archive.Save("data.bin.Z");
}

Exceptions

ArgumentNullException

sourcePath’ is null or empty string.

SecurityException

Solicitantul nu are permisiunea necesară pentru a accesa o resursă.

ArgumentException

sourcePath’ este gol, conține doar spații albe sau conține caractere invalide.

UnauthorizedAccessException

Accesul la fișierul sourcePath’ este refuzat.

PathTooLongException

Numele de fișier sau ambele depășesc lungimea maximă definită de sistem. De exemplu, pe platformele bazate pe Windows, căile trebuie să fie mai puțin de 248 de caractere, iar numele de fișier trebuie să fie mai puțin de 260 de caractere.

NotSupportedException

Fișierul la sourcePath’ conține o coloană (:) în mijlocul stringului.

 Română