Class ZstandardArchive

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

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

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

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ä.

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

`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 arkisto antamaan virtaukseen.

public void Extract(Stream destination)

`Parameters`

destination Stream

Tarkoitus: Tarkoitus on kirjoitettava.

`Examples`

using (var archive = new GzipArchive("archive.zst"))
{
     archive.Extract(httpResponseStream);
}

`Exceptions`

destination’ does not support writing.

`Extract(String)`

Poista arkisto tiedostoon reitin mukaan.

public FileInfo Extract(string path)

`Parameters`

path string

Jos tiedosto on jo olemassa, se kirjoitetaan yli.

`Returns`

FileInfo

Tietoa saadusta tiedostosta.

`Exceptions`

path’ is null.

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

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

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

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

`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`

destinationDirectory’ is null.

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ä.

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

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

IOException

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

`Open()`

Avaa arkisto kaivaa varten ja antaa virran arkiston sisällön kanssa.

public Stream Open()

`Returns`

Stream

Virta, joka edustaa arkiston sisältöä.

`Examples`

Poistaa arkiston ja kopioi poistetun sisällön tiedostojen virtaukseen.

using (var archive = new ZstandardArchive("archive.zst"))
{
    using (var extracted = File.Create("data.bin"))
    {
        var unpacked = archive.Open();
        byte[] b = new byte[8192];
        int bytesRead;
        while (0 &lt; (bytesRead = unpacked.Read(b, 0, b.Length)))
            extracted.Write(b, 0, bytesRead);
    }            
}

Voitte käyttää Stream.CopyTo -menetelmää .NET 4.0 ja uudemmalle: unpacked.KopiTo(extracted);

`Remarks`

Lue virta saadaksesi tiedoston alkuperäisen sisällön. Katso esimerkkejä osasta.

`Save(Stream ja ZstandardSaveOptions)`

Säästää arkistoa tarjottuun virtaukseen.

public void Save(Stream outputStream, ZstandardSaveOptions settings = null)

`Parameters`

outputStream Stream

Tavoitteen virta.

settings ZstandardSaveOptions

Vaihtoehtoiset asetukset arkiston koostumukseen.

`Examples`

Kirjoita tiivistetyt tiedot HTTP:n vastausvirtaan.

using (var archive = new ZstandardArchive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save(httpResponse.OutputStream);
}

`Remarks`

Pitää olla kirjoitettavaa.

`Exceptions`

InvalidOperationException

outputStream’ is not writable.

Lähde ei ole toimitettu.

`Save(Tyypillinen, ZstandardSaveOptions)`

Tallenna arkistoa osoitustiedostoon.

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

`Parameters`

destinationFileName string

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

settings ZstandardSaveOptions

Vaihtoehtoiset asetukset arkiston koostumukseen.

`Examples`

using (var archive = new ZstandardArchive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save("result.zst");
}

`Exceptions`

destinationFileName’ is null.

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

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

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

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ä.

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

`Save(FileInfo ja ZstandardSaveOptions)`

Tallenna arkistoa osoitustiedostoon.

public void Save(FileInfo destination, ZstandardSaveOptions settings = null)

`Parameters`

destination FileInfo

FileInfo, joka avautuu kohdevirtaan.

settings ZstandardSaveOptions

Vaihtoehtoiset asetukset arkiston koostumukseen.

`Examples`

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

`Exceptions`

Soittajalla ei ole vaadittua lupaa avata destination".

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

FileNotFoundException

Tiedostoa ei löydy.

Matka tiedostoon on vain lukeminen tai on direktori.

DirectoryNotFoundException

destination’ is null.

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

IOException

Tiedosto on jo auki.

`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 ZstandardArchive())
{
    archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
    archive.Save("archive.zst");
}

`SetSource(FileInfo)`

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

public void SetSource(FileInfo fileInfo)

`Parameters`

fileInfo FileInfo

Viittaus tiedostoon, joka on kompresoitu.

`Examples`

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

`SetSource(String)`

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

public void SetSource(string path)

`Parameters`

path string

Matka tiedostoon kompresoida.

`Examples`

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

`Exceptions`

path’ is null.

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

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

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