Class ZArchive
Namespace: Aspose.Zip.Z
Assembly: Aspose.Zip.dll (25.1.0)
Esta clase representa un archivo de archivo Z (compresión). Úselo para componer o extraer archivos Z.
public class ZArchive : IArchive, IDisposable, IArchiveFileEntryHerencia
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()
Comentarios
Consulte https://docs.fileformat.com/compression/z/
Constructores
ZArchive()
Inicializa una nueva instancia de la clase Aspose.Zip.Z.ZArchive preparada para la compresión.
public ZArchive()ZArchive(Stream, ZArchiveLoadOptions)
Inicializa una nueva instancia de la clase Aspose.Zip.Z.ZArchive preparada para la descompresión.
public ZArchive(Stream source, ZArchiveLoadOptions loadOptions = null)Parámetros
source Stream
La fuente del archivo.
loadOptions ZArchiveLoadOptions
Las opciones para cargar el archivo.
Comentarios
Este constructor no descomprime. Consulte el método Aspose.Zip.Z.ZArchive.Extract(System.IO.Stream) para la descompresión.
Excepciones
source no es buscable.
source es nulo.
ZArchive(string, ZArchiveLoadOptions)
Inicializa una nueva instancia de la clase Aspose.Zip.Z.ZArchive preparada para la descompresión.
public ZArchive(string path, ZArchiveLoadOptions loadOptions = null)Parámetros
path string
Ruta a la fuente del archivo.
loadOptions ZArchiveLoadOptions
Las opciones para cargar el archivo.
Comentarios
Este constructor no descomprime. Consulte el método Aspose.Zip.Z.ZArchive.Extract(System.IO.Stream) para la descompresión.
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.
La path, el nombre de archivo o ambos exceden 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 liberar, liberar o restablecer recursos no administrados.
public void Dispose()Dispose(bool)
Realiza tareas definidas por la aplicación asociadas con liberar, liberar o restablecer 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 Z a un flujo.
public void Extract(Stream destination)Parámetros
destination Stream
Flujo para almacenar los datos descomprimidos.
Ejemplos
using (FileStream zFile = File.Open(sourceFileName, FileMode.Open))
{
using (FileStream extractedFile = File.Open(extractedFileName, FileMode.Create))
{
using (var archive = new ZArchive(zFile))
{
archive.Extract(extractedFile);
}
}
}Excepciones
Los datos no pueden ser descomprimidos.
Extract(FileInfo)
Extrae el archivo Z a un archivo.
public void Extract(FileInfo fileInfo)Parámetros
fileInfo FileInfo
FileInfo para almacenar los datos descomprimidos.
Ejemplos
using (FileStream zFile = File.Open(sourceFileName, FileMode.Open))
{
using (var archive = new ZArchive(zFile))
{
archive.Extract(new FileInfo("extracted.bin"));
}
}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.
Los datos no pueden ser descomprimidos.
Extract(string)
Extrae el archivo Z a un archivo por ruta.
public FileInfo Extract(string path)Parámetros
path string
Ruta al archivo que almacenará los datos descomprimidos.
Retorna
Información del archivo extraído.
Ejemplos
using (FileStream zFile = File.Open(sourceFileName, FileMode.Open))
{
using (var archive = new ZArchive(zFile))
{
archive.Extract("extracted.bin");
}
}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.
La path, el nombre de archivo, o ambos exceden 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.
Los datos no pueden ser descomprimidos.
ExtractToDirectory(string)
Extrae el contenido del archivo al 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.
La ruta especificada, el nombre de archivo, o ambos exceden 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 red no es conocido.
Save(Stream, ZArchiveSaveOptions)
Guarda el archivo xz en el flujo proporcionado.
public void Save(Stream output, ZArchiveSaveOptions settings = null)Parámetros
output Stream
Flujo de destino.
settings ZArchiveSaveOptions
Opciones opcionales para la composición del archivo.
Ejemplos
using (FileStream zFile = File.Open("data.bin.z", FileMode.Create))
{
using (var archive = new ZArchive())
{
archive.SetSource("data.bin");
archive.Save(zFile);
}
}Comentarios
output debe ser buscable.
Excepciones
output no admite la búsqueda.
output es nulo.
Save(string, ZArchiveSaveOptions)
Guarda el archivo Z en el archivo de destino proporcionado.
public void Save(string destinationFileName, ZArchiveSaveOptions settings = null)Parámetros
destinationFileName string
+La ruta del archivo a crear. Si el nombre de archivo especificado apunta a un archivo existente, se sobrescribirá.
settings ZArchiveSaveOptions
Opciones opcionales para la composición del archivo.
Ejemplos
using (var archive = new ZArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("data.bin.Z");
}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.
La destinationFileName, el nombre de archivo, o ambos exceden 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 ZArchive())
{
archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
archive.Save("archive.Z");
}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 ZArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("data.bin.Z");
}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 ZArchive())
{
archive.SetSource("data.bin");
archive.Save("data.bin.Z");
}Excepciones
sourcePath es nulo o una cadena vacía.
El llamador no tiene el permiso requerido para acceder a un recurso.
El sourcePath está vacío, contiene solo espacios en blanco o contiene caracteres no válidos.
El acceso al archivo sourcePath está denegado.
La sourcePath, el nombre de archivo, o ambos exceden 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.
