Class IsoArchive

Class IsoArchive

Namespace: Aspose.Zip.Iso
Assembly: Aspose.Zip.dll (25.1.0)

Reprezentuje ISO archiv (ISO 9660).

public sealed class IsoArchive : IArchive, IDisposable

Dědičnost

objectIsoArchive

Implementuje

IArchive, IDisposable

Děděné členy

object.GetType(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()

Konstruktor

IsoArchive()

Inicializuje novou instanci třídy Aspose.Zip.Iso.IsoArchive a vytváří prázdný ISO archiv pro přidání nových souborů a adresářů.

public IsoArchive()

Příklady

Následující příklad ukazuje, jak vytvořit nový prázdný ISO archiv a přidat do něj soubory:

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

IsoArchive(Stream, IsoLoadOptions)

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

public IsoArchive(Stream sourceStream, IsoLoadOptions loadOptions = null)

Parametry

sourceStream Stream

Zdrojem archivu. Musí být vyhledatelný.

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(File.OpenRead("archive.iso")))
{ 
   archive.ExtractToDirectory("C:\\extracted");
}

Poznámky

Tento konstruktor nerozbalí žádnou položku.

Výjimky

ArgumentNullException

sourceStream je null.

ArgumentException

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

ArgumentNullException

path je null.

SecurityException

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

ArgumentException

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

UnauthorizedAccessException

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&gt;

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í

IsoEntry

Složený ISO záznam.

Výjimky

InvalidOperationException

Archiv je otevřen pro extrakci.

ArgumentNullException

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í

IsoEntry

Složený ISO záznam.

Výjimky

ArgumentNullException

filePath je null.

ArgumentException

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

UnauthorizedAccessException

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í

IsoEntry

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í

IsoEntry

Složený ISO záznam.

Výjimky

ArgumentNullException

name je null nebo prázdný.

InvalidOperationException

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

InvalidOperationException

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

ArgumentNullException

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

InvalidOperationException

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

ArgumentNullException

Vyvoláno, když je path null.

DirectoryNotFoundException

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

InvalidOperationException

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

ArgumentNullException

Vyvoláno, když je stream null.

ArgumentException

Vyvoláno, když stream není zapisovatelný.

 Čeština