Class ZstandardArchive

Den pågældende har ikke den nødvendige tilladelse til at få adgang.

code class=“paramref”>path’ er tom, indeholder kun hvide rum, eller indeholder ulovlige tegn.

Tilgang til filen path’ er nægtet.

Den angivne path’, filnavn, eller begge overstiger den systemdefinerede maksimale længde. For eksempel på Windows-baserede platforme skal veje være mindre end 248 tegn, og filnavn skal være mindre end 260 tegn.

Filen på path’ indeholder en kolonne (:) i midten af ringen.

`Methods`

`Dispose()`

Udfører applikationsdefinerede opgaver, der er forbundet med frigivelse, frigivelse eller genoprettelse af uadministrerede ressourcer.

public void Dispose()

`Dispose(Bool)`

Udfører applikationsdefinerede opgaver, der er forbundet med frigivelse, frigivelse eller genoprettelse af uadministrerede ressourcer.

protected virtual void Dispose(bool disposing)

`Parameters`

disposing bool

Om de forvaltede ressourcer skal fjernes.

`Extract(Stream)`

Udveksler arkivet til den leverede strøm.

public void Extract(Stream destination)

`Parameters`

destination Stream

Destination stream. skal være skriftlig.

`Examples`

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

`Exceptions`

destination’ does not support writing.

`Extract(String)`

Udveksler arkivet til filen ved vej.

public FileInfo Extract(string path)

`Parameters`

path string

Hvis filen allerede eksisterer, vil den blive overskrevet.

`Returns`

FileInfo

Information om en udvundet fil.

`Exceptions`

path’ is null.

Den pågældende har ikke den nødvendige tilladelse til at få adgang.

code class=“paramref”>path’ er tom, indeholder kun hvide rum, eller indeholder ulovlige tegn.

Tilgang til filen path’ er nægtet.

Filen på path’ indeholder en kolonne (:) i midten af ringen.

`ExtractToDirectory(String)`

Udveksler indholdet af arkivet til den leverede katalog.

public void ExtractToDirectory(string destinationDirectory)

`Parameters`

destinationDirectory string

Vejen til katalogen til at placere de udvundne filer i.

`Remarks`

Hvis katalogen ikke eksisterer, vil den blive oprettet.

`Exceptions`

destinationDirectory’ is null.

Den angivne rute, filnavn eller begge overstiger den systemdefinerede maksimale længde. For eksempel på Windows-baserede platforme skal ruter være mindre end 248 tegn og filnavn skal være mindre end 260 tegn.

Opkalderen har ikke den nødvendige tilladelse til at få adgang til den eksisterende katalog.

Hvis direktoriet ikke eksisterer, indeholder vejen en kolon karakter (:) som ikke er en del af et diskmærke (“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

Den katalog, der er angivet af vejen, er en fil. -eller- Netværksnavnet er ikke kendt.

`Open()`

bner arkivet til ekstraktion og giver en strøm med arkivindhold.

public Stream Open()

`Returns`

Stream

Den strøm, der repræsenterer indholdet af arkivet.

`Examples`

Udvider arkivet og kopierer udvundet indhold til filstrøm.

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);
    }            
}

Du kan bruge Stream.CopyTo-metoden til .NET 4.0 og højere: unpacked.Kopier(udvundet);

`Remarks`

Læs fra strømmen for at få det oprindelige indhold af en fil. Se eksempler sektion.

`Save(Strøm, ZstandardSaveOptions)`

Sparer arkiver til den leverede strøm.

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

`Parameters`

outputStream Stream

Destinationstrøm.

settings ZstandardSaveOptions

Optionelle indstillinger for arkivkomposition.

`Examples`

Skriv komprimerede data til http responsstrøm.

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

`Remarks`

Det skal være skriftligt.

`Exceptions`

InvalidOperationException

outputStream’ is not writable.

Kilde er ikke leveret.

`Save(String, ZstandardSaveOptions)`

Sparer arkiver til den foreløbige fil, der leveres.

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

`Parameters`

destinationFileName string

Hvis den angivne filnavne angiver en eksisterende fil, vil den blive oversat.

settings ZstandardSaveOptions

Optionelle indstillinger for arkivkomposition.

`Examples`

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

`Exceptions`

destinationFileName’ is null.

Den pågældende har ikke den nødvendige tilladelse til at få adgang.

Den destinationFileName’ er tom, indeholder kun hvide rum, eller indeholder ugyldige tegn.

Tilgang til filen destinationFileName’ er nægtet.

Den angivne destinationFileName’, filnavn, eller begge overskrider systemdefinerede maksimale længde. For eksempel på Windows-baserede platforme skal veje være mindre end 248 tegn, og filnavn skal være mindre end 260 tegn.

Fil på destinationFileName’ indeholder en kolonne (:) i midten af ringen.

`Save(FileInfo og ZstandardSaveOptions)`

Sparer arkiver til den foreløbige fil, der leveres.

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

`Parameters`

destination FileInfo

FileInfo, som vil blive åbnet som destinationstrøm.

settings ZstandardSaveOptions

Optionelle indstillinger for arkivkomposition.

`Examples`

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

`Exceptions`

Ringeren har ikke den nødvendige tilladelse til at åbne destination'.

Filvejen er tom eller indeholder kun hvide rum.

FileNotFoundException

Filen er ikke fundet.

Vejen til filen er læst alene eller er en katalog.

DirectoryNotFoundException

destination’ is null.

Den angivne rute er ugyldig, f.eks. på en ubemappet drive.

IOException

Filen er allerede åben.

`SetSource(Stream)`

Indsæt indholdet til at blive komprimeret inden for arkivet.

public void SetSource(Stream source)

`Parameters`

source Stream

Indtægtsstrøm for arkivet.

`Examples`

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

`SetSource(FileInfo)`

Indsæt indholdet til at blive komprimeret inden for arkivet.

public void SetSource(FileInfo fileInfo)

`Parameters`

fileInfo FileInfo

Den reference til en fil, der skal komprimeres.

`Examples`

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

`SetSource(String)`

Indsæt indholdet til at blive komprimeret inden for arkivet.

public void SetSource(string path)

`Parameters`

path string

Vejen til fil at blive komprimeret.

`Examples`

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

`Exceptions`

path’ is null.

Den pågældende har ikke den nødvendige tilladelse til at få adgang.

code class=“paramref”>path’ er tom, indeholder kun hvide rum, eller indeholder ulovlige tegn.

Tilgang til filen path’ er nægtet.