Class RarArchive

Class RarArchive

Nom dels espais: Aspose.Zip.Rar Assemblea: Aspose.Zip.dll (25.5.0)

Aquesta classe representa el fitxer d’arxiu RAR. Utilitzeu-lo per extreure arxius RAR.

public class RarArchive : IArchive, IDisposable

Inheritance

object RarArchive

Implements

IArchive , IDisposable

Membres heretats

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

Constructors

RarArchive(Arxiu, RarArchiveLoadOptions)

Inicialitza una nova instància de la classe Aspose.Zip.Rar.RarArchive i componeix una llista d’entrada que es pot extreure de l’arxiu.

public RarArchive(string path, RarArchiveLoadOptions loadOptions = null)

Parameters

path string

El completament qualificat o el camí relatiu a l’arxiu.

loadOptions RarArchiveLoadOptions

Opcions per carregar arxius existents amb.

Examples

L’exemple següent extraeix un arxiu, i després descomprimeix la primera entrada a 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

Aquest constructor no descomprimeix cap entrada. Veure Aspose.Zip.Rar.RarArchiveEntry.Open(System.String) mètode per descomprimir.

Exceptions

ArgumentNullException

path’ is null.

SecurityException

El client no té el permís d’accés requerit.

ArgumentException

La path’ és buida, només conté espais blancs, o conté caràcters invalidats.

UnauthorizedAccessException

L’accés al fitxer path" es nega.

PathTooLongException

El nom de fitxer especificat path", o tots dos superen la longitud màxima definida pel sistema. per exemple, en les plataformes basades en Windows, els passos han de ser menys de 248 caràcters, i els noms de fitxer han de ser menys de 260 caràcters.

NotSupportedException

El fitxer a path’ conté una columna (:) al mig de la cadena.

FileNotFoundException

El fitxer no es troba.

DirectoryNotFoundException

La ruta especificada és invalidada, com per exemple estar en un disc no mapat.

IOException

El fitxer ja està obert.

RarArchive(Arxiu, RarArchiveLoadOptions)

Inicialitza una nova instància de la classe Aspose.Zip.Rar.RarArchive i componeix una llista d’entrada que es pot extreure de l’arxiu.

public RarArchive(Stream sourceStream, RarArchiveLoadOptions loadOptions = null)

Parameters

sourceStream Stream

La font de l’arxiu.

loadOptions RarArchiveLoadOptions

Opcions per carregar arxius existents amb.

Examples

L’exemple següent és descomprimir i descomprimir la primera entrada 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

Aquest constructor no descomprimeix cap entrada. Veure Aspose.Zip.Rar.RarArchiveEntry.Open(System.String) mètode per descomprimir.

Exceptions

ArgumentException

sourceStream’ is not seekable.

InvalidDataException

o - El fitxer no és un arxiu RAR.

Properties

Entries

Obté entrades del tipus Aspose.Zip.Rar.RarArchiveEntry que constitueix l’arxiu rar.

public ReadOnlyCollection<rararchiveentry> Entries { get; }

Valor de la propietat

ReadOnlyCollection < RarArchiveEntry >

Methods

Dispose(La botiga)

Realitza tasques definides per aplicació associades amb el lliurament, el lliurament o la restauració de recursos no gestionats.

protected virtual void Dispose(bool disposing)

Parameters

disposing bool

S’han de disposar de recursos gestionats.

Dispose()

Realitza tasques definides per aplicació associades amb el lliurament, el lliurament o la restauració de recursos no gestionats.

public void Dispose()

ExtractToDirectory(Tècnic, Tècnic)

Extrata tots els arxius de l’arxiu a la direcció proporcionada.

[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

El camí a la direcció per col·locar els arxius extraïts.

password string

Password opcional per a la decrypci.

Examples

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

Remarks

Si la direcció no existeix, es crear.

Exceptions

ArgumentNullException

destinationDirectory’ is null.

PathTooLongException

Per exemple, en les plataformes basades en Windows, els camins han de ser menys de 248 caràcters i els noms de fitxers han de ser menys de 260 caràcters.

SecurityException

El sol·licitant no té l’autorització necessària per accedir a la direcció existent.

NotSupportedException

Si el directori no existeix, el recorregut conté un caràcter colon (:) que no forma part d’una etiqueta de disc (“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

El directori especificat per ruta és un arxiu. -o- El nom de la xarxa no és conegut.

ExtractToDirectory(Tàrrega)

Extrata tots els arxius de l’arxiu a la direcció proporcionada.

public void ExtractToDirectory(string destinationDirectory)

Parameters

destinationDirectory string

El camí a la direcció per col·locar els arxius extraïts.

Examples

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

Remarks

Si la direcció no existeix, es crear.

Exceptions

ArgumentNullException

destinationDirectory’ is null.

PathTooLongException

Per exemple, en les plataformes basades en Windows, els camins han de ser menys de 248 caràcters i els noms de fitxers han de ser menys de 260 caràcters.

SecurityException

El sol·licitant no té l’autorització necessària per accedir a la direcció existent.

NotSupportedException

Si el directori no existeix, el recorregut conté un caràcter colon (:) que no forma part d’una etiqueta de disc (“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

El directori especificat per ruta és un arxiu. -o- El nom de la xarxa no és conegut.

 Català