Class WimArchive
Namespace: Aspose.Zip.Wim
Assembly: Aspose.Zip.dll (25.1.0)
Diese Klasse stellt eine wim-Archivdatei dar.
public class WimArchive : IArchive, IDisposable
Vererbung
Implementiert
Vererbte Mitglieder
object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
Konstruktoren
WimArchive(Stream)
Initialisiert eine neue Instanz der Aspose.Zip.Wim.WimArchive-Klasse und erstellt eine Liste von Einträgen, die aus dem Archiv extrahiert werden können.
public WimArchive(Stream sourceStream)
Parameter
sourceStream
Stream
Die Quelle des Archivs. Sie muss durchsuchbar sein.
Beispiele
Das folgende Beispiel zeigt, wie man alle Einträge in ein Verzeichnis extrahiert.
using (var archive = new WimArchive(File.OpenRead("archive.wim")))
{
archive.Images[0].ExtractToDirectory("C:\\extracted");
}
Bemerkungen
Dieser Konstruktor entpackt keinen Eintrag. Siehe die Methode Aspose.Zip.Wim.WimFileEntry.Open zum Entpacken.
Ausnahmen
sourceStream
ist null.
sourceStream
ist nicht durchsuchbar.
sourceStream
ist kein gültiges wim-Archiv.
WimArchive(string)
Initialisiert eine neue Instanz der Aspose.Zip.Wim.WimArchive-Klasse und erstellt eine Liste von Einträgen, die aus dem Archiv extrahiert werden können.
public WimArchive(string path)
Parameter
path
string
Der Pfad zur Archivdatei.
Beispiele
Das folgende Beispiel zeigt, wie man alle Einträge in ein Verzeichnis extrahiert.
using (var archive = new WimArchive("archive.wim"))
{
archive.Images[0].ExtractToDirectory("C:\\extracted");
}
Bemerkungen
Dieser Konstruktor entpackt keinen Eintrag. Siehe die Methode Aspose.Zip.Wim.WimFileEntry.Open zum Entpacken.
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 maximal definierte Länge des Systems. Beispielsweise müssen Pfade auf Windows-basierten Plattformen weniger als 248 Zeichen und Dateinamen weniger als 260 Zeichen lang sein.
Die Datei unter path
enthält einen Doppelpunkt (:) in der Mitte der Zeichenfolge.
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.
Eigenschaften
BootImageIndex
Erhält den (nullbasierten) Index des bootfähigen Images.
public int BootImageIndex { get; }
Eigenschaftswert
FileFormatVersion
Erhält die Version des Dateiformats.
public int FileFormatVersion { get; }
Eigenschaftswert
Guid
Erhält die identifizierende GUID für das Archiv.
public Guid Guid { get; }
Eigenschaftswert
Images
Erhält Einträge des Typs Aspose.Zip.Wim.WimImage, die das Archiv bilden.
public ReadOnlyCollection<wimimage> Images { get; }
Eigenschaftswert
ReadOnlyCollection<WimImage>
Manifest
Erhält das eingebettete Manifest, das die Datei und die enthaltenen Bilder beschreibt.
public string Manifest { get; }
Eigenschaftswert
Methoden
Dispose(bool)
Führt anwendungsspezifische Aufgaben aus, die mit dem Freigeben, Zurücksetzen oder Freigeben von nicht verwalteten Ressourcen verbunden sind.
protected virtual void Dispose(bool disposing)
Parameter
disposing
bool
Ob verwaltete Ressourcen freigegeben werden sollen.
Dispose()
Führt anwendungsspezifische Aufgaben aus, die mit dem Freigeben, Zurücksetzen oder Freigeben von nicht verwalteten Ressourcen verbunden sind.
public void Dispose()
ExtractToDirectory(string)
Extrahiert das Archiv in die Datei nach Pfad.
public void ExtractToDirectory(string destinationDirectory)
Parameter
destinationDirectory
string
Der Pfad zum Verzeichnis, in das die extrahierten Dateien gelegt werden sollen.
Ausnahmen
path ist null
Der angegebene Pfad, Dateiname oder beides überschreiten die maximal definierte Länge des Systems. Beispielsweise müssen Pfade auf Windows-basierten Plattformen weniger als 248 Zeichen und Dateinamen weniger als 260 Zeichen lang sein.
Der Aufrufer hat nicht die erforderliche Berechtigung zum Zugriff auf das vorhandene Verzeichnis.
Wenn das Verzeichnis nicht existiert, enthält der Pfad ein Doppelpunktzeichen (:) , das nicht Teil eines Laufwerkslabels (“C:") ist.
path ist eine Nullzeichenfolge, enthält nur Leerzeichen oder enthält ein oder mehrere ungültige Zeichen. Sie können ungültige Zeichen mit der Methode System.IO.Path.GetInvalidPathChars abfragen. -oder- path ist mit oder enthält nur ein Doppelpunktzeichen (:).
Das durch den Pfad angegebene Verzeichnis ist eine Datei. -oder- Der Netzwerkname ist nicht bekannt.
Das Archiv ist beschädigt.