Class ZstandardArchive

path je null.

Volající nemá potřebná oprávnění pro přístup.

path je prázdný, obsahuje pouze bílé znaky, nebo obsahuje neplatné znaky.

Přístup k souboru path je odepřen.

Zadaná path, název souboru, nebo obojí překračuje maximální délku definovanou systémem. Například na platformách Windows musí být cesty kratší než 248 znaků a názvy souborů kratší než 260 znaků.

Soubor na path obsahuje dvojtečku (:) uprostřed řetězce.

Metody

Dispose()

Provádí úkoly definované aplikací spojené s uvolněním, uvolněním nebo resetováním neřízených prostředků.

public void Dispose()

Dispose(bool)

Provádí úkoly definované aplikací spojené s uvolněním, uvolněním nebo resetováním neřízených prostředků.

protected virtual void Dispose(bool disposing)

Parametry

disposing bool

Zda by měly být uvolněny řízené prostředky.

Extract(Stream)

Extrahuje archiv do poskytnutého streamu.

public void Extract(Stream destination)

Parametry

destination Stream

Cílový stream. Musí být zapisovatelný.

Příklady

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

Výjimky

destination nepodporuje zápis.

Extract(string)

Extrahuje archiv do souboru podle cesty.

public FileInfo Extract(string path)

Parametry

path string

Cesta k cílovému souboru. Pokud soubor již existuje, bude přepsán.

Návratové hodnoty

FileInfo

Informace o extrahovaném souboru.

Výjimky

path je null.

Volající nemá potřebná oprávnění pro přístup.

path je prázdný, obsahuje pouze bílé znaky, nebo obsahuje neplatné znaky.

Přístup k souboru path je odepřen.

Soubor na path obsahuje dvojtečku (:) uprostřed řetězce.

ExtractToDirectory(string)

Extrahuje obsah archivu do poskytnutého adresáře.

public void ExtractToDirectory(string destinationDirectory)

Parametry

destinationDirectory string

Cesta k adresáři, kam budou umístěny extrahované soubory.

Poznámky

Pokud adresář neexistuje, bude vytvořen.

Výjimky

destinationDirectory je null.

Zadaná cesta, název souboru, nebo obojí překračuje maximální délku definovanou systémem. Například na platformách Windows musí být cesty kratší než 248 znaků a názvy souborů kratší než 260 znaků.

Volající nemá potřebná oprávnění pro přístup k existujícímu adresáři.

Pokud adresář neexistuje, cesta obsahuje znak dvojtečky (:) který není součástí označení disku (“C:").

destinationDirectory je řetězec nulové délky, obsahuje pouze bílé znaky, nebo obsahuje jeden nebo více neplatných znaků. Neplatné znaky můžete zjistit pomocí metody System.IO.Path.GetInvalidPathChars. -nebo- cesta je předcházena nebo obsahuje pouze znak dvojtečky (:).

IOException

Adresář určený cestou je soubor. -nebo- Síťový název není znám.

Open()

Otevře archiv pro extrakci a poskytne stream s obsahem archivu.

public Stream Open()

Návratové hodnoty

Stream

Stream, který představuje obsah archivu.

Příklady

Extrahuje archiv a zkopíruje extrahovaný obsah do streamu souboru.

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

Můžete použít metodu Stream.CopyTo pro .NET 4.0 a vyšší: `unpacked.CopyTo(extracted);`

Poznámky

Čtěte ze streamu, abyste získali původní obsah souboru. Viz sekce příkladů.

Save(Stream, ZstandardSaveOptions)

Uloží archiv do poskytnutého streamu.

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

Parametry

outputStream Stream

Cílový stream.

settings ZstandardSaveOptions

Volitelné nastavení pro sestavení archivu.

Příklady

Píše komprimovaná data do streamu http odpovědi.

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

Poznámky

outputStream musí být zapisovatelný.

Výjimky

InvalidOperationException

outputStream není zapisovatelný.

Zdroj nebyl poskytnut.

Save(string, ZstandardSaveOptions)

Uloží archiv do poskytnutého cílového souboru.

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

Parametry

destinationFileName string

Cesta archivu, který má být vytvořen. Pokud zadaný název souboru odkazuje na existující soubor, bude přepsán.

settings ZstandardSaveOptions

Volitelné nastavení pro sestavení archivu.

Příklady

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

Výjimky

destinationFileName je null.

Volající nemá potřebná oprávnění pro přístup.

destinationFileName je prázdný, obsahuje pouze bílé znaky, nebo obsahuje neplatné znaky.

Přístup k souboru destinationFileName je odepřen.

Zadaná destinationFileName, název souboru, nebo obojí překračuje maximální délku definovanou systémem. Například na platformách Windows musí být cesty kratší než 248 znaků a názvy souborů kratší než 260 znaků.

Soubor na destinationFileName obsahuje dvojtečku (:) uprostřed řetězce.

Save(FileInfo, ZstandardSaveOptions)

Uloží archiv do poskytnutého cílového souboru.

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

Parametry

destination FileInfo

FileInfo, který bude otevřen jako cílový stream.

settings ZstandardSaveOptions

Volitelné nastavení pro sestavení archivu.

Příklady

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

Výjimky

Volající nemá potřebná oprávnění pro otevření destination.

Cesta k souboru je prázdná nebo obsahuje pouze bílé znaky.

FileNotFoundException

Soubor nebyl nalezen.

Cesta k souboru je pouze pro čtení nebo je adresářem.

DirectoryNotFoundException

destination je null.

Zadaná cesta je neplatná, například je na nepřipojeném disku.

IOException

Soubor je již otevřen.

SetSource(Stream)

Nastaví obsah, který má být komprimován v archivu.

public void SetSource(Stream source)

Parametry

source Stream

Vstupní stream pro archiv.

Příklady

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

SetSource(FileInfo)

Nastaví obsah, který má být komprimován v archivu.

public void SetSource(FileInfo fileInfo)

Parametry

fileInfo FileInfo

Odkaz na soubor, který má být komprimován.

Příklady

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

SetSource(string)

Nastaví obsah, který má být komprimován v archivu.

public void SetSource(string path)

Parametry

path string

Cesta k souboru, který má být komprimován.

Příklady

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

Výjimky

path je null.

Volající nemá potřebná oprávnění pro přístup.

path je prázdný, obsahuje pouze bílé znaky, nebo obsahuje neplatné znaky.

Přístup k souboru path je odepřen.