Class LzipArchive

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

objectLzipArchive

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

ArgumentException

sourceStream não é buscável.

ArgumentNullException

sourceStream é nulo.

InvalidDataException

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

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.

InvalidDataException

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

LzipArchiveSettings

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

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 fluxo de destino é nulo.

ArgumentException

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

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

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

ArgumentException

outputStream não suporta busca.

ArgumentNullException

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

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

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.

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

ArgumentException

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

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

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.

 Português