Class ZstandardArchive

Sökanden har inte behörig tillstånd att komma åt.

path’ är tom, innehåller endast vita utrymmen, eller innehåller olagliga tecken.

Tillgång till filen path" vägras.

Den angivna path’, filnamn, eller båda överstiger den systemdefinierade maximala längden. Till exempel på Windows-baserade plattformar måste vägar vara mindre än 248 tecken, och filnamn måste vara mindre än 260 tecken.

Filen på path’ innehåller en kolumn (:) i mitten av raden.

`Methods`

`Dispose()`

Utför tillämpningsdefinierade uppgifter som är förknippade med frigöring, frigöring eller återanvändning av okontrollerade resurser.

public void Dispose()

`Dispose(Bool)`

Utför tillämpningsdefinierade uppgifter som är förknippade med frigöring, frigöring eller återanvändning av okontrollerade resurser.

protected virtual void Dispose(bool disposing)

`Parameters`

disposing bool

Oavsett om de förvaltade resurserna ska utplånas.

`Extract(Stream)`

Extraherar arkivet till den tillhandahållna strömmen.

public void Extract(Stream destination)

`Parameters`

destination Stream

Destination stream. måste vara skribar.

`Examples`

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

`Exceptions`

destination’ does not support writing.

`Extract(Sträng)`

Extraherar arkivet till filen per väg.

public FileInfo Extract(string path)

`Parameters`

path string

Vägen till målfilen. om filen redan existerar, kommer den att översättas.

`Returns`

FileInfo

Information om en extraherad fil.

`Exceptions`

path’ is null.

Sökanden har inte behörig tillstånd att komma åt.

path’ är tom, innehåller endast vita utrymmen, eller innehåller olagliga tecken.

Tillgång till filen path" vägras.

Filen på path’ innehåller en kolumn (:) i mitten av raden.

`ExtractToDirectory(Sträng)`

Extraherar innehållet i arkivet till den angivna katalogen.

public void ExtractToDirectory(string destinationDirectory)

`Parameters`

destinationDirectory string

Vägen till katalogen för att placera de extraherade filerna i.

`Remarks`

Om katalogen inte existerar kommer den att skapas.

`Exceptions`

destinationDirectory’ is null.

Den angivna vägen, filnamnet eller båda överstiger den systemdefinierade maximala längden. Till exempel på Windows-baserade plattformar måste vägarna vara mindre än 248 tecken och filnamnen måste vara mindre än 260 tecken.

Sökanden har inte behörig behörighet att få tillgång till det befintliga katalogen.

Om katalogen inte existerar, innehåller vägen en kolumnkaraktär (:) som inte är en del av en drivetikett (“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 som anges av vägen är en fil. -eller- Nätverksnamnet är inte känt.

`Open()`

Öppnar arkivet för extraction och ger en ström med arkivinnehåll.

public Stream Open()

`Returns`

Stream

Strömmen som representerar innehållet i arkivet.

`Examples`

Extraherar arkivet och kopierar extraherat innehåll till 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 använda Stream.CopyTo-metoden för .NET 4.0 och högre: unpacked.KopiTo(utdraget);

`Remarks`

Läs från strömmen för att få det ursprungliga innehållet i en fil. Se exempel avsnitt.

`Save(Ström, ZstandardSaveOptions)`

Spara arkiv till den tillhandahållna strömmen.

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

`Parameters`

outputStream Stream

Destination strömmar.

settings ZstandardSaveOptions

Optionella inställningar för arkivkomposition.

`Examples`

Skriv komprimerade data till HTTP responsström.

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

`Remarks`

Måste vara skribar.

`Exceptions`

InvalidOperationException

outputStream’ is not writable.

Källan har inte levererats.

`Save(String, ZstandardSaveOptions)`

Spara arkiv till den angivna destinationsfilen.

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

`Parameters`

destinationFileName string

Om den angivna filnamnet pekar på en befintlig fil, kommer den att översättas.

settings ZstandardSaveOptions

Optionella inställningar för arkivkomposition.

`Examples`

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

`Exceptions`

destinationFileName’ is null.

Sökanden har inte behörig tillstånd att komma åt.

destinationFileName’ är tom, innehåller endast vita utrymmen, eller innehåller ogiltiga tecken.

Tillgång till filen destinationFileName’ vägras.

Den angivna destinationFileName’, filnamn, eller båda överstiger den systemdefinierade maximala längden. Till exempel på Windows-baserade plattformar måste vägar vara mindre än 248 tecken och filnamn måste vara mindre än 260 tecken.

Filen i destinationFileName’ innehåller en kolumn (:) i mitten av raden.

`Save(FileInfo och ZstandardSaveOptions)`

Spara arkiv till den angivna destinationsfilen.

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

`Parameters`

destination FileInfo

FileInfo, som öppnas som destinationström.

settings ZstandardSaveOptions

Optionella inställningar för arkivkomposition.

`Examples`

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

`Exceptions`

Ringaren har inte nödvändig tillåtelse att öppna destination".

Filvägen är tom eller innehåller endast vita utrymmen.

FileNotFoundException

Filen hittades inte.

Vägen till filen är läsbart eller är en katalog.

DirectoryNotFoundException

destination’ is null.

Den angivna vägen är ogiltig, t.ex. att vara på en okartad disk.

IOException

Filen är redan öppen.

`SetSource(Stream)`

Ställ in innehållet för att komprimeras inom arkivet.

public void SetSource(Stream source)

`Parameters`

source Stream

Inträdesflöde för arkivet.

`Examples`

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

`SetSource(FileInfo)`

Ställ in innehållet för att komprimeras inom arkivet.

public void SetSource(FileInfo fileInfo)

`Parameters`

fileInfo FileInfo

Referensen till en fil som ska komprimeras.

`Examples`

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

`SetSource(Sträng)`

Ställ in innehållet för att komprimeras inom arkivet.

public void SetSource(string path)

`Parameters`

path string

Vägen att filera för att komprimeras.

`Examples`

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

`Exceptions`

path’ is null.

Sökanden har inte behörig tillstånd att komma åt.

path’ är tom, innehåller endast vita utrymmen, eller innehåller olagliga tecken.

Tillgång till filen path" vägras.