Class ZstandardArchive

path är null.

Anroparen har inte den nödvändiga behörigheten för att få tillgång.

path är tom, innehåller endast vita tecken eller innehåller ogiltiga tecken.

Åtkomst till fil path nekas.

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

Fil på path innehåller ett kolon (:) mitt i strängen.

Metoder

Dispose()

Utför applikationsdefinierade uppgifter som är kopplade till att frigöra, släppa eller återställa obehöriga resurser.

public void Dispose()

Dispose(bool)

Utför applikationsdefinierade uppgifter som är kopplade till att frigöra, släppa eller återställa obehöriga resurser.

protected virtual void Dispose(bool disposing)

Parametrar

disposing bool

Om hanterade resurser ska frigöras.

Extract(Stream)

Extraherar arkivet till den angivna strömmen.

public void Extract(Stream destination)

Parametrar

destination Stream

Målström. Måste vara skrivbar.

Exempel

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

Undantag

destination stöder inte skrivning.

Extract(string)

Extraherar arkivet till filen enligt sökvägen.

public FileInfo Extract(string path)

Parametrar

path string

Sökvägen till målfilen. Om filen redan finns, kommer den att skrivas över.

Returnerar

FileInfo

Info om den extraherade filen.

Undantag

path är null.

Anroparen har inte den nödvändiga behörigheten för att få tillgång.

path är tom, innehåller endast vita tecken, eller innehåller ogiltiga tecken.

Åtkomst till fil path nekas.

Fil på path innehåller ett kolon (:) mitt i strängen.

ExtractToDirectory(string)

Extraherar innehållet i arkivet till den angivna katalogen.

public void ExtractToDirectory(string destinationDirectory)

Parametrar

destinationDirectory string

Sökvägen till katalogen där de extraherade filerna ska placeras.

Anmärkningar

Om katalogen inte finns, kommer den att skapas.

Undantag

destinationDirectory är null.

Den angivna sökvägen, filnamn, eller båda överskrider den systemdefinierade maximala längden. Till exempel, på Windows-baserade plattformar, måste sökvägar vara kortare än 248 tecken och filnamn måste vara kortare än 260 tecken.

Anroparen har inte den nödvändiga behörigheten för att få tillgång till den befintliga katalogen.

Om katalogen inte finns, innehåller sökvägen ett kolontecken (:) som inte är en del av en enhetsbeteckning (“C:").

destinationDirectory är en sträng med noll längd, innehåller endast vita tecken, eller innehåller ett eller flera ogiltiga tecken. Du kan fråga efter ogiltiga tecken med hjälp av metoden System.IO.Path.GetInvalidPathChars. -eller- sökvägen är förknippad med, eller innehåller, endast ett kolon-tecken (:).

IOException

Den angivna sökvägen är en fil. -eller- Det nätverksnamnet är okänt.

Open()

Öppnar arkivet för extrahering och tillhandahåller en ström med arkivets innehåll.

public Stream Open()

Returnerar

Stream

Strömmen som representerar innehållet i arkivet.

Exempel

Extraherar arkivet och kopierar det extraherade innehållet 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 metoden Stream.CopyTo för .NET 4.0 och högre: `unpacked.CopyTo(extracted);`

Anmärkningar

Läs från strömmen för att få det ursprungliga innehållet i filen. Se exempelavsnittet.

Save(Stream, ZstandardSaveOptions)

Sparar arkivet till den angivna strömmen.

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

Parametrar

outputStream Stream

Målström.

settings ZstandardSaveOptions

Valfria inställningar för arkivkomposition.

Exempel

Skriver komprimerad data till http-svarström.

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

Anmärkningar

outputStream måste vara skrivbar.

Undantag

InvalidOperationException

outputStream är inte skrivbar.

Källan har inte angetts.

Save(string, ZstandardSaveOptions)

Sparar arkivet till den angivna destinationsfilen.

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

Parametrar

destinationFileName string

Sökvägen till det arkiv som ska skapas. Om det angivna filnamnet pekar på en befintlig fil, kommer den att skrivas över.

settings ZstandardSaveOptions

Valfria inställningar för arkivkomposition.

Exempel

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

Undantag

destinationFileName är null.

Anroparen har inte den nödvändiga behörigheten för att få tillgång.

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

Åtkomst till fil destinationFileName nekas.

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

Fil på destinationFileName innehåller ett kolon (:) mitt i strängen.

Save(FileInfo, ZstandardSaveOptions)

Sparar arkivet till den angivna destinationsfilen.

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

Parametrar

destination FileInfo

FileInfo som kommer att öppnas som målström.

settings ZstandardSaveOptions

Valfria inställningar för arkivkomposition.

Exempel

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

Undantag

Anroparen har inte den nödvändiga behörigheten för att öppna destination.

Filens sökväg är tom eller innehåller endast vita tecken.

FileNotFoundException

Filens finns inte.

Sökvägen till filen är skrivskyddad eller är en katalog.

DirectoryNotFoundException

destination är null.

Den angivna sökvägen är ogiltig, till exempel att den ligger på en icke-mappad enhet.

IOException

Filens är redan öppen.

SetSource(Stream)

Sätter innehållet som ska komprimeras inom arkivet.

public void SetSource(Stream source)

Parametrar

source Stream

Indataström för arkivet.

Exempel

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

SetSource(FileInfo)

Sätter innehållet som ska komprimeras inom arkivet.

public void SetSource(FileInfo fileInfo)

Parametrar

fileInfo FileInfo

Referens till en fil som ska komprimeras.

Exempel

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

SetSource(string)

Sätter innehållet som ska komprimeras inom arkivet.

public void SetSource(string path)

Parametrar

path string

Sökväg till filen som ska komprimeras.

Exempel

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

Undantag

path är null.

Anroparen har inte den nödvändiga behörigheten för att få tillgång.

path är tom, innehåller endast vita tecken, eller innehåller ogiltiga tecken.

Åtkomst till fil path nekas.