Class IsoArchive
Namespace: Aspose.Zip.Iso
Assembly: Aspose.Zip.dll (25.1.0)
Stellt ein ISO-Archiv (ISO 9660) dar.
public sealed class IsoArchive : IArchive, IDisposableVererbung
Implementiert
Vererbte Mitglieder
object.GetType(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
Konstruktoren
IsoArchive()
Initialisiert eine neue Instanz der Aspose.Zip.Iso.IsoArchive-Klasse und erstellt ein leeres ISO-Archiv, um neue Dateien und Verzeichnisse hinzuzufügen.
public IsoArchive()Beispiele
Das folgende Beispiel zeigt, wie man ein neues leeres ISO-Archiv erstellt und Dateien hinzufügt:
// Erstelle ein neues leeres ISO-Archiv
using(IsoArchive isoArchive = new IsoArchive())
{
// Füge Dateien zum ISO-Archiv hinzu
isoArchive.CreateEntry("example_file.txt", "path_to_file.txt");
// Speichere das ISO-Archiv in einer Datei
isoArchive.Save("new_archive.iso");
}IsoArchive(Stream, IsoLoadOptions)
Initialisiert eine neue Instanz der Aspose.Zip.Iso.IsoArchive-Klasse und erstellt eine Liste von Einträgen, die aus dem Archiv extrahiert werden können.
public IsoArchive(Stream sourceStream, IsoLoadOptions loadOptions = null)Parameter
sourceStream Stream
Die Quelle des Archivs. Es muss durchsuchbar sein.
loadOptions IsoLoadOptions
Die Optionen, um das Archiv zu laden.
Beispiele
Das folgende Beispiel zeigt, wie man alle Einträge in ein Verzeichnis extrahiert.
using (var archive = new IsoArchive(File.OpenRead("archive.iso")))
{
archive.ExtractToDirectory("C:\\extracted");
}Anmerkungen
Dieser Konstruktor entpackt keinen Eintrag.
Ausnahmen
sourceStream ist null.
sourceStream ist nicht durchsuchbar.
sourceStream ist kein gültiges ISO-Archiv.
IsoArchive(string, IsoLoadOptions)
Initialisiert eine neue Instanz der Aspose.Zip.Iso.IsoArchive-Klasse und erstellt eine Liste von Einträgen, die aus dem Archiv extrahiert werden können.
public IsoArchive(string path, IsoLoadOptions loadOptions = null)Parameter
path string
Der Pfad zur Archivdatei.
loadOptions IsoLoadOptions
Die Optionen, um das Archiv zu laden.
Beispiele
Das folgende Beispiel zeigt, wie man alle Einträge in ein Verzeichnis extrahiert.
using (var archive = new IsoArchive("archive.iso"))
{
archive.ExtractToDirectory("C:\\extracted");
}Anmerkungen
Dieser Konstruktor entpackt keinen Eintrag.
Ausnahmen
path ist null.
Der Aufrufer hat nicht die erforderliche Berechtigung zum Zugriff.
Der path ist leer, enthält nur Leerzeichen oder enthält ungültige Zeichen.
Zugriff auf die Datei path ist verweigert.
Der angegebene path, Dateiname oder beides überschreiten die vom System definierten maximalen Längen. Beispielsweise müssen auf Windows-basierten Plattformen Pfade weniger als 248 Zeichen und Dateinamen weniger als 260 Zeichen haben.
Die Datei am path enthält einen Doppelpunkt (:) in der Mitte des Strings.
Die Datei wurde nicht gefunden.
Der angegebene Pfad ist ungültig, z.B. wenn er sich auf einem nicht zugeordneten Laufwerk befindet.
Die Datei ist bereits geöffnet.
Die Datei ist zu kurz.
Eigenschaften
Entries
Erhält die Einträge vom Typ Aspose.Zip.Iso.IsoEntry, die das Archiv bilden.
public ReadOnlyCollection<isoentry> Entries { get; }Eigenschaftswert
ReadOnlyCollection<IsoEntry>
Methoden
CreateDirectory(string)
Fügt dem ISO-Image ein Verzeichnis hinzu.
public IsoEntry CreateDirectory(string name)Parameter
name string
Pfad des Verzeichnisses im ISO.
Rückgabewert
Der zusammengesetzte ISO-Eintrag.
Ausnahmen
Das Archiv ist zum Entpacken geöffnet.
name ist null oder leer.
CreateEntry(string, string)
Fügt dem ISO-Image eine Datei hinzu.
public IsoEntry CreateEntry(string name, string filePath)Parameter
name string
Pfad der Datei im ISO.
filePath string
Pfad der Datei.
Rückgabewert
Der zusammengesetzte ISO-Eintrag.
Ausnahmen
Der filePath ist null.
Der filePath ist leer, enthält nur Leerzeichen oder enthält ungültige Zeichen.
Zugriff auf die Datei filePath ist verweigert.
Der angegebene filePath überschreitet die vom System definierten maximalen Längen. Beispielsweise müssen auf Windows-basierten Plattformen Pfade weniger als 248 Zeichen und Dateinamen weniger als 260 Zeichen haben.
Die Datei am filePath enthält einen Doppelpunkt (:) in der Mitte des Strings.
Ein I/O-Fehler ist beim Öffnen der Datei aufgetreten.
CreateEntry(string, Stream)
Fügt dem ISO-Image eine Datei hinzu.
public IsoEntry CreateEntry(string name, Stream source)Parameter
name string
Pfad der Datei im ISO.
source Stream
Stream, der die Dateidaten enthält.
Rückgabewert
Der zusammengesetzte ISO-Eintrag.
CreateEntry(string)
Fügt dem ISO-Image eine Datei hinzu.
public IsoEntry CreateEntry(string name)Parameter
name string
Pfad des Verzeichnisses im ISO.
Rückgabewert
Der zusammengesetzte ISO-Eintrag.
Ausnahmen
name ist null oder leer.
Das Archiv ist zum Entpacken geöffnet.
Dispose()
Führt anwendungsspezifische Aufgaben aus, die mit dem Freigeben, Zurücksetzen oder Freigeben nicht verwalteter Ressourcen verbunden sind.
public void Dispose()ExtractToDirectory(string)
Extrahiert alle Einträge in das angegebene Verzeichnis.
public void ExtractToDirectory(string destinationDirectory)Parameter
destinationDirectory string
Das Verzeichnis, in das die Einträge extrahiert werden sollen.
Beispiele
Das folgende Beispiel zeigt, wie man alle Einträge in ein Verzeichnis extrahiert:
using (var archive = new IsoArchive(File.OpenRead("archive.iso")))
{
archive.ExtractToDirectory("C:\\extracted");
}Ausnahmen
Ausgelöst, wenn das Archiv im Bearbeitungsmodus ist.
Ausgelöst, wenn das destinationDirectory null ist.
Save(string, IsoSaveOptions)
Speichert das ISO-Image an dem angegebenen Pfad.
public void Save(string path, IsoSaveOptions saveOptions = null)Parameter
path string
Der Pfad, an dem das ISO-Image gespeichert wird.
saveOptions IsoSaveOptions
Optionen zum Speichern des ISO-Archivs.
Beispiele
Das folgende Beispiel zeigt, wie man ein ISO-Archiv in einer Datei speichert:
// Erstelle ein neues leeres ISO-Archiv
using(IsoArchive isoArchive = new IsoArchive())
{
// Füge Dateien zum ISO-Archiv hinzu
isoArchive.CreateEntry("example_file.txt", "path_to_file.txt");
// Speichere das ISO-Archiv in einer Datei
isoArchive.Save("new_archive.iso");
}Ausnahmen
Ausgelöst, wenn das Archiv nicht im Bearbeitungsmodus ist.
Ausgelöst, wenn der path null ist.
Ausgelöst, wenn der angegebene Pfad ungültig ist, z.B. wenn er sich auf einem nicht zugeordneten Laufwerk befindet.
Ausgelöst, wenn die Datei bereits geöffnet ist.
Ausgelöst, wenn der Zugriff auf die Datei path verweigert wird.
Ausgelöst, wenn der angegebene path die vom System definierten maximalen Längen überschreitet.
Save(Stream, IsoSaveOptions)
Speichert das ISO-Image im angegebenen Stream.
public void Save(Stream stream, IsoSaveOptions saveOptions = null)Parameter
stream Stream
Der Stream, in dem das ISO-Image gespeichert wird.
saveOptions IsoSaveOptions
Optionen zum Speichern des ISO-Archivs.
Beispiele
Das folgende Beispiel zeigt, wie man ein ISO-Archiv in einem Speicherstream speichert:
// Erstelle ein neues leeres ISO-Archiv
using(IsoArchive isoArchive = new IsoArchive())
{
// Füge Dateien zum ISO-Archiv hinzu
isoArchive.CreateEntry("example_file.txt", "path_to_file.txt");
// Speichere das ISO-Archiv in einem Speicherstream
isoArchive.Save(memoryStream);
}Ausnahmen
Ausgelöst, wenn das Archiv nicht im Bearbeitungsmodus ist.
Ausgelöst, wenn der stream null ist.
Ausgelöst, wenn der stream nicht beschreibbar ist.
