Class XzArchive

Class XzArchive

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

Esta clase representa el archivo xz. Utilice para compilar y extraer archivos xz.

public class XzArchive : IArchive, IDisposable, IArchiveFileEntry

Inheritance

object XzArchive

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

XzArchive(XzArchiveSettings)

Inicializa una nueva instancia de la clase Aspose.Zip.Xz.XzArchive y compone el archivo en formato xz.

public XzArchive(XzArchiveSettings settings = null)

Parameters

settings XzArchiveSettings

Set de configuración específica xz archivo: tamaño diccionario, tamaño de bloque, tipo de verificación.

XzArchive(Stream)

Inicia una nueva instancia de la clase Aspose.Zip.Xz.XzArchive preparada para la decompresión.

public XzArchive(Stream source)

Parameters

source Stream

La fuente del archivo.

Remarks

Ver Aspose.Zip.Xz.XzArchive.Extract(System.IO.Stream) método para la decompresión.

Exceptions

ArgumentException

source’ is not seekable.

ArgumentNullException

source’ is null.

XzArchive(El string)

Inicia una nueva instancia de la clase Aspose.Zip.Xz.XzArchive preparada para la decompresión.

public XzArchive(string path)

Parameters

path string

El camino hacia la fuente del archivo.

Remarks

Ver Aspose.Zip.Xz.XzArchive.Extract(System.IO.Stream) método para la decompresión.

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.

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

Extracta el archivo xz a un flujo.

public void Extract(Stream destination)

Parameters

destination Stream

Flujo para almacenar datos decomprimidos.

Examples

using (FileStream xzFile = File.Open(sourceFileName, FileMode.Open))
{
    using (FileStream extractedFile = File.Open(extractedFileName, FileMode.Create))
    {
        using (var archive = new XzArchive(xzFile))
        {
            archive.Extract(extractedFile);
        }
    }
}

Exceptions

InvalidOperationException

Los títulos de archivo y la información de servicio no fueron leídos.

Extract(FileInfo)

Extracta archivo xz a un archivo.

public void Extract(FileInfo fileInfo)

Parameters

fileInfo FileInfo

FileInfo para almacenar datos decomprimidos.

Examples

using (FileStream xzFile = File.Open(sourceFileName, FileMode.Open))
{
    using (var archive = new XzArchive(xzFile))
    {
        archive.Extract(new FileInfo("extracted.bin"));
    }
}

Exceptions

InvalidOperationException

Los títulos de archivo y la información de servicio no fueron leídos.

SecurityException

El llamador no tiene el permiso necesario para abrir el fileInfo'.

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

fileInfo’ is null.

DirectoryNotFoundException

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

IOException

El archivo ya está abierto.

Extract(El string)

Extrae el archivo xz a un archivo por vía.

public FileInfo Extract(string path)

Parameters

path string

Paseo a archivo que almacenará datos decomprimidos.

Returns

FileInfo

Sistema.IO.FileInfo instancia que contiene datos extraídos.

Examples

using (FileStream xzFile = File.Open(sourceFileName, FileMode.Open))
{
    using (var archive = new XzArchive(xzFile))
    {
        archive.Extract("extracted.bin");
    }
}

Exceptions

InvalidOperationException

Los títulos de archivo y la información de servicio no fueron leídos.

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.

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.

Save(Stream)

Salva el archivo xz a la corriente proporcionada.

public void Save(Stream output)

Parameters

output Stream

El flujo de destino.

Examples

using (FileStream xzFile = File.Open("archive.xz", FileMode.Create))
{
    using (var archive = new XzArchive())
    {
        archive.SetSource("data.bin");
        archive.Save(xzFile);
     }
}

Remarks

debe ser buscable.

Exceptions

ArgumentException

output’ does not support seeking.

ArgumentNullException

output’ is null.

Save(El string)

Salva el archivo xz en el fichero 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 XzArchive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save("result.xz");
}

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.

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 XzArchive())
{
    archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
    archive.Save("archive.xz");
}

Exceptions

ArgumentException

El flujo de la fuente es indesejable.

SetSource(FileInfo)

Coloca el contenido para ser comprimido dentro del archivo.

public void SetSource(FileInfo fileInfo)

Parameters

fileInfo FileInfo

FileInfo, que se abrirá como flujo de entrada.

Examples

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

Exceptions

SecurityException

El llamador no tiene el permiso necesario para abrir el fileInfo'.

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

fileInfo’ is null.

DirectoryNotFoundException

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

IOException

El archivo ya está abierto.

SetSource(El string)

Coloca el contenido para ser comprimido dentro del archivo.

public void SetSource(string sourcePath)

Parameters

sourcePath string

Path to file que se abrirá como flujo de entrada.

Examples

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

Exceptions

ArgumentNullException

sourcePath’ is null.

SecurityException

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

ArgumentException

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

UnauthorizedAccessException

El acceso al archivo sourcePath’ se denega.

PathTooLongException

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

 Español