Class ZArchive

Class ZArchive

ja nimityö: Aspose.Zip.Z Kokoelma: Aspose.Zip.dll (25.5.0)

Tämä luokka edustaa Z (kompressi) arkistotiedostoa. käytä sitä koostamaan tai poistaa Z arkistoja.

public class ZArchive : IArchive, IDisposable, IArchiveFileEntry

Inheritance

object ZArchive

Implements

IArchive , IDisposable , IArchiveFileEntry

Perintöjäsenet

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

Remarks

Näytä https://docs.fileformat.com/compression/z/

Constructors

Arkkitehti()

Aloitetaan Aspose.Zip.Z.ZArchive-luokan uusi esimerkki, joka on valmistettu kompressointiin.

public ZArchive()

Arkkitehti(Liikenne, ZArchiveLoadOptions)

Aloitetaan Aspose.Zip.Z.ZArchive-luokan uusi esimerkki, joka on valmis dekompresointiin.

public ZArchive(Stream source, ZArchiveLoadOptions loadOptions = null)

Parameters

source Stream

Arkiston lähde on.

loadOptions ZArchiveLoadOptions

Vaihtoehtoja arkiston lataamiseen.

Remarks

Tämä rakentaja ei dekompresoida. Katso Aspose.Zip.Z.ZArchive.Extract(System.IO.Stream) dekompresointimenetelmä.

Exceptions

ArgumentException

source’ is not seekable.

ArgumentNullException

source’ is null.

Arkkitehti(Tietokone, ZArchiveLoadOptions)

Aloitetaan Aspose.Zip.Z.ZArchive-luokan uusi esimerkki, joka on valmis dekompresointiin.

public ZArchive(string path, ZArchiveLoadOptions loadOptions = null)

Parameters

path string

Matka arkiston lähteeseen.

loadOptions ZArchiveLoadOptions

Vaihtoehtoja arkiston lataamiseen.

Remarks

Tämä rakentaja ei dekompresoida. Katso Aspose.Zip.Z.ZArchive.Extract(System.IO.Stream) dekompresointimenetelmä.

Exceptions

ArgumentNullException

path’ is null.

SecurityException

Kääntäjällä ei ole tarvittavaa käyttöoikeutta.

ArgumentException

path’ on tyhjä, sisältää vain valkoisia tiloja tai sisältää epätasaisia merkkejä.

UnauthorizedAccessException

Pääsy path" -tiedostoon kielletään.

PathTooLongException

Määritetty path", tiedoston nimi tai molemmat ylittävät järjestelmän määrittämän enimmäispituuden. Esimerkiksi Windows-pohjaisilla alustoilla tiet on oltava alle 248 merkkiä ja tiedoston nimet on oltava alle 260 merkkiä.

NotSupportedException

path’ -tiedosto sisältää sarjan keskellä olevan sarjan (:) sarjan.

FileNotFoundException

Tiedostoa ei löydy.

DirectoryNotFoundException

Määritetty reitti ei ole pätevä, esimerkiksi ollessa kartattoman ajoneuvon päällä.

IOException

Tiedosto on jo auki.

Methods

Dispose()

Se suorittaa sovellukseen määriteltyjä tehtäviä, jotka liittyvät vapauttamiseen, vapauttamiseen tai hallitsemattomien resurssien palauttamiseen.

public void Dispose()

Dispose(Booli)

Se suorittaa sovellukseen määriteltyjä tehtäviä, jotka liittyvät vapauttamiseen, vapauttamiseen tai hallitsemattomien resurssien palauttamiseen.

protected virtual void Dispose(bool disposing)

Parameters

disposing bool

Hallittuja resursseja on käytettävä.

Extract(Stream)

Poista Z arkistoa virtaukseen.

public void Extract(Stream destination)

Parameters

destination Stream

Virtaa dekompresoitujen tietojen tallentamiseen.

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

Tietoja ei voi purkaa.

Extract(FileInfo)

Poista Z-tiedosto tiedostoon.

public void Extract(FileInfo fileInfo)

Parameters

fileInfo FileInfo

FileInfo dekompresoitujen tietojen tallentamiseen.

Examples

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

Exceptions

SecurityException

Soittajalla ei ole vaadittua lupaa avata fileInfo'.

ArgumentException

Tiedoston reitti on tyhjä tai sisältää vain valkoisia tiloja.

FileNotFoundException

Tiedostoa ei löydy.

UnauthorizedAccessException

Matka tiedostoon on vain lukeminen tai on direktori.

ArgumentNullException

fileInfo’ is null.

DirectoryNotFoundException

Määritetty reitti ei ole pätevä, esimerkiksi ollessa kartattoman ajoneuvon päällä.

IOException

Tiedosto on jo auki.

InvalidDataException

Tietoja ei voi purkaa.

Extract(String)

Poista Z arkistoon tiedostoon reitin mukaan.

public FileInfo Extract(string path)

Parameters

path string

Tiedosto, joka tallentaa dekompresoituja tietoja.

Returns

FileInfo

Tietoa saadusta tiedostosta.

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

Kääntäjällä ei ole tarvittavaa käyttöoikeutta.

ArgumentException

path’ on tyhjä, sisältää vain valkoisia tiloja tai sisältää epätasaisia merkkejä.

UnauthorizedAccessException

Pääsy path" -tiedostoon kielletään.

PathTooLongException

Määritetty path", tiedoston nimi tai molemmat ylittävät järjestelmän määrittämän enimmäispituuden. Esimerkiksi Windows-pohjaisilla alustoilla tiet on oltava alle 248 merkkiä ja tiedoston nimet on oltava alle 260 merkkiä.

NotSupportedException

path’ -tiedosto sisältää sarjan keskellä olevan sarjan (:) sarjan.

InvalidDataException

Tietoja ei voi purkaa.

ExtractToDirectory(String)

Poista arkiston sisältö toimitetulle direktiiville.

public void ExtractToDirectory(string destinationDirectory)

Parameters

destinationDirectory string

Matka direktoriin sijoittaa poistettuja tiedostoja.

Remarks

Jos rekisteri ei ole olemassa, se luodaan.

Exceptions

ArgumentNullException

destinationDirectory’ is null.

PathTooLongException

Tietyt reitit, tiedoston nimi tai molemmat ylittävät järjestelmän määrittämän enimmäispituuden. Esimerkiksi Windows-pohjaisissa alustoissa reitit on oltava alle 248 merkkiä ja tiedoston nimet on oltava alle 260 merkkiä.

SecurityException

Kääntäjällä ei ole tarvittavaa lupaa käyttää olemassa olevaa direktoria.

NotSupportedException

Jos luetteloa ei ole olemassa, reitillä on rintakehän merkki (:) joka ei ole osa ohjaimen merkkiä (“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

Reitin mukainen luettelo on tiedosto. -or- Verkon nimi ei ole tiedossa.

Save(Liikenne, ZArchiveSaveOptions)

Säästää xz arkiston antamaan virtaukseen.

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

Parameters

output Stream

Tavoitteen virta.

settings ZArchiveSaveOptions

Vaihtoehtoiset asetukset arkiston koostumukseen.

Examples

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

Remarks

Sen täytyy olla etsimätön.

Exceptions

ArgumentException

output’ does not support seeking.

ArgumentNullException

output’ is null.

Save(Tietokone, ZArchiveSaveOptions)

Säästää Z-tiedoston kohdetiedostoon.

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

Parameters

destinationFileName string

Jos tiedoston nimi viittaa olemassa olevaan tiedostoon, se kirjoitetaan uudelleen.

settings ZArchiveSaveOptions

Vaihtoehtoiset asetukset arkiston koostumukseen.

Examples

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

Exceptions

ArgumentNullException

destinationFileName’ is null.

SecurityException

Kääntäjällä ei ole tarvittavaa käyttöoikeutta.

ArgumentException

destinationFileName’ on tyhjä, sisältää vain valkoisia tiloja tai sisältää epätasaisia merkkejä.

UnauthorizedAccessException

Pääsy destinationFileName’ -tiedostoon kielletään.

PathTooLongException

Määritetty destinationFileName’, tiedoston nimi, tai molemmat ylittävät järjestelmän määrittämän enimmäispituuden. Esimerkiksi Windows-pohjaisilla alustoilla reitin on oltava alle 248 merkkiä ja tiedoston nimet on oltava alle 260 merkkiä.

NotSupportedException

Tiedosto destinationFileName’ sisältää sarjan keskellä olevan sarjan (:) sarjan.

SetSource(Stream)

Aseta sisältö tiivistettäväksi arkiston sisällä.

public void SetSource(Stream source)

Parameters

source Stream

Sisällön virta arkistoon.

Examples

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

SetSource(FileInfo)

Aseta sisältö tiivistettäväksi arkiston sisällä.

public void SetSource(FileInfo fileInfo)

Parameters

fileInfo FileInfo

FileInfo, joka avautuu sisällön virtaan.

Examples

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

Exceptions

SecurityException

Soittajalla ei ole vaadittua lupaa avata fileInfo'.

ArgumentException

Tiedoston reitti on tyhjä tai sisältää vain valkoisia tiloja.

FileNotFoundException

Tiedostoa ei löydy.

UnauthorizedAccessException

Matka tiedostoon on vain lukeminen tai on direktori.

ArgumentNullException

fileInfo’ is null.

DirectoryNotFoundException

Määritetty reitti ei ole pätevä, esimerkiksi ollessa kartattoman ajoneuvon päällä.

IOException

Tiedosto on jo auki.

SetSource(String)

Aseta sisältö tiivistettäväksi arkiston sisällä.

public void SetSource(string sourcePath)

Parameters

sourcePath string

Matka tiedostoon, joka avautuu sisäänvirran muodossa.

Examples

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

Exceptions

ArgumentNullException

sourcePath’ is null or empty string.

SecurityException

Kääntäjällä ei ole tarvittavaa lupaa käyttää resursseja.

ArgumentException

sourcePath’ on tyhjä, sisältää vain valkoisia tiloja tai sisältää epätasaisia merkkejä.

UnauthorizedAccessException

Pääsy sourcePath’ -tiedostoon kielletään.

PathTooLongException

Määritetty sourcePath’, tiedoston nimi, tai molemmat ylittävät järjestelmän määrittämän enimmäispituuden. Esimerkiksi Windows-pohjaisissa alustoissa, reitit on oltava alle 248 merkkiä, ja tiedoston nimet on oltava alle 260 merkkiä.

NotSupportedException

sourcePath’ -tiedosto sisältää sarjan keskellä olevan sarjan (:) sarjan.

 Suomi