Class LzmaArchive

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

objectLzmaArchive

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

ArgumentException

source não é buscável.

ArgumentNullException

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

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

O acesso ao arquivo path é 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 dos arquivos devem ter menos de 260 caracteres.

NotSupportedException

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

InvalidOperationException

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

InvalidDataException

O arquivo está corrompido.

ArgumentNullException

O fluxo de destino é nulo.

ArgumentException

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

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.

InvalidDataException

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

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

O acesso ao arquivo path é 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 dos arquivos devem ter menos de 260 caracteres.

NotSupportedException

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

InvalidDataException

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

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

IOException

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

InvalidDataException

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

ArgumentException

output não suporta busca.

ArgumentNullException

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

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 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

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

O acesso ao arquivo destinationFileName é 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 dos 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 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

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 fluxo de entrada.

Exemplos

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

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 fluxo de entrada.

Exemplos

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

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

O acesso ao arquivo sourcePath é 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 dos arquivos devem ter menos de 260 caracteres.

NotSupportedException

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

 Português