Class Lz4Archive

Class Lz4Archive

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

Esta clase representa el archivo LZ4. Utilice-lo para extraer o componer archivos Lz4.

public class Lz4Archive : IArchive, IDisposable, IArchiveFileEntry

Inheritance

object Lz4Archive

Implements

IArchive ,y, IDisposable ,y, IArchiveFileEntry

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

Lz4Archive(Stream)

Inicia una nueva instancia de la clase Aspose.Zip.Lz4.Lz4Archive preparada para la decompresión.

public Lz4Archive(Stream sourceStream)

Parameters

sourceStream Stream

La fuente del archivo.

Examples

Abrir un archivo de una corriente y extraerlo a una

var ms = new MemoryStream();
using (Lz4Archive archive = new Lz4Archive(File.OpenRead("archive.lz4")))
  archive.Open().CopyTo(ms);

Remarks

Este constructor no descomprende. ver Aspose.Zip.Lz4.Lz4Archive.Método abierto para descomprimir.

Exceptions

ArgumentException

No se puede leer desde sourceStream'

ArgumentNullException

sourceStream’ is null.

EndOfStreamException

sourceStream’ is too short.

InvalidDataException

El sourceStream’ tiene una firma equivocada.

Lz4Archive(El string)

Inicia una nueva instancia de la clase Aspose.Zip.Lz4.Lz4Archive.

public Lz4Archive(string path)

Parameters

path string

El camino hacia el archivo.

Examples

Abrir un archivo de un fichero por vía y extraerlo a una

var ms = new MemoryStream();
using (Lz4Archive archive = new Lz4Archive("archive.lz4"))
  archive.Open().CopyTo(ms);

Remarks

Este constructor no descomprende. ver Aspose.Zip.Lz4.Lz4Archive.Método abierto 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.

EndOfStreamException

El archivo es demasiado corto.

InvalidDataException

Los datos en el archivo tienen la firma incorrecta.

Lz4Archive(Lz4ArchiveSetting)

Inicia una nueva instancia de la clase de archivos Aspose.Zip.Lz4.Lc4 preparada para la compresión.

public Lz4Archive(Lz4ArchiveSetting settings = null)

Parameters

settings Lz4ArchiveSetting

La configuración del archivo compuesto.

Methods

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()

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.

Extract(El string)

Extrae el archivo al archivo por vía.

public FileInfo Extract(string path)

Parameters

path string

El camino hacia el archivo de destino.Si el archivo ya existe, será sobreescrito.

Returns

FileInfo

Información de un archivo extraído.

Exceptions

EndOfStreamException

El flujo de fuentes es demasiado corto.

InvalidDataException

Los bajetas equivocados encontrados durante la decodificación.

NotSupportedException

Esta versión LZ4 no está soportada.

Extract(Stream)

Extrae el archivo a la corriente proporcionada.

public void Extract(Stream destination)

Parameters

destination Stream

Destination stream. debe ser escrito.

Examples

using (var archive = new Lz4Archive("archive.lz4"))
{
     archive.Extract(httpResponseStream);
}

Exceptions

ArgumentException

destination’ does not support writing.

EndOfStreamException

El flujo de fuentes es demasiado corto.

InvalidDataException

Los bajetas equivocados encontrados durante la decodificación.

NotSupportedException

Esta versión LZ4 no está soportada.

InvalidOperationException

El archivo está preparado para la composición.

ExtractToDirectory(El string)

Extrae el contenido del archivo al directorio proporcionado.

public void ExtractToDirectory(string destinationDirectory)

Parameters

destinationDirectory string

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

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.

EndOfStreamException

El flujo de fuentes es demasiado corto.

InvalidDataException

Los bajos equivocados se encuentran al iniciar la decodificación.

InvalidOperationException

El archivo está preparado para la composición.

Open()

Abre el archivo para extracción y proporciona un flujo con contenido de archivo.

public Stream Open()

Returns

Stream

El flujo que representa el contenido del archivo.

Examples

Extrae el archivo y copia el contenido extraído al flujo de archivos.

using (var archive = new Lz4Archive("archive.lz4"))
{
    using (var extracted = File.Create("data.bin"))
    {
        var unpacked = archive.Open();
        byte[] b = new byte[8192];
        int bytesRead;
        while (0 < (bytesRead = unpacked.Read(b, 0, b.Length)))
            extracted.Write(b, 0, bytesRead);
    }            
}

Usted puede usar el método Stream.CopyTo para .NET 4.0 y superior: ‘unpacked.Kopio(extraído);’

Remarks

Leer desde el flujo para obtener el contenido original de un archivo. ver la sección de ejemplos.

Exceptions

EndOfStreamException

El flujo de fuentes es demasiado corto.

InvalidDataException

Los bajos equivocados se encuentran al iniciar la decodificación.

InvalidOperationException

El archivo está preparado para la composición.

Save(Stream)

Salva el archivo lz4 a la corriente proporcionada.

public void Save(Stream output)

Parameters

output Stream

El flujo de destino.

Examples

using (FileStream lz4File = File.Open("archive.lz4", FileMode.Create))
{
    using (var archive = new Lz4Archive())
    {
        archive.SetSource("data.bin");
        archive.Save(lz4File);
     }
}

Remarks

debe ser buscable.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

InvalidOperationException

El archivo está preparado para la extracción. - o - Fuente no fue suministrada.

Save(FileInfo)

Salva el archivo lz4 a la ficha de destino proporcionada.

public void Save(FileInfo destination)

Parameters

destination FileInfo

FileInfo, que se abrirá como flujo de destino.

Examples

using (var archive = new Lz4Archive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save(new FileInfo("archive.lz4"));
}

Exceptions

SecurityException

El llamador no tiene el permiso necesario para abrir la destination'.

ArgumentException

La ruta de archivo es vacía o contiene solo espacios blancos.

FileNotFoundException

El archivo no se encuentra.

UnauthorizedAccessException

El camino al archivo es leído o es un directorio.

ArgumentNullException

destination’ is null.

DirectoryNotFoundException

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

IOException

El archivo ya está abierto.

InvalidOperationException

El archivo está preparado para la extracción.

Save(El string)

Salva archivo al archivo de destino proporcionado.

public void Save(string destinationFileName)

Parameters

destinationFileName string

Si el nombre de archivo especificado indica a un archivo existente, se reescribir.

Examples

using (var archive = new LZ4Archive())
{
    archive.SetSource("data.bin");
    archive.Save("archive.lz4");
}

Exceptions

ArgumentNullException

destinationFileName’ is null.

SecurityException

El solicitante no tiene la autorización necesaria para acceder

ArgumentException

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

UnauthorizedAccessException

Se denega el acceso al archivo destinationFileName.

PathTooLongException

La destinationFileName’, 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 la destinationFileName’ contiene una columna (:) en el medio de la línea.

InvalidOperationException

El archivo está preparado para la extracción.

SetSource(Stream)

Coloca el contenido para ser comprimido dentro del archivo.

public void SetSource(Stream source)

Parameters

source Stream

El flujo de entrada para el archivo.

Examples

using (var archive = new Lz4Archive())
{
    archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
    archive.Save("archive.lz4");
}

Exceptions

InvalidOperationException

El archivo está preparado para la extracción.

SetSource(FileInfo)

Coloca el contenido para ser comprimido dentro del archivo.

public void SetSource(FileInfo fileInfo)

Parameters

fileInfo FileInfo

La referencia a un archivo para ser comprimido.

Examples

Abrir un archivo de una corriente y extraerlo a una

using (var archive = new Lz4Archive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save("archive.lz4");
}

Exceptions

InvalidOperationException

El archivo está preparado para la extracción.

SetSource(Arquitectura, TarFormat)

Coloca el contenido para ser comprimido dentro del archivo.

public void SetSource(TarArchive tarArchive, TarFormat format = TarFormat.UsTar)

Parameters

tarArchive TarArchive

Archivo para ser comprimido.

format TarFormat

Definición del formato tar header.

Examples

using (var tarArchive = new TarArchive())
{
    tarArchive.CreateEntry("first.bin", "data1.bin");
    tarArchive.CreateEntry("second.bin", "data2.bin");
    using (var lz4Archive = new Lz4Archive())
    {
        lz4Archive.SetSource(tarArchive);
        lz4Archive.Save("archive.tar.lz4");
    }
}

Remarks

Utilice este método para componer archivos conjuntos tar.lz4.

SetSource(El string)

Coloca el contenido para ser comprimido dentro del archivo.

public void SetSource(string path)

Parameters

path string

El camino para que el archivo sea comprimido.

Examples

Abrir un archivo de un fichero por vía y extraerlo a una

using (var archive = new Lz4Archive()) 
{
    archive.SetSource("data.bin");
    archive.Save("archive.lz4");
}

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.

InvalidOperationException

Este archivo está preparado para la extracción.

 Español