Class GzipArchive

path je null.

Volající nemá potřebné oprávnění k přístupu.

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čují maximální délku definovanou systémem. Například na platformách založených na 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.

Vlastnosti

Name

Název původního souboru.

public string Name { get; }

Hodnota vlastnosti

string

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.gz"))
{
     archive.Extract(httpResponseStream);
}

Výjimky

destination nepodporuje zápis.

InvalidDataException

Stream je poškozen a neobsahuje platná data.

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ávrat

FileInfo

Info o extrahovaném souboru.

Výjimky

path je null.

Volající nemá potřebné oprávnění k přístupu.

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.

InvalidDataException

Stream je poškozen a neobsahuje platná data.

ExtractToDirectory(string)

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

public void ExtractToDirectory(string destinationDirectory)

Parametry

destinationDirectory string

Cesta k adresáři, do kterého 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čují maximální délku definovanou systémem. Například na platformách založených na 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í k přístupu k existujícímu adresáři.

Pokud adresář neexistuje, cesta obsahuje znak dvojtečky (:) který není součástí popisku jednotky (“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ředpona 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ávrat

Stream

Stream, který představuje obsah archivu.

Příklady

Extrahuje archiv a zkopíruje extrahovaný obsah do souborového streamu.

using (var archive = new GzipArchive("archive.gz"))
{
    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)

Uloží archiv do poskytnutého streamu.

public void Save(Stream outputStream)

Parametry

outputStream Stream

Cílový stream.

Příklady

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

using (var archive = new GzipArchive()) 
{
    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 dodán.

Save(string)

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

public void Save(string destinationFileName)

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.

Příklady

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

Výjimky

destinationFileName je null.

Volající nemá potřebné oprávnění k přístupu.

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čují maximální délku definovanou systémem. Například na platformách založených na 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.

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

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 GzipArchive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save("archive.gz");
}

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

Otevřete archiv ze souboru podle cesty a extrahujte ho do MemoryStream

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

Výjimky

path je null.

Volající nemá potřebné oprávnění k přístupu.

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

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