Class ZstandardArchive
Nombre del espacio: Aspose.Zip.Zstandard Asamblea: Aspose.Zip.dll (25.5.0)
Esta clase representa un archivo Zstandard. Utilice para componer archivos Zstandard.
public class ZstandardArchive : IArchive, IDisposable, IArchiveFileEntryInheritance
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
ZstandardArchive()
Inicia una nueva instancia de la clase Aspose.Zip.Zstandard.ZstandardArchive preparada para la compresión.
public ZstandardArchive()Examples
El siguiente ejemplo muestra cómo comprimir un archivo.
using (ZstandardArchive archive = new ZstandardArchive())
{
archive.SetSource("data.bin");
archive.Save("archive.zst");
}ZstandardArchive(El flujo, ZstandardLoadOptions)
Inicia una nueva instancia de la clase Aspose.Zip.Zstandard.ZstandardArchive preparada para la decompresión.
public ZstandardArchive(Stream sourceStream, ZstandardLoadOptions options = null)Parameters
sourceStream Stream
La fuente del archivo.
options ZstandardLoadOptions
Las opciones para cargar archivos con.
Examples
Abrir un archivo de una corriente y extraerlo a una
var ms = new MemoryStream();
using (GzipArchive archive = new ZstandardArchive(File.OpenRead("archive.zst")))
archive.Open().CopyTo(ms);Remarks
Ver Aspose.Zip.Zstandard.ZstandardArchive.Open método para la decompresión.
ZstandardArchive(Título: ZstandardLoadOptions)
Inicia una nueva instancia de la clase Aspose.Zip.Zstandard.ZstandardArchive.
public ZstandardArchive(string path, ZstandardLoadOptions options = null)Parameters
path string
El camino hacia el archivo.
options ZstandardLoadOptions
Las opciones para cargar archivos con.
Examples
Abrir un archivo de un fichero por vía y extraerlo a una
var ms = new MemoryStream();
using (ZstandardArchive archive = new ZstandardArchive("archive.zst"))
archive.Open().CopyTo(ms);Remarks
Ver Aspose.Zip.Zstandard.ZstandardArchive.Open método para la decompresión.
Exceptions
path’ is null.
El solicitante no tiene la autorización necesaria para acceder.
El path’ es vacío, contiene solo espacios blancos, o contiene caracteres invalidos.
Se denega el acceso al archivo path.
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.
El archivo en path’ contiene una columna (:) en el medio de la línea.
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)
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 GzipArchive("archive.zst"))
{
archive.Extract(httpResponseStream);
}Exceptions
destination’ does not support writing.
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
Información de un archivo extraído.
Exceptions
path’ is null.
El solicitante no tiene la autorización necesaria para acceder.
El path’ es vacío, contiene solo espacios blancos, o contiene caracteres invalidos.
Se denega el acceso al archivo path.
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.
El archivo en path’ contiene una columna (:) en el medio de la línea.
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
destinationDirectory’ is null.
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.
El llamador no tiene el permiso necesario para acceder al directorio existente.
Si el directorio no existe, el camino contiene un carácter colon (:) que no forma parte de una etiqueta de disco (“C:”).
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 (:).
El directorio especificado por ruta es un archivo. -o- El nombre de red no es conocido.
Open()
Abre el archivo para extracción y proporciona un flujo con contenido de archivo.
public Stream Open()Returns
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 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);
}
}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.
Save(El flujo, ZstandardSaveOptions)
Salva archivos a la corriente proporcionada.
public void Save(Stream outputStream, ZstandardSaveOptions settings = null)Parameters
outputStream Stream
El flujo de destino.
settings ZstandardSaveOptions
Configuraciones opcionales para la composición de archivos.
Examples
Escribe los datos comprimidos en el flujo de respuesta de http.
using (var archive = new ZstandardArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save(httpResponse.OutputStream);
}Remarks
Debe ser escrito.
Exceptions
outputStream’ is not writable.
La fuente no ha sido suministrada.
Save(Título: ZstandardSaveOptions)
Salva archivo al archivo de destino proporcionado.
public void Save(string destinationFileName, ZstandardSaveOptions settings = null)Parameters
destinationFileName string
Si el nombre de archivo especificado indica a un archivo existente, se reescribir.
settings ZstandardSaveOptions
Configuraciones opcionales para la composición de archivos.
Examples
using (var archive = new ZstandardArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("result.zst");
}Exceptions
destinationFileName’ is null.
El solicitante no tiene la autorización necesaria para acceder.
El destinationFileName’ es vacío, contiene solo espacios blancos, o contiene caracteres invalidos.
Se denega el acceso al archivo destinationFileName.
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.
El archivo en la destinationFileName’ contiene una columna (:) en el medio de la línea.
Save(Archivo de la etiqueta: ZstandardSaveOptions)
Salva archivo al archivo de destino proporcionado.
public void Save(FileInfo destination, ZstandardSaveOptions settings = null)Parameters
destination FileInfo
FileInfo, que se abrirá como flujo de destino.
settings ZstandardSaveOptions
Configuraciones opcionales para la composición de archivos.
Examples
using (var archive = new ZstandardArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save(new FileInfo("archive.zst"));
}Exceptions
El llamador no tiene el permiso necesario para abrir la destination'.
La ruta de archivo es vacía o contiene solo espacios blancos.
El archivo no se encuentra.
El camino al archivo es leído o es un directorio.
destination’ is null.
La ruta especificada es invalida, como estar en un disco no mapeado.
El archivo ya está abierto.
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 ZstandardArchive())
{
archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
archive.Save("archive.zst");
}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
using (var archive = new ZstandardArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("archive.zst");
}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
using (var archive = new ZstandardArchive())
{
archive.SetSource("data.bin");
archive.Save("archive.zst");
}Exceptions
path’ is null.
El solicitante no tiene la autorización necesaria para acceder.
El path’ es vacío, contiene solo espacios blancos, o contiene caracteres invalidos.
Se denega el acceso al archivo path.
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.
El archivo en path’ contiene una columna (:) en el medio de la línea.
