Class SnappyArchive

Class SnappyArchive

Namespace: Aspose.Zip.Snappy
Assembly: Aspose.Zip.dll (25.1.0)

Esta clase representa un archivo de archivo snappy. Úselo para componer o extraer archivos snappy.

public class SnappyArchive : IArchive, IDisposable, IArchiveFileEntry

Herencia

objectSnappyArchive

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

SnappyArchive()

Inicializa una nueva instancia de la clase Aspose.Zip.Snappy.SnappyArchive preparada para comprimir.

public SnappyArchive()

Ejemplos

El siguiente ejemplo muestra cómo comprimir un archivo.

using (SnappyArchive archive = new SnappyArchive()) 
{
    archive.SetSource("data.bin");
    archive.Save("archive.snapy");
}

SnappyArchive(Stream)

Inicializa una nueva instancia de la clase Aspose.Zip.Snappy.SnappyArchive preparada para descomprimir.

public SnappyArchive(Stream source)

Parámetros

source Stream

La fuente del archivo.

Comentarios

Este constructor no descomprime. Consulte el método Aspose.Zip.Snappy.SnappyArchive.Extract(System.IO.Stream) para descomprimir.

Excepciones

ArgumentException

source no es buscable.

ArgumentNullException

source es nulo.

SnappyArchive(string)

Inicializa una nueva instancia de la clase Aspose.Zip.Snappy.SnappyArchive preparada para descomprimir.

public SnappyArchive(string path)

Parámetros

path string

Ruta a la fuente del archivo.

Ejemplos

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

Comentarios

Este constructor no descomprime. Consulte el método Aspose.Zip.Snappy.SnappyArchive.Extract(System.IO.Stream) para descomprimir.

Excepciones

ArgumentNullException

path es nulo.

SecurityException

El llamador no tiene el permiso requerido para acceder.

ArgumentException

La path está vacía, contiene solo espacios en blanco o contiene caracteres no válidos.

UnauthorizedAccessException

Acceso al archivo path denegado.

PathTooLongException

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.

NotSupportedException

El archivo en path contiene dos puntos (:) en medio de la cadena.

FileNotFoundException

El archivo no se encuentra.

DirectoryNotFoundException

La ruta especificada no es válida, como estar en una unidad no asignada.

IOException

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 snappy a un flujo.

public void Extract(Stream destination)

Parámetros

destination Stream

Flujo para almacenar datos descomprimidos.

Ejemplos

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

Excepciones

InvalidOperationException

Los encabezados del archivo y la información del servicio no fueron leídos.

InvalidDataException

Error en los datos en el encabezado o la suma de verificación.

ArgumentNullException

El flujo de destino es nulo.

ArgumentException

El flujo de destino no admite escritura.

Extract(FileInfo)

Extrae el archivo snappy a un archivo.

public void Extract(FileInfo fileInfo)

Parámetros

fileInfo FileInfo

FileInfo para almacenar datos descomprimidos.

Ejemplos

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

Excepciones

InvalidOperationException

Los encabezados del archivo y la información del servicio no fueron leídos.

SecurityException

El llamador no tiene el permiso requerido para abrir el fileInfo.

ArgumentException

La ruta del archivo está vacía o contiene solo espacios en blanco.

FileNotFoundException

El archivo no se encuentra.

UnauthorizedAccessException

La ruta al archivo es de solo lectura o es un directorio.

ArgumentNullException

fileInfo es nulo.

DirectoryNotFoundException

La ruta especificada no es válida, como estar en una unidad no asignada.

IOException

El archivo ya está abierto.

Extract(string)

Extrae el archivo snappy a un archivo por ruta.

public FileInfo Extract(string path)

Parámetros

path string

Ruta al archivo que almacenará los datos descomprimidos.

Retorna

FileInfo

Instancia de System.IO.FileInfo que contiene los datos extraídos.

Ejemplos

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

Excepciones

InvalidOperationException

Los encabezados del archivo y la información del servicio no fueron leídos.

ArgumentNullException

path es nulo.

SecurityException

El llamador no tiene el permiso requerido para acceder.

ArgumentException

La path está vacía, contiene solo espacios en blanco o contiene caracteres no válidos.

UnauthorizedAccessException

Acceso al archivo path denegado.

PathTooLongException

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.

NotSupportedException

El archivo en path contiene dos puntos (:) en medio de la cadena.

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

ArgumentNullException

destinationDirectory es nulo.

PathTooLongException

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.

SecurityException

El llamador no tiene el permiso requerido para acceder al directorio existente.

NotSupportedException

Si el directorio no existe, la ruta contiene un carácter de dos puntos (:) que no es parte de una etiqueta de unidad (“C:").

ArgumentException

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 (:).

IOException

El directorio especificado por la ruta es un archivo. -o- El nombre de la red no es conocido.

Save(Stream)

Guarda el archivo snappy en el flujo proporcionado.

public void Save(Stream output)

Parámetros

output Stream

Flujo de destino.

Ejemplos

using (FileStream snappyFile = File.Open("archive.snappy", FileMode.Create))
{
    using (var archive = new SnappyArchive())
    {
        archive.SetSource("data.bin");
        archive.Save(snappyFile);
     }
}

Comentarios

output debe ser buscable.

Excepciones

ArgumentException

output no admite búsqueda.

ArgumentNullException

output es nulo.

Save(FileInfo)

Guarda el archivo snappy en el archivo de destino proporcionado.

public void Save(FileInfo destination)

Parámetros

destination FileInfo

FileInfo que se abrirá como flujo de destino.

Ejemplos

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

Excepciones

SecurityException

El llamador no tiene el permiso requerido para abrir el destination.

ArgumentException

La ruta del archivo está vacía o contiene solo espacios en blanco.

FileNotFoundException

El archivo no se encuentra.

UnauthorizedAccessException

La ruta al archivo es de solo lectura o es un directorio.

ArgumentNullException

destination es nulo.

DirectoryNotFoundException

La ruta especificada no es válida, como estar en una unidad no asignada.

IOException

El archivo ya está abierto.

Save(string)

Guarda el archivo snappy 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 SnappyArchive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save("result.snappy");
}

Excepciones

ArgumentNullException

destinationFileName es nulo.

SecurityException

El llamador no tiene el permiso requerido para acceder.

ArgumentException

La destinationFileName está vacía, contiene solo espacios en blanco o contiene caracteres no válidos.

UnauthorizedAccessException

Acceso al archivo destinationFileName denegado.

PathTooLongException

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.

NotSupportedException

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

Excepciones

ArgumentException

El flujo source es no 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 SnappyArchive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save("archive.snappy");
}

Excepciones

SecurityException

El llamador no tiene el permiso requerido para abrir el fileInfo.

ArgumentException

La ruta del archivo está vacía o contiene solo espacios en blanco.

FileNotFoundException

El archivo no se encuentra.

UnauthorizedAccessException

La ruta al archivo es de solo lectura o es un directorio.

ArgumentNullException

fileInfo es nulo.

DirectoryNotFoundException

La ruta especificada no es válida, como estar en una unidad no asignada.

IOException

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 SnappyArchive()) 
{
    archive.SetSource("data.bin");
    archive.Save("archive.snappy");
}

Excepciones

ArgumentNullException

sourcePath es nulo.

SecurityException

El llamador no tiene el permiso requerido para acceder.

ArgumentException

La sourcePath está vacía, contiene solo espacios en blanco o contiene caracteres no válidos.

UnauthorizedAccessException

Acceso al archivo sourcePath denegado.

PathTooLongException

La sourcePath, 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.

NotSupportedException

El archivo en sourcePath contiene dos puntos (:) en medio de la cadena.

 Español