Class RarArchive

Class RarArchive

Nombre del espacio: Aspose.Zip.Rar Asamblea: Aspose.Zip.dll (25.5.0)

Esta clase representa el archivo RAR. Utilice para extraer archivos RAR.

public class RarArchive : IArchive, IDisposable

Inheritance

object RarArchive

Implements

IArchive ,y, IDisposable

Miembros heredados

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

Constructors

RarArchive(Título: RarArchiveLoadOptions)

Inicia una nueva instancia de la clase Aspose.Zip.Rar.RarArchive y compone una lista de entradas que se puede extraer del archivo.

public RarArchive(string path, RarArchiveLoadOptions loadOptions = null)

Parameters

path string

El completo cualificado o el camino relativo al archivo.

loadOptions RarArchiveLoadOptions

Opciones para cargar archivos existentes con.

Examples

El siguiente ejemplo extrae un archivo, luego descomprende la primera entrada a.

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

Este constructor no descomprende ninguna entrada. ver Aspose.Zip.Rar.RarArchiveEntry.Open(System.String) método para descomprimir.

Exceptions

ArgumentNullException

path’ is null.

SecurityException

El solicitante no tiene la autorización necesaria para acceder.

ArgumentException

El path’ es vacío, contiene solo espacios blancos, o contiene caracteres invalidos.

UnauthorizedAccessException

Se denega el acceso al archivo path.

PathTooLongException

La ruta path", nombre de archivo, o ambos superan la longitud máxima definida por el sistema. Por ejemplo, en las plataformas basadas en Windows, los caminos deben ser menos de 248 caracteres, y los nombres de archivo deben ser menos de 260 caracteres.

NotSupportedException

El archivo en path’ contiene una columna (:) en el medio de la línea.

FileNotFoundException

El archivo no se encuentra.

DirectoryNotFoundException

La ruta especificada es invalida, como estar en un disco no mapeado.

IOException

El archivo ya está abierto.

RarArchive(RARCHIVE, RARCHIVE y RARCHIVE)

Inicia una nueva instancia de la clase Aspose.Zip.Rar.RarArchive y compone una lista de entradas que se puede extraer del archivo.

public RarArchive(Stream sourceStream, RarArchiveLoadOptions loadOptions = null)

Parameters

sourceStream Stream

La fuente del archivo.

loadOptions RarArchiveLoadOptions

Opciones para cargar archivos existentes con.

Examples

El siguiente ejemplo de descifrar y decomprimir 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

Este constructor no descomprende ninguna entrada. ver Aspose.Zip.Rar.RarArchiveEntry.Open(System.String) método para descomprimir.

Exceptions

ArgumentException

sourceStream’ is not seekable.

InvalidDataException

o - El archivo no es un archivo RAR.

Properties

Entries

Obtiene entradas del tipo Aspose.Zip.Rar.RarArchiveEntry que constituye el archivo raro.

public ReadOnlyCollection<rararchiveentry> Entries { get; }

Valor de la propiedad

ReadOnlyCollection &ylt; RarArchiveEntry >

Methods

Dispose(BOOL)

Desempeña tareas definidas por la aplicación asociadas con la liberación, liberación o restablecimiento de recursos no gestionados.

protected virtual void Dispose(bool disposing)

Parameters

disposing bool

Los recursos gestionados deben ser eliminados.

Dispose()

Desempeña tareas definidas por la aplicación asociadas con la liberación, liberación o restablecimiento de recursos no gestionados.

public void Dispose()

ExtractToDirectory(Título, Título)

Extracta todos los archivos en el directorio proporcionado.

[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 camino hacia el directorio para colocar los archivos extraídos.

password string

contraseña opcional para la decrypción.

Examples

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

Remarks

Si el directorio no existe, se crear.

Exceptions

ArgumentNullException

destinationDirectory’ is null.

PathTooLongException

Por ejemplo, en las plataformas basadas en Windows, los caminos deben ser menos de 248 caracteres y los nombres de archivo deben ser menos de 260 caracteres.

SecurityException

El llamador no tiene el permiso necesario para acceder al directorio existente.

NotSupportedException

Si el directorio no existe, el camino contiene un carácter colon (:) que no forma parte de una etiqueta de disco (“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 directorio especificado por ruta es un archivo. -o- El nombre de red no es conocido.

ExtractToDirectory(El string)

Extracta todos los archivos en el directorio proporcionado.

public void ExtractToDirectory(string destinationDirectory)

Parameters

destinationDirectory string

El camino hacia el directorio para colocar los archivos extraídos.

Examples

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

Remarks

Si el directorio no existe, se crear.

Exceptions

ArgumentNullException

destinationDirectory’ is null.

PathTooLongException

Por ejemplo, en las plataformas basadas en Windows, los caminos deben ser menos de 248 caracteres y los nombres de archivo deben ser menos de 260 caracteres.

SecurityException

El llamador no tiene el permiso necesario para acceder al directorio existente.

NotSupportedException

Si el directorio no existe, el camino contiene un carácter colon (:) que no forma parte de una etiqueta de disco (“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 directorio especificado por ruta es un archivo. -o- El nombre de red no es conocido.

 Español