Class LzipArchive
Namespace: Aspose.Zip.Lzip
Assembly: Aspose.Zip.dll (25.1.0)
Esta classe representa um arquivo de arquivo Lzip. Use-a para compor ou extrair arquivos Lzip.
public class LzipArchive : 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
LzipArchive(LzipArchiveSettings)
Inicializa uma nova instância do Aspose.Zip.Lzip.LzipArchive.
public LzipArchive(LzipArchiveSettings settings = null)
Parâmetros
settings
LzipArchiveSettings
Configuração do arquivo lzip específico com definição do tamanho do dicionário.
LzipArchive(Stream)
Inicializa uma nova instância da classe Aspose.Zip.Lzip.LzipArchive preparada para descompressão.
public LzipArchive(Stream sourceStream)
Parâmetros
sourceStream
Stream
A fonte do arquivo.
Observações
Este construtor não descomprime. Veja o método Aspose.Zip.Lzip.LzipArchive.Extract(System.IO.Stream) para descompressão.
Exceções
sourceStream
não é buscável.
sourceStream
é nulo.
Os cabeçalhos não correspondem ao tipo de arquivo lzip.
LzipArchive(string)
Inicializa uma nova instância da classe Aspose.Zip.Lzip.LzipArchive preparada para descompressão.
public LzipArchive(string path)
Parâmetros
path
string
Caminho para a fonte do arquivo.
Exemplos
using (FileStream extractedFile = File.Open(extractedFileName, FileMode.Create))
{
using (var archive = new LzipArchive(sourceLzipFile))
{
archive.Extract(extractedFile);
}
}
Observações
Este construtor não descomprime. Veja o método Aspose.Zip.Lzip.LzipArchive.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.
Os cabeçalhos não correspondem ao tipo de arquivo lzip.
Propriedades
Settings
Obtém a configuração do arquivo lzip específico.
public LzipArchiveSettings Settings { get; }
Valor da Propriedade
Métodos
Dispose()
Executa tarefas definidas pela aplicação associadas à liberação, liberação ou redefinição de recursos não gerenciados.
public void Dispose()
Dispose(bool)
Executa 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 liberados.
Extract(Stream)
Extrai o arquivo lzip para um fluxo.
public void Extract(Stream destination)
Parâmetros
destination
Stream
Fluxo para armazenar dados descomprimidos.
Exemplos
using (FileStream sourceLzipFile = File.Open(sourceFileName, FileMode.Open))
{
using (FileStream extractedFile = File.Open(extractedFileName, FileMode.Create))
{
using (var archive = new LzipArchive(sourceLzipFile))
{
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 fluxo de destino é nulo.
O fluxo de destino não suporta gravação.
Extract(FileInfo)
Extrai o arquivo lzip para um arquivo.
public void Extract(FileInfo fileInfo)
Parâmetros
fileInfo
FileInfo
FileInfo para armazenar dados descomprimidos.
Exemplos
using (FileStream lzipFile = File.Open(sourceFileName, FileMode.Open))
{
using (var archive = new LzipArchive(lzipFile))
{
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 lzip para um arquivo pelo caminho.
public void Extract(string path)
Parâmetros
path
string
Caminho para o arquivo que armazenará os dados descomprimidos.
Exemplos
using (FileStream lzipFile = File.Open(sourceFileName, FileMode.Open))
{
using (var archive = new LzipArchive(xzFile))
{
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 lzip no fluxo fornecido.
public void Save(Stream outputStream)
Parâmetros
outputStream
Stream
Fluxo de destino.
Exemplos
using (FileStream lzFile = File.Open("archive.lz", FileMode.Create))
{
using (var archive = new LzipArchive())
{
archive.SetSource("data.bin");
archive.Save(lzFile);
}
}
Observações
outputStream
deve ser buscável.
Exceções
outputStream
não suporta busca.
outputStream
é nulo.
Save(string)
Salva o arquivo lzip no arquivo de destino fornecido.
public void Save(string destinationFileName)
Parâmetros
destinationFileName
string
O caminho do arquivo a ser criado. Se o nome do arquivo especificado apontar para um arquivo existente, ele será sobrescrito.
Exemplos
using (var archive = new LzipArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("result.lz");
}
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 um caractere de dois pontos (:) no meio da string.
Save(FileInfo)
Salva o arquivo lzip no arquivo de destino fornecido.
public void Save(FileInfo destination)
Parâmetros
destination
FileInfo
FileInfo que será aberto como fluxo de destino.
Exemplos
using (var archive = new LzipArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save(new FileInfo("archive.lz"));
}
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.
SetSource(Stream)
Define o conteúdo a ser comprimido dentro do arquivo.
public void SetSource(Stream source)
Parâmetros
source
Stream
O fluxo de entrada para o arquivo.
Exemplos
using (var archive = new LzipArchive())
{
archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
archive.Save("archive.lz");
}
Exceções
O source
fluxo 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 fluxo de entrada.
Exemplos
using (var archive = new LzipArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("archive.lz");
}
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 path)
Parâmetros
path
string
Caminho para o arquivo a ser comprimido.
Exemplos
using (var archive = new LzipArchive())
{
archive.SetSource("data.bin");
archive.Save("archive.lz");
}
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.