Class ZArchive

source není možné procházet.

source je null.

ZArchive(string, ZArchiveLoadOptions)

Inicializuje novou instanci třídy Aspose.Zip.Z.ZArchive připravenou pro dekompresi.

public ZArchive(string path, ZArchiveLoadOptions loadOptions = null)

Parametry

path string

Cesta k zdroji archivu.

loadOptions ZArchiveLoadOptions

Možnosti pro načtení archivu.

Poznámky

Tento konstruktor neprovádí dekompresi. Viz metoda Aspose.Zip.Z.ZArchive.Extract(System.IO.Stream) pro dekompresi.

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.

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ů.

DirectoryNotFoundException

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

FileNotFoundException

Soubor nebyl nalezen.

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

Soubor je již otevřen.

Metody

Dispose()

Provede ú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)

Provede ú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 Z archív do streamu.

public void Extract(Stream destination)

Parametry

destination Stream

Stream pro ukládání dekomprimovaných dat.

Příklady

using (FileStream zFile = File.Open(sourceFileName, FileMode.Open))
{
    using (FileStream extractedFile = File.Open(extractedFileName, FileMode.Create))
    {
        using (var archive = new ZArchive(zFile))
        {
            archive.Extract(extractedFile);
        }
    }
}

Výjimky

InvalidDataException

Data nelze dekomprimovat.

Extract(FileInfo)

Extrahuje Z archív do souboru.

public void Extract(FileInfo fileInfo)

Parametry

fileInfo FileInfo

FileInfo pro ukládání dekomprimovaných dat.

Příklady

using (FileStream zFile = File.Open(sourceFileName, FileMode.Open))
{
    using (var archive = new ZArchive(zFile))
    {
        archive.Extract(new FileInfo("extracted.bin"));
    }
}

Výjimky

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

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ář.

DirectoryNotFoundException

fileInfo je null.

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

Soubor je již otevřen.

InvalidDataException

Data nelze dekomprimovat.

Extract(string)

Extrahuje Z archív do souboru podle cesty.

public FileInfo Extract(string path)

Parametry

path string

Cesta k souboru, který bude ukládat dekomprimovaná data.

Vrací

FileInfo

Info o extrahovaném souboru.

Příklady

using (FileStream zFile = File.Open(sourceFileName, FileMode.Open))
{
    using (var archive = new ZArchive(zFile))
    {
        archive.Extract("extracted.bin");
    }
}

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.

InvalidDataException

Data nelze dekomprimovat.

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č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 s nulovou délkou, 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ředponována nebo obsahuje pouze znak dvojtečky (:).

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

Save(Stream, ZArchiveSaveOptions)

Ukládá xz archív do poskytnutého streamu.

public void Save(Stream output, ZArchiveSaveOptions settings = null)

Parametry

output Stream

Cílový stream.

settings ZArchiveSaveOptions

Volitelné nastavení pro sestavení archivu.

Příklady

using (FileStream zFile = File.Open("data.bin.z", FileMode.Create))
{
    using (var archive = new ZArchive())
    {
        archive.SetSource("data.bin");
        archive.Save(zFile);
     }
}

Poznámky

output musí být možné procházet.

Výjimky

output nepodporuje procházení.

output je null.

Save(string, ZArchiveSaveOptions)

Ukládá Z archív do poskytnutého cílového souboru.

public void Save(string destinationFileName, ZArchiveSaveOptions 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 ZArchiveSaveOptions

Volitelné nastavení pro sestavení archivu.

Příklady

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

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.

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

SetSource(FileInfo)

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

public void SetSource(FileInfo fileInfo)

Parametry

fileInfo FileInfo

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

Příklady

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

Výjimky

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

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ář.

DirectoryNotFoundException

fileInfo je null.

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

Soubor je již otevřen.

SetSource(string)

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

public void SetSource(string sourcePath)

Parametry

sourcePath string

Cesta k souboru, který bude otevřen jako vstupní stream.

Příklady

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

Výjimky

sourcePath je null nebo prázdný řetězec.

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

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

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

Zadaná sourcePath, 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ů.