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
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
source
não é buscável.
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
path
é nulo.
O chamador não tem a permissão necessária para acessar.
O path
está vazio, contém apenas espaços em branco ou contém caracteres inválidos.
Acesso ao arquivo path
foi negado.
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.
O arquivo em path
contém dois pontos (:) no meio da string.
O arquivo não foi encontrado.
O caminho especificado é inválido, como estar em uma unidade não mapeada.
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
Os cabeçalhos do arquivo e as informações de serviço não foram lidas.
Erro nos dados no cabeçalho ou na soma de verificação.
O stream de destino é nulo.
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
Os cabeçalhos do arquivo e as informações de serviço não foram lidas.
O chamador não tem a permissão necessária para abrir o fileInfo
.
O caminho do arquivo está vazio ou contém apenas espaços em branco.
O arquivo não foi encontrado.
O caminho para o arquivo é somente leitura ou é um diretório.
fileInfo
é nulo.
O caminho especificado é inválido, como estar em uma unidade não mapeada.
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
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
Os cabeçalhos do arquivo e as informações de serviço não foram lidas.
path
é nulo.
O chamador não tem a permissão necessária para acessar.
O path
está vazio, contém apenas espaços em branco ou contém caracteres inválidos.
Acesso ao arquivo path
foi negado.
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.
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
destinationDirectory
é nulo.
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.
O chamador não tem a permissão necessária para acessar o diretório existente.
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:").
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 (:).
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
output
não suporta busca.
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
O chamador não tem a permissão necessária para abrir o destination
.
O caminho do arquivo está vazio ou contém apenas espaços em branco.
O arquivo não foi encontrado.
O caminho para o arquivo é somente leitura ou é um diretório.
destination
é nulo.
O caminho especificado é inválido, como estar em uma unidade não mapeada.
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
destinationFileName
é nulo.
O chamador não tem a permissão necessária para acessar.
O destinationFileName
está vazio, contém apenas espaços em branco ou contém caracteres inválidos.
Acesso ao arquivo destinationFileName
foi negado.
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.
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
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
O chamador não tem a permissão necessária para abrir o fileInfo
.
O caminho do arquivo está vazio ou contém apenas espaços em branco.
O arquivo não foi encontrado.
O caminho para o arquivo é somente leitura ou é um diretório.
fileInfo
é nulo.
O caminho especificado é inválido, como estar em uma unidade não mapeada.
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
sourcePath
é nulo.
O chamador não tem a permissão necessária para acessar.
O sourcePath
está vazio, contém apenas espaços em branco ou contém caracteres inválidos.
Acesso ao arquivo sourcePath
foi negado.
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.
O arquivo em sourcePath
contém dois pontos (:) no meio da string.