Class IsoArchive

sourceStream je null.

sourceStream není vyhledatelný.

InvalidDataException

sourceStream není platný ISO archiv.

IsoArchive(string, IsoLoadOptions)

Inicializuje novou instanci třídy Aspose.Zip.Iso.IsoArchive a sestavuje seznam položek, které lze extrahovat z archivu.

public IsoArchive(string path, IsoLoadOptions loadOptions = null)

Parametry

path string

Cesta k souboru archivu.

loadOptions IsoLoadOptions

Možnosti pro načtení archivu.

Příklady

Následující příklad ukazuje, jak extrahovat všechny položky do adresáře.

using (var archive = new IsoArchive("archive.iso")) 
{ 
   archive.ExtractToDirectory("C:\\extracted");
}

Poznámky

Tento konstruktor nerozbalí žádnou položku.

Výjimky

path je null.

SecurityException

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

UnauthorizedAccessException

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

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

PathTooLongException

Zadaná path, název souboru nebo obojí přesahuje 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ů.

NotSupportedException

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

FileNotFoundException

Soubor nebyl nalezen.

DirectoryNotFoundException

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

IOException

Soubor je již otevřen.

EndOfStreamException

Soubor je příliš krátký.

Vlastnosti

Entries

Získá položky typu Aspose.Zip.Iso.IsoEntry, které tvoří archiv.

public ReadOnlyCollection<isoentry> Entries { get; }

Hodnota vlastnosti

ReadOnlyCollection<IsoEntry>

Metody

CreateDirectory(string)

Přidává adresář do ISO obrazu.

public IsoEntry CreateDirectory(string name)

Parametry

name string

Cesta k adresáři v ISO.

Vrací

Složený ISO záznam.

Výjimky

Archiv je otevřen pro extrakci.

name je null nebo prázdný.

CreateEntry(string, string)

Přidává soubor do ISO obrazu.

public IsoEntry CreateEntry(string name, string filePath)

Parametry

name string

Cesta k souboru v ISO.

filePath string

Cesta k souboru.

Vrací

Složený ISO záznam.

Výjimky

filePath je null.

UnauthorizedAccessException

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

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

PathTooLongException

Zadaná filePath přesahuje 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ů.

NotSupportedException

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

IOException

Došlo k chybě I/O při otevírání souboru.

CreateEntry(string, Stream)

Přidává soubor do ISO obrazu.

public IsoEntry CreateEntry(string name, Stream source)

Parametry

name string

Cesta k souboru v ISO.

source Stream

Stream obsahující data souboru.

Vrací

Složený ISO záznam.

CreateEntry(string)

Přidává soubor do ISO obrazu.

public IsoEntry CreateEntry(string name)

Parametry

name string

Cesta k adresáři v ISO.

Vrací

Složený ISO záznam.

Výjimky

name je null nebo prázdný.

Archiv je otevřen pro extrakci.

Dispose()

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

public void Dispose()

ExtractToDirectory(string)

Extrahuje všechny položky do zadaného adresáře.

public void ExtractToDirectory(string destinationDirectory)

Parametry

destinationDirectory string

Adresář, do kterého se položky extrahují.

Příklady

Následující příklad ukazuje, jak extrahovat všechny položky do adresáře:

using (var archive = new IsoArchive(File.OpenRead("archive.iso")))
{ 
   archive.ExtractToDirectory("C:\\extracted");
}

Výjimky

Vyvoláno, když je archiv v režimu úprav.

Vyvoláno, když je destinationDirectory null.

Save(string, IsoSaveOptions)

Uloží ISO obraz na zadanou cestu.

public void Save(string path, IsoSaveOptions saveOptions = null)

Parametry

path string

Cesta, na kterou bude ISO obraz uložen.

saveOptions IsoSaveOptions

Možnosti pro uložení ISO archivu.

Příklady

Následující příklad ukazuje, jak uložit ISO archiv do souboru:

// Vytvoření nového prázdného ISO archivu
using(IsoArchive isoArchive = new IsoArchive())
{
    // Přidání souborů do ISO archivu
    isoArchive.CreateEntry("example_file.txt", "path_to_file.txt");

    // Uložení ISO archivu do souboru
    isoArchive.Save("new_archive.iso");
}

Výjimky

Vyvoláno, když není archiv v režimu úprav.

DirectoryNotFoundException

Vyvoláno, když je path null.

Vyvoláno, když je zadaná cesta neplatná, například na nepřipojeném disku.

IOException

Vyvoláno, když je soubor již otevřen.

UnauthorizedAccessException

Vyvoláno, když je přístup k souboru path odepřen.

PathTooLongException

Vyvoláno, když zadaná path přesahuje maximální délku definovanou systémem.

Save(Stream, IsoSaveOptions)

Uloží ISO obraz do zadaného streamu.

public void Save(Stream stream, IsoSaveOptions saveOptions = null)

Parametry

stream Stream

Stream, do kterého bude ISO obraz uložen.

saveOptions IsoSaveOptions

Možnosti pro uložení ISO archivu.

Příklady

Následující příklad ukazuje, jak uložit ISO archiv do paměťového streamu:

// Vytvoření nového prázdného ISO archivu
using(IsoArchive isoArchive = new IsoArchive())
{
    // Přidání souborů do ISO archivu
    isoArchive.CreateEntry("example_file.txt", "path_to_file.txt");

    // Uložení ISO archivu do paměťového streamu
    isoArchive.Save(memoryStream);
}

Výjimky

Vyvoláno, když není archiv v režimu úprav.

Vyvoláno, když je stream null.