Class ZstandardArchive
Namespace: Aspose.Zip.Zstandard
Assembly: Aspose.Zip.dll (25.1.0)
Esta clase representa un archivo de archivo Zstandard. Úselo para componer archivos Zstandard.
public class ZstandardArchive : 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()
Constructores
ZstandardArchive()
Inicializa una nueva instancia de la clase Aspose.Zip.Zstandard.ZstandardArchive preparada para comprimir.
public ZstandardArchive()Ejemplos
El siguiente ejemplo muestra cómo comprimir un archivo.
using (ZstandardArchive archive = new ZstandardArchive())
{
archive.SetSource("data.bin");
archive.Save("archive.zst");
}ZstandardArchive(Stream, ZstandardLoadOptions)
Inicializa una nueva instancia de la clase Aspose.Zip.Zstandard.ZstandardArchive preparada para descomprimir.
public ZstandardArchive(Stream sourceStream, ZstandardLoadOptions options = null)Parámetros
sourceStream Stream
La fuente del archivo comprimido.
options ZstandardLoadOptions
Las opciones para cargar el archivo comprimido.
Ejemplos
Abre un archivo comprimido desde un flujo y lo extrae a un MemoryStream
var ms = new MemoryStream();
using (GzipArchive archive = new ZstandardArchive(File.OpenRead("archive.zst")))
archive.Open().CopyTo(ms);Observaciones
Este constructor no descomprime. Consulte el método Aspose.Zip.Zstandard.ZstandardArchive.Open para descomprimir.
ZstandardArchive(string, ZstandardLoadOptions)
Inicializa una nueva instancia de la clase Aspose.Zip.Zstandard.ZstandardArchive.
public ZstandardArchive(string path, ZstandardLoadOptions options = null)Parámetros
path string
La ruta al archivo comprimido.
options ZstandardLoadOptions
Las opciones para cargar el archivo comprimido.
Ejemplos
Abre un archivo comprimido desde la ruta y lo extrae a un MemoryStream
var ms = new MemoryStream();
using (ZstandardArchive archive = new ZstandardArchive("archive.zst"))
archive.Open().CopyTo(ms);Observaciones
Este constructor no descomprime. Consulte el método Aspose.Zip.Zstandard.ZstandardArchive.Open 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.
La path, el nombre del 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.
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 comprimido al flujo proporcionado.
public void Extract(Stream destination)Parámetros
destination Stream
Flujo de destino. Debe ser escribible.
Ejemplos
using (var archive = new GzipArchive("archive.zst"))
{
archive.Extract(httpResponseStream);
}Excepciones
destination no admite escritura.
Extract(string)
Extrae el archivo comprimido al archivo por la ruta.
public FileInfo Extract(string path)Parámetros
path string
La ruta al archivo de destino. Si el archivo ya existe, será sobrescrito.
Devuelve
Información del archivo extraído.
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 del 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.
ExtractToDirectory(string)
Extrae el contenido del archivo comprimido al directorio proporcionado.
public void ExtractToDirectory(string destinationDirectory)Parámetros
destinationDirectory string
La ruta al directorio donde se colocarán los archivos extraídos.
Observaciones
Si el directorio no existe, será creado.
Excepciones
destinationDirectory es nulo.
La ruta especificada, el nombre del 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.
Open()
Abre el archivo comprimido para extracción y proporciona un flujo con el contenido del archivo comprimido.
public Stream Open()Devuelve
El flujo que representa el contenido del archivo comprimido.
Ejemplos
Extrae el archivo comprimido y copia el contenido extraído al flujo de archivo.
using (var archive = new ZstandardArchive("archive.zst"))
{
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);
}
}Puede usar el método Stream.CopyTo para .NET 4.0 y superior: `unpacked.CopyTo(extracted);`
Observaciones
Lea del flujo para obtener el contenido original del archivo. Consulte la sección de ejemplos.
Save(Stream, ZstandardSaveOptions)
Guarda el archivo comprimido en el flujo proporcionado.
public void Save(Stream outputStream, ZstandardSaveOptions settings = null)Parámetros
outputStream Stream
Flujo de destino.
settings ZstandardSaveOptions
Configuraciones opcionales para la composición del archivo comprimido.
Ejemplos
Escribe datos comprimidos en el flujo de respuesta http.
using (var archive = new ZstandardArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save(httpResponse.OutputStream);
}Observaciones
outputStream debe ser escribible.
Excepciones
outputStream no es escribible.
No se ha proporcionado la fuente.
Save(string, ZstandardSaveOptions)
Guarda el archivo comprimido en el archivo de destino proporcionado.
public void Save(string destinationFileName, ZstandardSaveOptions settings = null)Parámetros
destinationFileName string
La ruta del archivo comprimido que se va a crear. Si el nombre de archivo especificado apunta a un archivo existente, será sobrescrito.
settings ZstandardSaveOptions
Configuraciones opcionales para la composición del archivo comprimido.
Ejemplos
using (var archive = new ZstandardArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("result.zst");
}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 del 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 un colon (:) en medio de la cadena.
Save(FileInfo, ZstandardSaveOptions)
Guarda el archivo comprimido en el archivo de destino proporcionado.
public void Save(FileInfo destination, ZstandardSaveOptions settings = null)Parámetros
destination FileInfo
FileInfo que se abrirá como flujo de destino.
settings ZstandardSaveOptions
Configuraciones opcionales para la composición del archivo comprimido.
Ejemplos
using (var archive = new ZstandardArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save(new FileInfo("archive.zst"));
}Excepciones
El llamador no tiene el permiso requerido para abrir el destination.
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.
destination es nulo.
La ruta especificada no es válida, como estar en una unidad no asignada.
El archivo ya está abierto.
SetSource(Stream)
Establece el contenido que se va a comprimir dentro del archivo comprimido.
public void SetSource(Stream source)Parámetros
source Stream
El flujo de entrada para el archivo comprimido.
Ejemplos
using (var archive = new ZstandardArchive())
{
archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
archive.Save("archive.zst");
}SetSource(FileInfo)
Establece el contenido que se va a comprimir dentro del archivo comprimido.
public void SetSource(FileInfo fileInfo)Parámetros
fileInfo FileInfo
La referencia a un archivo que se va a comprimir.
Ejemplos
using (var archive = new ZstandardArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("archive.zst");
}SetSource(string)
Establece el contenido que se va a comprimir dentro del archivo comprimido.
public void SetSource(string path)Parámetros
path string
Ruta al archivo que se va a comprimir.
Ejemplos
using (var archive = new ZstandardArchive())
{
archive.SetSource("data.bin");
archive.Save("archive.zst");
}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 del 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 un colon (:) en medio de la cadena.
