Class RarArchive

Class RarArchive

Der Name: Aspose.Zip.Rar Versammlung: Aspose.Zip.dll (25.5.0)

Diese Klasse stellt RAR-Archivdatei dar. Verwenden Sie es, um RAR-Archive zu extrahieren.

public class RarArchive : IArchive, IDisposable

Inheritance

object RarArchive

Implements

IArchive , IDisposable

Vererbte Mitglieder

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

Constructors

RarArchive(String, RarArchiveLoadOptions)

Initialisiert eine neue Instanz der Aspose.Zip.Rar.RarArchive Klasse und komponiert eine Einträge, die aus dem Archiv extrahiert werden kann.

public RarArchive(string path, RarArchiveLoadOptions loadOptions = null)

Parameters

path string

Die voll qualifizierte oder die relative Route zum Archivdatei.

loadOptions RarArchiveLoadOptions

Die Optionen, bestehende Archiv mit zu laden.

Examples

Das folgende Beispiel extrahiert ein Archiv und dekomprimiert dann den ersten Eingang in eine.

var extracted = new MemoryStream();
using (RarArchive archive = new RarArchive("data.rar"))
{
    using (var decompressed = archive.Entries[0].Open())
    {
        byte[] b = new byte[8192];
        int bytesRead;
        while (0 < (bytesRead = decompressed.Read(b, 0, b.Length)))
            extracted.Write(b, 0, bytesRead);
    }
}

Remarks

Dieser Konstruktor dekomprimiert keine Einträge. siehe Aspose.Zip.Rar.RarArchiveEntry.Open(System.String) Methode zur dekomprimierung.

Exceptions

ArgumentNullException

path’ is null.

SecurityException

Der Anrufgeber hat nicht die erforderliche Erlaubnis für den Zugang.

ArgumentException

Die path’ ist leer, enthält nur weiße Räume oder enthält ungültige Zeichen.

UnauthorizedAccessException

Der Zugriff auf die Datei path" wird abgelehnt.

PathTooLongException

Die angegebenen path’, Dateinamen, oder beide überschreiten die Systemdefinierte maximale Länge. Zum Beispiel auf Windows-basierten Plattformen müssen die Paths weniger als 248 Zeichen und Dateinamen weniger als 260 Zeichen sein.

NotSupportedException

Die Datei bei path’ enthält eine Kolonne (:) in der Mitte der Zeile.

FileNotFoundException

Die Datei ist nicht gefunden.

DirectoryNotFoundException

Der angegebenen Weg ist ungültig, z. B. auf einem unmapped Drive.

IOException

Die Datei ist bereits geöffnet.

RarArchive(Stream, RarArchiveLoadOptions)

Initialisiert eine neue Instanz der Aspose.Zip.Rar.RarArchive Klasse und komponiert eine Einträge, die aus dem Archiv extrahiert werden kann.

public RarArchive(Stream sourceStream, RarArchiveLoadOptions loadOptions = null)

Parameters

sourceStream Stream

Die Quelle des Archivs.

loadOptions RarArchiveLoadOptions

Die Optionen, bestehende Archiv mit zu laden.

Examples

Das folgende Beispiel deciferiert und dekompressiert den ersten Eingang zu a.

var fs = File.OpenRead("encrypted.rar");
var extracted = new MemoryStream();
using (RarArchive archive = new RarArchive(fs, new RarArchiveLoadOptions() { DecryptionPassword = "p@s$" }))
{
    using (var decompressed = archive.Entries[0].Open())
    {
        byte[] b = new byte[8192];
        int bytesRead;
        while (0 < (bytesRead = decompressed.Read(b, 0, b.Length)))
            extracted.Write(b, 0, bytesRead);
    }
}

Remarks

Dieser Konstruktor dekomprimiert keine Einträge. siehe Aspose.Zip.Rar.RarArchiveEntry.Open(System.String) Methode zur dekomprimierung.

Exceptions

ArgumentException

sourceStream’ is not seekable.

InvalidDataException

Fehler Unterschrift für das Archiv. - oder - Die Datei ist kein RAR-Archiv.

Properties

Entries

Er bekommt Beiträge von Aspose.Zip.Rar.RarArchiveEntry-Typ, die das seltene Archiv darstellt.

public ReadOnlyCollection<rararchiveentry> Entries { get; }

Eigentumswert

ReadOnlyCollection &undlt; RarArchiveEntry >

Methods

Dispose(Bool)

Er erfüllt anwendungsdefinierte Aufgaben, die mit der Freisetzung, Freisetzung oder Wiederherstellung unverwalter Ressourcen verbunden sind.

protected virtual void Dispose(bool disposing)

Parameters

disposing bool

Ob verwaltete Ressourcen abgeschieden werden sollten.

Dispose()

Er erfüllt anwendungsdefinierte Aufgaben, die mit der Freisetzung, Freisetzung oder Wiederherstellung unverwalter Ressourcen verbunden sind.

public void Dispose()

ExtractToDirectory(String und String)

Entfernen Sie alle Dateien im Archiv in das angebotene Katalog.

[Obsolete("For extraction encrypted RAR archive please provide password in constructor with Aspose.Zip.Rar.RarArchiveLoadOptions.DecryptionPassword")]
public void ExtractToDirectory(string destinationDirectory, string password = null)

Parameters

destinationDirectory string

Der Weg zum Katalog, um die extrahierten Dateien in.

password string

Optional Passwort für die Verschlüsselung.

Examples

using (var archive = new RarArchive("archive.rar")) 
{ 
   archive.ExtractToDirectory("C:\extracted", "$ecRet");
}

Remarks

Wenn das Katalog nicht existiert, wird es erstellt.

Exceptions

ArgumentNullException

destinationDirectory’ is null.

PathTooLongException

Die angegebenen Path, Dateinamen oder beide überschreiten die Systemdefinierte maximale Länge. Zum Beispiel müssen auf Windows-basierten Plattformen Paths weniger als 248 Zeichen und Dateinamen weniger als 260 Zeichen sein.

SecurityException

Der Anrufgeber hat nicht die erforderliche Erlaubnis, das bestehende Direktorium zuzugreifen.

NotSupportedException

Wenn der Direktor nicht existiert, enthält der Pfad einen Zollkarakter (:) der nicht Teil eines Labels ist (“C:”).

ArgumentException

destinationDirectory’ is a zero-length string, contains only white space, or contains one or more invalid characters. You can query for invalid characters by using the System.IO.Path.GetInvalidPathChars method. -or- path is prefixed with, or contains, only a colon character (:).

IOException

Die durch den Weg angegebenen Katalog ist eine Datei. -or- Der Netzwerkname ist nicht bekannt.

ExtractToDirectory(String)

Entfernen Sie alle Dateien im Archiv in das angebotene Katalog.

public void ExtractToDirectory(string destinationDirectory)

Parameters

destinationDirectory string

Der Weg zum Katalog, um die extrahierten Dateien in.

Examples

using (var archive = new RarArchive("archive.rar")) 
{ 
   archive.ExtractToDirectory("C:\extracted");
}

Remarks

Wenn das Katalog nicht existiert, wird es erstellt.

Exceptions

ArgumentNullException

destinationDirectory’ is null.

PathTooLongException

Die angegebenen Path, Dateinamen oder beide überschreiten die Systemdefinierte maximale Länge. Zum Beispiel müssen auf Windows-basierten Plattformen Paths weniger als 248 Zeichen und Dateinamen weniger als 260 Zeichen sein.

SecurityException

Der Anrufgeber hat nicht die erforderliche Erlaubnis, das bestehende Direktorium zuzugreifen.

NotSupportedException

Wenn der Direktor nicht existiert, enthält der Pfad einen Zollkarakter (:) der nicht Teil eines Labels ist (“C:”).

ArgumentException

destinationDirectory’ is a zero-length string, contains only white space, or contains one or more invalid characters. You can query for invalid characters by using the System.IO.Path.GetInvalidPathChars method. -or- path is prefixed with, or contains, only a colon character (:).

IOException

Die durch den Weg angegebenen Katalog ist eine Datei. -or- Der Netzwerkname ist nicht bekannt.

 Deutsch