Class RarArchive
Il nome: Aspose.Zip.Rar Assemblea: Aspose.Zip.dll (25.5.0)
Questa classe rappresenta il file di archivio RAR. Usalo per estrarre archivi RAR.
public class RarArchive : IArchive, IDisposableInheritance
Implements
I membri ereditari
object.GetType() , object.MemberwiseClone() , object.ToString() , object.Equals(object?) , object.Equals(object?, object?) , object.ReferenceEquals(object?, object?) , object.GetHashCode()
Constructors
RarArchive(String, 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’esempio seguente estrae un archivio, quindi decomprime la prima entrata in 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
path’ is null.
Il chiamante non ha il permesso di accesso richiesto.
La path’ è vuota, contiene solo spazi bianchi, o contiene caratteri invalidi.
L’accesso al file path" è rifiutato.
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.
Il file in path’ contiene una colonna (:) nel mezzo della riga.
Il file non è trovato.
Il percorso specificato è invalido, ad esempio essere su un drive non mappato.
Il file è già aperto.
RarArchive(Strumento, 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’esempio seguente è il decifero e la decompressione della prima entrata 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
Questo costruttore non decomprime nessuna entrata. vedi Aspose.Zip.Rar.RarArchiveEntry.Open(System.String) metodo per la decompressione.
Exceptions
sourceStream’ is not seekable.
- 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(di bool)
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 e 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
destinationDirectory’ is null.
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.
Il chiamante non ha il permesso richiesto per accedere al directory esistente.
Se la directory non esiste, il percorso contiene un carattere colonico (:) che non fa parte di un’etichetta drive (“C:”).
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 (:).
Il directory specificato per percorso è un file. -or- Il nome della rete non è noto.
ExtractToDirectory(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
destinationDirectory’ is null.
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.
Il chiamante non ha il permesso richiesto per accedere al directory esistente.
Se la directory non esiste, il percorso contiene un carattere colonico (:) che non fa parte di un’etichetta drive (“C:”).
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 (:).
Il directory specificato per percorso è un file. -or- Il nome della rete non è noto.
