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
Implementuje
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
sourceStream
je null.
sourceStream
není vyhledatelný.
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.
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ř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ů.
Soubor na path
obsahuje dvojtečku (:) uprostřed řetězce.
Soubor nebyl nalezen.
Zadaná cesta je neplatná, například na nepřipojeném disku.
Soubor je již otevřen.
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.
filePath
je prázdný, obsahuje pouze bílé znaky nebo obsahuje neplatné znaky.
Přístup k souboru filePath
je odepřen.
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ů.
Soubor na filePath
obsahuje dvojtečku (:) uprostřed řetězce.
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.
Vyvoláno, když je path
null.
Vyvoláno, když je zadaná cesta neplatná, například na nepřipojeném disku.
Vyvoláno, když je soubor již otevřen.
Vyvoláno, když je přístup k souboru path
odepřen.
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.
Vyvoláno, když stream
není zapisovatelný.