Class RarArchive

Class RarArchive

Le nom : Aspose.Zip.Rar Assemblée: Aspose.Zip.dll (25.5.0)

Questa classe rappresenta il file di archivio RAR. Usalo per estrarre archivi RAR.

public class RarArchive : IArchive, IDisposable

Inheritance

object RarArchive

Implements

IArchive , IDisposable

I membri ereditari

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

Constructors

RarArchive(Sujets, RarArchiveLoadOptions)

Inizia una nuova instanza della classe Aspose.Zip.Rar.RarArchive e compone un elenco di entrate che può essere estratto dall’archivio.

public RarArchive(string path, RarArchiveLoadOptions loadOptions = null)

Parameters

path string

Il percorso completamente qualificato o relativo al file di archivio.

loadOptions RarArchiveLoadOptions

Opzioni per caricare archivi esistenti con.

Examples

L’exemple suivant extrait un fichier, puis décomprime la première entrée à un .

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

Questo costruttore non decomprime nessuna entrata. vedi Aspose.Zip.Rar.RarArchiveEntry.Open(System.String) metodo per la decompressione.

Exceptions

ArgumentNullException

path’ is null.

SecurityException

Il chiamante non ha il permesso di accesso richiesto.

ArgumentException

La path’ è vuota, contiene solo spazi bianchi, o contiene caratteri invalidi.

UnauthorizedAccessException

L’accesso al file path" è rifiutato.

PathTooLongException

La specifica path’, nome del file, o entrambi superano la lunghezza massima definita dal sistema. ad esempio, su piattaforme basate su Windows, i percorsi devono essere meno di 248 caratteri, e i nomi del file devono essere meno di 260 caratteri.

NotSupportedException

Il file in path’ contiene una colonna (:) nel mezzo della riga.

FileNotFoundException

Il file non è trovato.

DirectoryNotFoundException

Il percorso specificato è invalido, ad esempio essere su un drive non mappato.

IOException

Il file è già aperto.

RarArchive(Mise à jour, RarArchiveLoadOptions)

Inizia una nuova instanza della classe Aspose.Zip.Rar.RarArchive e compone un elenco di entrate che può essere estratto dall’archivio.

public RarArchive(Stream sourceStream, RarArchiveLoadOptions loadOptions = null)

Parameters

sourceStream Stream

La fonte dell’archivio.

loadOptions RarArchiveLoadOptions

Opzioni per caricare archivi esistenti con.

Examples

L’exemple suivant décifère et décomprime la première entrée à .

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

Questo costruttore non decomprime nessuna entrata. vedi Aspose.Zip.Rar.RarArchiveEntry.Open(System.String) metodo per la decompressione.

Exceptions

ArgumentException

sourceStream’ is not seekable.

InvalidDataException

  • o - Il file non è un archivio RAR.

Properties

Entries

Riceve le entrate del tipo Aspose.Zip.Rar.RarArchiveEntry che costituisce l’archivio raro.

public ReadOnlyCollection<rararchiveentry> Entries { get; }

Valore di proprietà

ReadOnlyCollection di < RarArchiveEntry >

Methods

Dispose(Boulée)

Esegue compiti definiti in applicazione associati al rilascio, al rilascio o al riutilizzo di risorse non gestite.

protected virtual void Dispose(bool disposing)

Parameters

disposing bool

Le risorse gestite dovrebbero essere sprecate.

Dispose()

Esegue compiti definiti in applicazione associati al rilascio, al rilascio o al riutilizzo di risorse non gestite.

public void Dispose()

ExtractToDirectory(String et String)

Estratta tutti i file nell’archivio nel directory fornito.

[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

Il percorso verso il directory per posizionare i file estratti.

password string

Password opzionale per la decrittura.

Examples

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

Remarks

Se il directory non esiste, sarà creato.

Exceptions

ArgumentNullException

destinationDirectory’ is null.

PathTooLongException

Il percorso specificato, il nome del file, o entrambi superano la lunghezza massima definita dal sistema. Ad esempio, su piattaforme basate su Windows, i percorsi devono essere meno di 248 caratteri e i nomi del file devono essere meno di 260 caratteri.

SecurityException

Il chiamante non ha il permesso richiesto per accedere al directory esistente.

NotSupportedException

Si le catalogue n’existe pas, la voie contient un caractère colon (:) qui n’est pas partie d’une étiquette de disque (“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

Il directory specificato per percorso è un file. -or- Il nome della rete non è noto.

ExtractToDirectory(Le string)

Estratta tutti i file nell’archivio nel directory fornito.

public void ExtractToDirectory(string destinationDirectory)

Parameters

destinationDirectory string

Il percorso verso il directory per posizionare i file estratti.

Examples

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

Remarks

Se il directory non esiste, sarà creato.

Exceptions

ArgumentNullException

destinationDirectory’ is null.

PathTooLongException

Il percorso specificato, il nome del file, o entrambi superano la lunghezza massima definita dal sistema. Ad esempio, su piattaforme basate su Windows, i percorsi devono essere meno di 248 caratteri e i nomi del file devono essere meno di 260 caratteri.

SecurityException

Il chiamante non ha il permesso richiesto per accedere al directory esistente.

NotSupportedException

Si le catalogue n’existe pas, la voie contient un caractère colon (:) qui n’est pas partie d’une étiquette de disque (“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

Il directory specificato per percorso è un file. -or- Il nome della rete non è noto.

 Français