Class CabArchive
Namespace: Aspose.Zip.Cab
Assembly: Aspose.Zip.dll (25.1.0)
Diese Klasse repräsentiert eine CAB-Archivdatei.
public class CabArchive : 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
CabArchive(Stream)
Initialisiert eine neue Instanz der Aspose.Zip.Cab.CabArchive-Klasse und erstellt eine Liste von Einträgen, die aus dem Archiv extrahiert werden können.
public CabArchive(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 CabArchive(File.OpenRead("archive.cab")))
{
archive.ExtractToDirectory("C:\extracted");
}
Bemerkungen
Dieser Konstruktor entpackt keinen Eintrag. Siehe die Methode Aspose.Zip.Cab.CabEntry.Open zum Entpacken.
Ausnahmen
sourceStream
ist null.
sourceStream
ist nicht durchsuchbar.
sourceStream
ist kein gültiges CAB-Archiv.
Der Stream ist zu kurz.
CabArchive(string)
Initialisiert eine neue Instanz der Aspose.Zip.Cab.CabArchive-Klasse und erstellt eine Liste von Einträgen, die aus dem Archiv extrahiert werden können.
public CabArchive(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 CabArchive("archive.cab"))
{
archive.ExtractToDirectory("C:\extracted");
}
Bemerkungen
Dieser Konstruktor entpackt keinen Eintrag. Siehe die Methode Aspose.Zip.Cab.CabEntry.Open zum Entpacken.
Ausnahmen
path
ist null.
Der Aufrufer hat nicht die erforderliche Berechtigung für den Zugriff.
Der path
ist leer, enthält nur Leerzeichen oder enthält ungültige Zeichen.
Der Zugriff auf die Datei path
ist verweigert.
Der angegebene path
, Dateiname oder beides überschreitet die vom System definierten maximalen Längen. Zum Beispiel müssen auf Windows-basierten Plattformen Pfade weniger als 248 Zeichen und Dateinamen weniger als 260 Zeichen lang sein.
Die Datei unter 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 des Typs Aspose.Zip.Cab.CabEntry, die das Archiv bilden.
public ReadOnlyCollection<cabentry> Entries { get; }
Eigenschaftswert
ReadOnlyCollection<CabEntry>
Methoden
Dispose(bool)
Führt anwendungsspezifische Aufgaben aus, die mit dem Freigeben, Zurücksetzen oder Freigeben nicht verwalteter 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 nicht verwalteter Ressourcen verbunden sind.
public void Dispose()
ExtractToDirectory(string)
Extrahiert alle Dateien im Archiv in das angegebene Verzeichnis.
public void ExtractToDirectory(string destinationDirectory)
Parameter
destinationDirectory
string
Der Pfad zum Verzeichnis, in dem die extrahierten Dateien abgelegt werden sollen.
Beispiele
using (var archive = new CabArchive("archive.cab"))
{
archive.ExtractToDirectory("C:\extracted");
}
Bemerkungen
Wenn das Verzeichnis nicht existiert, wird es erstellt.
Ausnahmen
path ist null
Der angegebene Pfad, Dateiname oder beides überschreitet die vom System definierten maximalen Längen.
Der Aufrufer hat nicht die erforderliche Berechtigung für den 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 eines oder mehrere ungültige Zeichen. Ungültige Zeichen können mit der Methode System.IO.Path.GetInvalidPathChars abgefragt werden. -oder- path ist mit einem Doppelpunktzeichen (:) vorangestellt oder enthält nur ein Doppelpunktzeichen.
Das Verzeichnis, das durch den Pfad angegeben wird, ist eine Datei. -oder- Der Netzwerkname ist nicht bekannt.
Das Archiv ist beschädigt.