Class SnappyArchive

Class SnappyArchive

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

Esta classe representa um arquivo de arquivo snappy. Use-a para compor ou extrair arquivos snappy.

public class SnappyArchive : IArchive, IDisposable, IArchiveFileEntry

Herança

objectSnappyArchive

Implementa

IArchive, IDisposable, IArchiveFileEntry

Membros Herdados

object.GetType(), object.MemberwiseClone(), object.ToString(), object.Equals(object?), object.Equals(object?, object?), object.ReferenceEquals(object?, object?), object.GetHashCode()

Construtores

SnappyArchive()

Inicializa uma nova instância da classe Aspose.Zip.Snappy.SnappyArchive preparada para compressão.

public SnappyArchive()

Exemplos

O exemplo a seguir mostra como comprimir um arquivo.

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

SnappyArchive(Stream)

Inicializa uma nova instância da classe Aspose.Zip.Snappy.SnappyArchive preparada para descompressão.

public SnappyArchive(Stream source)

Parâmetros

source Stream

A origem do arquivo.

Observações

Este construtor não descomprime. Veja o método Aspose.Zip.Snappy.SnappyArchive.Extract(System.IO.Stream) para descompressão.

Exceções

ArgumentException

source não é buscável.

ArgumentNullException

source é nulo.

SnappyArchive(string)

Inicializa uma nova instância da classe Aspose.Zip.Snappy.SnappyArchive preparada para descompressão.

public SnappyArchive(string path)

Parâmetros

path string

Caminho para a origem do arquivo.

Exemplos

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

Observações

Este construtor não descomprime. Veja o método Aspose.Zip.Snappy.SnappyArchive.Extract(System.IO.Stream) para descompressão.

Exceções

ArgumentNullException

path é nulo.

SecurityException

O chamador não tem a permissão necessária para acessar.

ArgumentException

O path está vazio, contém apenas espaços em branco ou contém caracteres inválidos.

UnauthorizedAccessException

Acesso ao arquivo path foi negado.

PathTooLongException

O path, nome do arquivo ou ambos excedem o comprimento máximo definido pelo sistema. Por exemplo, em plataformas baseadas em Windows, os caminhos devem ter menos de 248 caracteres, e os nomes de arquivos devem ter menos de 260 caracteres.

NotSupportedException

O arquivo em path contém dois pontos (:) no meio da string.

FileNotFoundException

O arquivo não foi encontrado.

DirectoryNotFoundException

O caminho especificado é inválido, como estar em uma unidade não mapeada.

IOException

O arquivo já está aberto.

Métodos

Dispose()

Realiza tarefas definidas pela aplicação associadas à liberação, liberação ou redefinição de recursos não gerenciados.

public void Dispose()

Dispose(bool)

Realiza tarefas definidas pela aplicação associadas à liberação, liberação ou redefinição de recursos não gerenciados.

protected virtual void Dispose(bool disposing)

Parâmetros

disposing bool

Se os recursos gerenciados devem ser descartados.

Extract(Stream)

Extrai o arquivo snappy para um stream.

public void Extract(Stream destination)

Parâmetros

destination Stream

Stream para armazenar dados descompactados.

Exemplos

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);
       }
   }
}

Exceções

InvalidOperationException

Os cabeçalhos do arquivo e as informações de serviço não foram lidas.

InvalidDataException

Erro nos dados no cabeçalho ou na soma de verificação.

ArgumentNullException

O stream de destino é nulo.

ArgumentException

O stream de destino não suporta gravação.

Extract(FileInfo)

Extrai o arquivo snappy para um arquivo.

public void Extract(FileInfo fileInfo)

Parâmetros

fileInfo FileInfo

FileInfo para armazenar dados descompactados.

Exemplos

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

Exceções

InvalidOperationException

Os cabeçalhos do arquivo e as informações de serviço não foram lidas.

SecurityException

O chamador não tem a permissão necessária para abrir o fileInfo.

ArgumentException

O caminho do arquivo está vazio ou contém apenas espaços em branco.

FileNotFoundException

O arquivo não foi encontrado.

UnauthorizedAccessException

O caminho para o arquivo é somente leitura ou é um diretório.

ArgumentNullException

fileInfo é nulo.

DirectoryNotFoundException

O caminho especificado é inválido, como estar em uma unidade não mapeada.

IOException

O arquivo já está aberto.

Extract(string)

Extrai o arquivo snappy para um arquivo pelo caminho.

public FileInfo Extract(string path)

Parâmetros

path string

Caminho para o arquivo que armazenará os dados descompactados.

Retorna

FileInfo

Instância System.IO.FileInfo contendo os dados extraídos.

Exemplos

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

Exceções

InvalidOperationException

Os cabeçalhos do arquivo e as informações de serviço não foram lidas.

ArgumentNullException

path é nulo.

SecurityException

O chamador não tem a permissão necessária para acessar.

ArgumentException

O path está vazio, contém apenas espaços em branco ou contém caracteres inválidos.

UnauthorizedAccessException

Acesso ao arquivo path foi negado.

PathTooLongException

O path, nome do arquivo, ou ambos excedem o comprimento máximo definido pelo sistema. Por exemplo, em plataformas baseadas em Windows, os caminhos devem ter menos de 248 caracteres, e os nomes de arquivos devem ter menos de 260 caracteres.

NotSupportedException

O arquivo em path contém dois pontos (:) no meio da string.

ExtractToDirectory(string)

Extrai o conteúdo do arquivo para o diretório fornecido.

public void ExtractToDirectory(string destinationDirectory)

Parâmetros

destinationDirectory string

O caminho para o diretório onde os arquivos extraídos serão colocados.

Observações

Se o diretório não existir, ele será criado.

Exceções

ArgumentNullException

destinationDirectory é nulo.

PathTooLongException

O caminho especificado, nome do arquivo, ou ambos excedem o comprimento máximo definido pelo sistema. Por exemplo, em plataformas baseadas em Windows, os caminhos devem ter menos de 248 caracteres e os nomes de arquivos devem ter menos de 260 caracteres.

SecurityException

O chamador não tem a permissão necessária para acessar o diretório existente.

NotSupportedException

Se o diretório não existir, o caminho contém um caractere de dois pontos (:) que não faz parte de um rótulo de unidade (“C:").

ArgumentException

destinationDirectory é uma string de comprimento zero, contém apenas espaços em branco ou contém um ou mais caracteres inválidos. Você pode consultar caracteres inválidos usando o método System.IO.Path.GetInvalidPathChars. -ou- o caminho é prefixado com, ou contém, apenas um caractere de dois pontos (:).

IOException

O diretório especificado pelo caminho é um arquivo. -ou- O nome da rede não é conhecido.

Save(Stream)

Salva o arquivo snappy no stream fornecido.

public void Save(Stream output)

Parâmetros

output Stream

Stream de destino.

Exemplos

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

Observações

output deve ser buscável.

Exceções

ArgumentException

output não suporta busca.

ArgumentNullException

output é nulo.

Save(FileInfo)

Salva o arquivo snappy no arquivo de destino fornecido.

public void Save(FileInfo destination)

Parâmetros

destination FileInfo

FileInfo que será aberto como stream de destino.

Exemplos

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

Exceções

SecurityException

O chamador não tem a permissão necessária para abrir o destination.

ArgumentException

O caminho do arquivo está vazio ou contém apenas espaços em branco.

FileNotFoundException

O arquivo não foi encontrado.

UnauthorizedAccessException

O caminho para o arquivo é somente leitura ou é um diretório.

ArgumentNullException

destination é nulo.

DirectoryNotFoundException

O caminho especificado é inválido, como estar em uma unidade não mapeada.

IOException

O arquivo já está aberto.

Save(string)

Salva o arquivo snappy no arquivo de destino fornecido.

public void Save(string destinationFileName)

Parâmetros

destinationFileName string

O caminho do arquivo do arquivo a ser criado. Se o nome do arquivo especificado aponta para um arquivo existente, ele será sobrescrito.

Exemplos

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

Exceções

ArgumentNullException

destinationFileName é nulo.

SecurityException

O chamador não tem a permissão necessária para acessar.

ArgumentException

O destinationFileName está vazio, contém apenas espaços em branco ou contém caracteres inválidos.

UnauthorizedAccessException

Acesso ao arquivo destinationFileName foi negado.

PathTooLongException

O destinationFileName, nome do arquivo, ou ambos excedem o comprimento máximo definido pelo sistema. Por exemplo, em plataformas baseadas em Windows, os caminhos devem ter menos de 248 caracteres, e os nomes de arquivos devem ter menos de 260 caracteres.

NotSupportedException

O arquivo em destinationFileName contém dois pontos (:) no meio da string.

SetSource(Stream)

Define o conteúdo a ser comprimido dentro do arquivo.

public void SetSource(Stream source)

Parâmetros

source Stream

O stream de entrada para o arquivo.

Exemplos

using (var archive = new SnappyArchive())
{
    archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
    archive.Save("archive.snappy");
}

Exceções

ArgumentException

O source stream não é buscável.

SetSource(FileInfo)

Define o conteúdo a ser comprimido dentro do arquivo.

public void SetSource(FileInfo fileInfo)

Parâmetros

fileInfo FileInfo

FileInfo que será aberto como stream de entrada.

Exemplos

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

Exceções

SecurityException

O chamador não tem a permissão necessária para abrir o fileInfo.

ArgumentException

O caminho do arquivo está vazio ou contém apenas espaços em branco.

FileNotFoundException

O arquivo não foi encontrado.

UnauthorizedAccessException

O caminho para o arquivo é somente leitura ou é um diretório.

ArgumentNullException

fileInfo é nulo.

DirectoryNotFoundException

O caminho especificado é inválido, como estar em uma unidade não mapeada.

IOException

O arquivo já está aberto.

SetSource(string)

Define o conteúdo a ser comprimido dentro do arquivo.

public void SetSource(string sourcePath)

Parâmetros

sourcePath string

Caminho para o arquivo que será aberto como stream de entrada.

Exemplos

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

Exceções

ArgumentNullException

sourcePath é nulo.

SecurityException

O chamador não tem a permissão necessária para acessar.

ArgumentException

O sourcePath está vazio, contém apenas espaços em branco ou contém caracteres inválidos.

UnauthorizedAccessException

Acesso ao arquivo sourcePath foi negado.

PathTooLongException

O sourcePath, nome do arquivo, ou ambos excedem o comprimento máximo definido pelo sistema. Por exemplo, em plataformas baseadas em Windows, os caminhos devem ter menos de 248 caracteres, e os nomes de arquivos devem ter menos de 260 caracteres.

NotSupportedException

O arquivo em sourcePath contém dois pontos (:) no meio da string.

 Português