Class LzmaArchive
Namespace: Aspose.Zip.LZMA
Assembly: Aspose.Zip.dll (25.1.0)
Esta classe representa um arquivo de arquivo LZMA. Use-a para compor ou extrair arquivos LZMA.
public class LzmaArchive : 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
LzmaArchive(LzmaArchiveSettings)
Inicializa uma nova instância da classe Aspose.Zip.LZMA.LzmaArchive e compõe o arquivo no formato lzma.
public LzmaArchive(LzmaArchiveSettings settings = null)
Parâmetros
settings
LzmaArchiveSettings
Conjunto de configurações específicas do arquivo lzma.
LzmaArchive(Stream)
Inicializa uma nova instância da classe Aspose.Zip.LZMA.LzmaArchive preparada para descompressão.
public LzmaArchive(Stream source)
Parâmetros
source
Stream
A origem do arquivo.
Observações
Este construtor não descomprime. Consulte o método Aspose.Zip.LZMA.LzmaArchive.Extract(System.IO.Stream) para descompressão.
Exceções
source
não é buscável.
source
é nulo.
LzmaArchive(string)
Inicializa uma nova instância da classe Aspose.Zip.LZMA.LzmaArchive preparada para descompressão.
public LzmaArchive(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 LzmaArchive(sourceLzmaFile))
{
archive.Extract(extractedFile);
}
}
Observações
Este construtor não descomprime. Consulte o método Aspose.Zip.LZMA.LzmaArchive.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.
O acesso ao arquivo path
é 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 dos arquivos devem ter menos de 260 caracteres.
O arquivo em path
contém dois pontos (:) no meio da string.
Métodos
Dispose()
Executa tarefas definidas pelo aplicativo associadas à liberação, liberação ou redefinição de recursos não gerenciados.
public void Dispose()
Dispose(bool)
Executa tarefas definidas pelo aplicativo 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 lzma para um fluxo.
public void Extract(Stream destination)
Parâmetros
destination
Stream
Fluxo para armazenar dados descompactados.
Exemplos
using (FileStream sourceLzmaFile = File.Open(sourceFileName, FileMode.Open))
{
using (FileStream extractedFile = File.Open(extractedFileName, FileMode.Create))
{
using (var archive = new LzmaArchive(sourceLzmaFile))
{
archive.Extract(extractedFile);
}
}
}
Exceções
Os cabeçalhos do arquivo e as informações de serviço não foram lidas.
O arquivo está corrompido.
O fluxo de destino é nulo.
O fluxo de destino não suporta gravação.
Extract(FileInfo)
Extrai o arquivo lzma para um arquivo.
public void Extract(FileInfo fileInfo)
Parâmetros
fileInfo
FileInfo
FileInfo para armazenar dados descompactados.
Exemplos
using (FileStream lzmaFile = File.Open(sourceFileName, FileMode.Open))
{
using (var archive = new LzmaArchive(lzmaFile))
{
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.
O arquivo está corrompido.
Extract(string)
Extrai o arquivo lzma para um arquivo pelo caminho.
public void Extract(string path)
Parâmetros
path
string
Caminho para o arquivo que armazenará os dados descompactados.
Exemplos
using (FileStream lzmaFile = File.Open(sourceFileName, FileMode.Open))
{
using (var archive = new LzmaArchive(lzmaFile))
{
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.
O acesso ao arquivo path
é 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 dos arquivos devem ter menos de 260 caracteres.
O arquivo em path
contém dois pontos (:) no meio da string.
O arquivo está corrompido.
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 dos 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 os 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.
O arquivo está corrompido.
Save(Stream)
Salva o arquivo lzma no fluxo fornecido.
public void Save(Stream output)
Parâmetros
output
Stream
Fluxo de destino.
Exemplos
using (FileStream lzmaFile = File.Open("archive.lzma", FileMode.Create))
{
using (var archive = new LzmaArchive())
{
archive.SetSource("data.bin");
archive.Save(lzmaFile);
}
}
Observações
output
deve ser buscável.
Exceções
output
não suporta busca.
output
é nulo.
Save(FileInfo)
Salva o arquivo lzma 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 LzmaArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save(new FileInfo("archive.lzma"));
}
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 lzma 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 LzmaArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("result.lzma");
}
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.
O acesso ao arquivo destinationFileName
é 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 dos 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 fluxo de entrada para o arquivo.
Exemplos
using (var archive = new LzmaArchive())
{
archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
archive.Save("archive.lzma");
}
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 fluxo de entrada.
Exemplos
using (var archive = new LzmaArchive())
{
archive.SetSource(new FileInfo("data.bin"));
archive.Save("archive.lzma");
}
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 fluxo de entrada.
Exemplos
using (var archive = new LzmaArchive())
{
archive.SetSource("data.bin");
archive.Save("archive.lzma");
}
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.
O acesso ao arquivo sourcePath
é 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 dos arquivos devem ter menos de 260 caracteres.
O arquivo em sourcePath
contém dois pontos (:) no meio da string.