Class XzArchive
Namespace: Aspose.Zip.Xz
Assembly: Aspose.Zip.dll (25.1.0)
Esta clase representa un archivo de archivo xz. Úselo para componer y extraer archivos xz.
public class XzArchive : IArchive, IDisposable, IArchiveFileEntry
Herencia
Implementa
IArchive, IDisposable, IArchiveFileEntry
Miembros heredados
object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()
Constructores
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)
Parámetros
settings
XzArchiveSettings
Conjunto de configuraciones particulares del archivo xz: tamaño del diccionario, tamaño del bloque, tipo de verificación.
XzArchive(Stream)
Inicializa una nueva instancia de la clase Aspose.Zip.Xz.XzArchive preparada para descomprimir.
public XzArchive(Stream source)
Parámetros
source
Stream
La fuente del archivo.
Comentarios
Este constructor no descomprime. Consulte el método Aspose.Zip.Xz.XzArchive.Extract(System.IO.Stream) para descomprimir.
Excepciones
source
no es buscable.
source
es nulo.
XzArchive(string)
Inicializa una nueva instancia de la clase Aspose.Zip.Xz.XzArchive preparada para descomprimir.
public XzArchive(string path)
Parámetros
path
string
Ruta a la fuente del archivo.
Comentarios
Este constructor no descomprime. Consulte el método Aspose.Zip.Xz.XzArchive.Extract(System.IO.Stream) para descomprimir.
Excepciones
path
es nulo.
El llamador no tiene el permiso requerido para acceder.
El path
está vacío, contiene solo espacios en blanco o contiene caracteres no válidos.
El acceso al archivo path
está denegado.
El path
, el nombre del archivo o ambos superan la longitud máxima definida por el sistema. Por ejemplo, en plataformas basadas en Windows, las rutas deben tener menos de 248 caracteres y los nombres de archivo deben tener menos de 260 caracteres.
El archivo en path
contiene dos puntos (:) en medio de la cadena.
El archivo no se encuentra.
La ruta especificada no es válida, como estar en una unidad no asignada.
El archivo ya está abierto.
Métodos
Dispose()
Realiza tareas definidas por la aplicación asociadas con la liberación, liberación o reinicio de recursos no administrados.
public void Dispose()
Dispose(bool)
Realiza tareas definidas por la aplicación asociadas con la liberación, liberación o reinicio de recursos no administrados.
protected virtual void Dispose(bool disposing)
Parámetros
disposing
bool
Si los recursos administrados deben ser liberados.
Extract(Stream)
Extrae el archivo xz a un flujo.
public void Extract(Stream destination)
Parámetros
destination
Stream
Flujo para almacenar datos descomprimidos.
Ejemplos
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);
}
}
}
Excepciones
Los encabezados del archivo y la información del servicio no se leyeron.
Extract(FileInfo)
Extrae el archivo xz a un archivo.
public void Extract(FileInfo fileInfo)
Parámetros
fileInfo
FileInfo
FileInfo para almacenar datos descomprimidos.
Ejemplos
using (FileStream xzFile = File.Open(sourceFileName, FileMode.Open))
{
using (var archive = new XzArchive(xzFile))
{
archive.Extract(new FileInfo("extracted.bin"));
}
}
Excepciones
Los encabezados del archivo y la información del servicio no se leyeron.
El llamador no tiene el permiso requerido para abrir el fileInfo
.
La ruta del archivo está vacía o contiene solo espacios en blanco.
El archivo no se encuentra.
La ruta al archivo es de solo lectura o es un directorio.
fileInfo
es nulo.
La ruta especificada no es válida, como estar en una unidad no asignada.
El archivo ya está abierto.
Extract(string)
Extrae el archivo xz a un archivo por ruta.
public FileInfo Extract(string path)
Parámetros
path
string
Ruta al archivo que almacenará datos descomprimidos.
Retorna
Instancia de System.IO.FileInfo que contiene los datos extraídos.
Ejemplos
using (FileStream xzFile = File.Open(sourceFileName, FileMode.Open))
{
using (var archive = new XzArchive(xzFile))
{
archive.Extract("extracted.bin");
}
}
Excepciones
Los encabezados del archivo y la información del servicio no se leyeron.
path
es nulo.
El llamador no tiene el permiso requerido para acceder.
El path
está vacío, contiene solo espacios en blanco o contiene caracteres no válidos.
El acceso al archivo path
está denegado.
El path
, el nombre del archivo o ambos superan la longitud máxima definida por el sistema. Por ejemplo, en plataformas basadas en Windows, las rutas deben tener menos de 248 caracteres y los nombres de archivo deben tener menos de 260 caracteres.
El archivo en path
contiene dos puntos (:) en medio de la cadena.
El archivo no se encuentra.
La ruta especificada no es válida, como estar en una unidad no asignada.
El archivo ya está abierto.
ExtractToDirectory(string)
Extrae el contenido del archivo en el directorio proporcionado.
public void ExtractToDirectory(string destinationDirectory)
Parámetros
destinationDirectory
string
La ruta al directorio donde se colocarán los archivos extraídos.
Comentarios
Si el directorio no existe, se creará.
Excepciones
destinationDirectory
es nulo.
El path
, el nombre del archivo o ambos superan la longitud máxima definida por el sistema. Por ejemplo, en plataformas basadas en Windows, las rutas deben tener menos de 248 caracteres y los nombres de archivo deben tener menos de 260 caracteres.
El llamador no tiene el permiso requerido para acceder al directorio existente.
Si el directorio no existe, la ruta contiene un carácter de dos puntos (:) que no es parte de una etiqueta de unidad (“C:").
destinationDirectory
es una cadena de longitud cero, contiene solo espacios en blanco o contiene uno o más caracteres no válidos. Puede consultar los caracteres no válidos utilizando el método System.IO.Path.GetInvalidPathChars.
-o- la ruta está precedida por, o contiene, solo un carácter de dos puntos (:).
El directorio especificado por la ruta es un archivo. -o- El nombre de la red no es conocido.
Save(Stream)
Guarda el archivo xz en el flujo proporcionado.
public void Save(Stream output)
Parámetros
output
Stream
Flujo de destino.
Ejemplos
using (FileStream xzFile = File.Open("archive.xz", FileMode.Create))
{
using (var archive = new XzArchive())
{
archive.SetSource("data.bin");
archive.Save(xzFile);
}
}
Comentarios
output
debe ser buscable.
Excepciones
output
no admite búsqueda.
output
es nulo.
Save(string)
Guarda el archivo xz en el archivo de destino proporcionado.
public void Save(string destinationFileName)
Parámetros
destinationFileName
string
La ruta del archivo que se creará. Si el nombre de archivo especificado apunta a un archivo existente, se sobrescribirá.
Ejemplos
using (var archive = new XzArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("result.xz");
}
Excepciones
destinationFileName
es nulo.
El llamador no tiene el permiso requerido para acceder.
El destinationFileName
está vacío, contiene solo espacios en blanco o contiene caracteres no válidos.
El acceso al archivo destinationFileName
está denegado.
El destinationFileName
, el nombre del archivo o ambos superan la longitud máxima definida por el sistema. Por ejemplo, en plataformas basadas en Windows, las rutas deben tener menos de 248 caracteres y los nombres de archivo deben tener menos de 260 caracteres.
El archivo en destinationFileName
contiene dos puntos (:) en medio de la cadena.
SetSource(Stream)
Establece el contenido que se comprimirá dentro del archivo.
public void SetSource(Stream source)
Parámetros
source
Stream
El flujo de entrada para el archivo.
Ejemplos
using (var archive = new XzArchive())
{
archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
archive.Save("archive.xz");
}
Excepciones
El source
stream no es buscable.
SetSource(FileInfo)
Establece el contenido que se comprimirá dentro del archivo.
public void SetSource(FileInfo fileInfo)
Parámetros
fileInfo
FileInfo
FileInfo que se abrirá como flujo de entrada.
Ejemplos
using (var archive = new XzArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("archive.xz");
}
Excepciones
El llamador no tiene el permiso requerido para abrir el fileInfo
.
La ruta del archivo está vacía o contiene solo espacios en blanco.
El archivo no se encuentra.
La ruta al archivo es de solo lectura o es un directorio.
fileInfo
es nulo.
La ruta especificada no es válida, como estar en una unidad no asignada.
El archivo ya está abierto.
SetSource(string)
Establece el contenido que se comprimirá dentro del archivo.
public void SetSource(string sourcePath)
Parámetros
sourcePath
string
Ruta al archivo que se abrirá como flujo de entrada.
Ejemplos
using (var archive = new XzArchive())
{
archive.SetSource("data.bin");
archive.Save("archive.xz");
}
Excepciones
sourcePath
es nulo.
El llamador no tiene el permiso requerido para acceder.
El sourcePath
está vacío, contiene solo espacios en blanco o contiene caracteres no válidos.
El acceso al archivo sourcePath
está denegado.
El sourcePath
, el nombre del archivo o ambos superan la longitud máxima definida por el sistema. Por ejemplo, en plataformas basadas en Windows, las rutas deben tener menos de 248 caracteres y los nombres de archivo deben tener menos de 260 caracteres.
El archivo en sourcePath
contiene dos puntos (:) en medio de la cadena.