Class Bzip2Archive

Class Bzip2Archive

Nome do espaço: Aspose.Zip.Bzip2 Assembleia: Aspose.Zip.dll (25.5.0)

Esta classe representa o arquivo bzip2. Use-o para compilar ou extrair arquivos bzip2.

public class Bzip2Archive : IArchive, IDisposable, IArchiveFileEntry

Inheritance

object Bzip2Archive

Implements

IArchive , IDisposable , IArchiveFileEntry

Membros herdados

object.GetType() , object.MemberwiseClone() , object.ToString() , object.Equals(object?) , object.Equals(object?, object?) , object.ReferenceEquals(object?, object?) , object.GetHashCode()

Remarks

bzip2 comprime arquivos usando o algoritmo de compressão de texto do bloco Burrows-Wheeler e o codificação Huffman. Veja mais: https://en.wikipedia.org/wiki/Bzip2

Constructors

Bzip2Archive()

Inicia uma nova instância da classe Aspose.Zip.Bzip2.Bzip2Archive preparada para compressão.

public Bzip2Archive()

Examples

O exemplo a seguir mostra como comprimir um arquivo.

using (Bzip2Archive archive = new Bzip2Archive()) 
{
    archive.SetSource("data.bin");
    archive.Save("archive.bz2");
}

Bzip2Archive(Título: Bzip2LoadOptions)

Inicia uma nova instância da classe Aspose.Zip.Bzip2.Bzip2Archive preparada para a decompressão.

public Bzip2Archive(Stream sourceStream, Bzip2LoadOptions loadOptions = null)

Parameters

sourceStream Stream

A fonte do arquivo.

loadOptions Bzip2LoadOptions

As opções para carregar arquivos com.

Examples

Abra um arquivo de um fluxo e extrai-o para um

var ms = new MemoryStream();
using (Bzip2Archive archive = new Bzip2Archive(File.OpenRead("archive.bz2")))
  archive.Open().CopyTo(ms);

Remarks

Este construtor não descomprime. ver Aspose.Zip.Bzip2.Bzip2Archive.Open método de descompressão.

Exceptions

EndOfStreamException

Fim do fluxo prematuro.

InvalidDataException

Batos de assinatura errada.

Bzip2Archive(Título: Bzip2LoadOptions)

Inicia uma nova instância da classe Aspose.Zip.Bzip2.Bzip2Archive preparada para a decompressão.

public Bzip2Archive(string path, Bzip2LoadOptions loadOptions = null)

Parameters

path string

O caminho para o arquivo.

loadOptions Bzip2LoadOptions

As opções para carregar arquivos com.

Examples

Abra um arquivo do ficheiro por caminho e extraí-lo para um

var ms = new MemoryStream();
using (Bzip2Archive archive = new Bzip2Archive("archive.bz2"))
  archive.Open().CopyTo(ms);

Remarks

Este construtor não descomprime. ver Aspose.Zip.Bzip2.Bzip2Archive.Open método de descompressão.

Exceptions

ArgumentNullException

path’ is null.

SecurityException

O requerente não tem a permissão necessária para o acesso.

ArgumentException

O path’ é vazio, contém apenas espaços brancos, ou contém caracteres inválidos.

UnauthorizedAccessException

O acesso ao arquivo path" é negado.

PathTooLongException

O nome de arquivo especificado path", ou ambos excede o comprimento máximo definido pelo sistema. Por exemplo, em plataformas baseadas no Windows, os caminhos devem ser menores de 248 caracteres, e os nomes de arquivo devem ser menores de 260 caracteres.

NotSupportedException

O arquivo no path’ contém uma coluna (:) no meio da linha.

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.

EndOfStreamException

Fim do fluxo prematuro.

InvalidDataException

Batos de assinatura errada.

Methods

Dispose()

Exerce tarefas definidas por aplicação associadas à libertação, libertação ou restauração de recursos não gerenciados.

public void Dispose()

Dispose(Bolha)

Exerce tarefas definidas por aplicação associadas à libertação, libertação ou restauração de recursos não gerenciados.

protected virtual void Dispose(bool disposing)

Parameters

disposing bool

Se os recursos gerenciados devem ser dissolvidos.

Extract(Stream)

Extrair o arquivo para o fluxo fornecido.

public void Extract(Stream destination)

Parameters

destination Stream

Destination stream. deve ser escrita.

Examples

using (Bzip2Archive archive = new Bzip2Archive("archive.bz2"))
{
     archive.Extract(httpResponseStream);
}

Exceptions

ArgumentException

destination’ does not support writing.

Extract(Redação)

Extrair o arquivo para o arquivo por caminho.

public FileInfo Extract(string path)

Parameters

path string

O caminho para o arquivo de destino.Se o arquivo já existe, será sobreescrito.

Returns

FileInfo

Informação sobre o arquivo extraído.

Exceptions

ArgumentNullException

path’ is null.

SecurityException

O requerente não tem a permissão necessária para o acesso.

ArgumentException

O path’ é vazio, contém apenas espaços brancos, ou contém caracteres inválidos.

UnauthorizedAccessException

O acesso ao arquivo path" é negado.

PathTooLongException

O nome de arquivo especificado path", ou ambos excede o comprimento máximo definido pelo sistema. Por exemplo, em plataformas baseadas no Windows, os caminhos devem ser menores de 248 caracteres, e os nomes de arquivo devem ser menores de 260 caracteres.

NotSupportedException

O arquivo no path’ contém uma coluna (:) no meio da linha.

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.

ExtractToDirectory(Redação)

Extrair o conteúdo do arquivo para o diretório fornecido.

public void ExtractToDirectory(string destinationDirectory)

Parameters

destinationDirectory string

O caminho para o diretório para colocar os arquivos extraídos.

Remarks

Se o diretório não existe, será criado.

Exceptions

ArgumentNullException

destinationDirectory’ is null.

PathTooLongException

O caminho especificado, o nome do arquivo ou ambos excede o comprimento máximo definido pelo sistema. Por exemplo, em plataformas baseadas no Windows, os caminhos devem ser menores de 248 caracteres e os nomes do arquivo devem ser menores 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 existe, o caminho contém um caráter colon (:) que não faz parte de uma etiqueta de disco (“C:”).

ArgumentException

destinationDirectory’ is a zero-length string, contains only white space, or contains one or more invalid characters. You can query for invalid characters by using the System.IO.Path.GetInvalidPathChars method.-or- path is prefixed with, or contains, only a colon character (:).

IOException

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

Open()

Abre o arquivo para extração e fornece um fluxo com conteúdo de arquivo.

public Stream Open()

Returns

Stream

O fluxo que representa o conteúdo do arquivo.

Examples

Utilização :Stream decompressed = archive.Open();

.NET 4.0 e superior - Use o método Stream.CopyTo:decompressed.CopyTo(httpResponse.OutputStream)

.NET 3.5 e antes - copiar os bytes manualmente:

byte[] buffer = new byte[8192];
int bytesRead;
while (0 < (bytesRead = decompressed.Read(buffer, 0, buffer.Length)))
 fileStream.Write(buffer, 0, bytesRead);
```</p>

#### Remarks

Read from the stream to get the original content of the file. See examples section.

### <a id="Aspose_Zip_Bzip2_Bzip2Archive_Save_System_IO_Stream_Aspose_Zip_Bzip2_Bzip2SaveOptions_"></a> Save\(Stream, Bzip2SaveOptions\)

Saves archive to the stream provided.

```csharp
public void Save(Stream outputStream, Bzip2SaveOptions saveOptions = null)

Parameters

outputStream Stream

fluxo de destino.

saveOptions Bzip2SaveOptions

Opções para salvar um arquivo bzip2. se não especificado, 900 Kb tamanho de bloco seria usado.

Examples

Escreva dados comprimidos para o fluxo de resposta HTTP.

using (var archive = new Bzip2Archive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save(httpResponse.OutputStream);
}

Remarks

Tem que ser escrita.

Exceptions

InvalidOperationException

A fonte de dados a ser arquivada não foi fornecida.

ArgumentException

outputStream’ is not writable.

UnauthorizedAccessException

A fonte de arquivo é apenas leitura ou é um diretório.

DirectoryNotFoundException

O caminho de origem do arquivo especificado é inválido, como estar em um disco não mapeado.

IOException

A fonte do arquivo já está aberta.

Save(Título: Bzip2SaveOptions)

Salve arquivo para um arquivo de destino fornecido.

public void Save(string destinationFileName, Bzip2SaveOptions saveOptions = null)

Parameters

destinationFileName string

Se o nome do arquivo especificado aponta para um arquivo existente, ele será sobreescrito.

saveOptions Bzip2SaveOptions

Opções para salvar um arquivo bzip2. se não especificado, 900 Kb tamanho de bloco seria usado.

Examples

Escreva dados comprimidos para arquivos.

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

Exceptions

ArgumentNullException

destinationFileName’ is null.

SecurityException

O requerente não tem a permissão necessária para o acesso.

ArgumentException

A destinationFileName’ é vazia, contém apenas espaços brancos, ou contém caracteres inválidos.

UnauthorizedAccessException

O acesso ao arquivo destinationFileName’ é negado.

PathTooLongException

O nome de arquivo especificado destinationFileName, ou ambos excede o comprimento máximo definido pelo sistema. Por exemplo, em plataformas baseadas no Windows, os caminhos devem ser menores de 248 caracteres, e os nomes de arquivo devem ser menores de 260 caracteres.

NotSupportedException

O arquivo na destinationFileName’ contém uma coluna (:) no meio da linha.

SetSource(Stream)

Coloca o conteúdo para ser comprimido dentro do arquivo.

public void SetSource(Stream source)

Parameters

source Stream

O fluxo de entrada para o arquivo.

Examples

using (Bzip2Archive archive = new Bzip2Archive()) 
{
    archive.SetSource(new MemoryStream(new byte[] { 0x00,0xFF }));
    archive.Save("archive.bz2");
}

SetSource(FileInfo)

Coloca o conteúdo para ser comprimido dentro do arquivo.

public void SetSource(FileInfo fileInfo)

Parameters

fileInfo FileInfo

A referência a um arquivo a ser comprimido.

Examples

using (Bzip2Archive archive = new Bzip2Archive()) 
{
    archive.SetSource(new FileInfo("data.bin"));
    archive.Save("archive.bz2");
}

SetSource(Redação)

Coloca o conteúdo para ser comprimido dentro do arquivo.

public void SetSource(string path)

Parameters

path string

O caminho para o arquivo ser comprimido.

Examples

using (Bzip2Archive archive = new Bzip2Archive()) 
{
    archive.SetSource("data.bin");
    archive.Save("archive.bz2");
}

Exceptions

ArgumentNullException

path’ is null.

SecurityException

O requerente não tem a permissão necessária para o acesso.

ArgumentException

O path’ é vazio, contém apenas espaços brancos, ou contém caracteres inválidos.

UnauthorizedAccessException

O acesso ao arquivo path" é negado.

PathTooLongException

O nome de arquivo especificado path", ou ambos excede o comprimento máximo definido pelo sistema. Por exemplo, em plataformas baseadas no Windows, os caminhos devem ser menores de 248 caracteres, e os nomes de arquivo devem ser menores de 260 caracteres.

NotSupportedException

O arquivo no path’ contém uma coluna (:) no meio da linha.

SetSource(Arquivo, TarFormat)

Coloca o conteúdo para ser comprimido dentro do arquivo.

public void SetSource(TarArchive tarArchive, TarFormat format = TarFormat.UsTar)

Parameters

tarArchive TarArchive

Arquivo para ser comprimido.

format TarFormat

Defina o formato Tar Header.

Examples

using (var tarArchive = new TarArchive())
{
    tarArchive.CreateEntry("first.bin", "data1.bin");
    tarArchive.CreateEntry("second.bin", "data2.bin");
    using (var bzippedArchive = new Bzip2Archive())
    {
        bzippedArchive.SetSource(tarArchive);
        bzippedArchive.Save("archive.tar.bz2");
    }
}

Remarks

Use este método para compilar arquivo conjunto tar.bz2.

SetSource(Arquivo do Cpio, CpioFormat)

Coloca o conteúdo para ser comprimido dentro do arquivo.

public void SetSource(CpioArchive cpioArchive, CpioFormat format = CpioFormat.OldAscii)

Parameters

cpioArchive CpioArchive

arquivo para ser comprimido.

format CpioFormat

Defina o formato de cpio header.

Examples

using (var cpioArchive = new CpioArchive())
{
    cpioArchive.CreateEntry("first.bin", "data1.bin");
    cpioArchive.CreateEntry("second.bin", "data2.bin");
    using (var bzippedArchive = new Bzip2Archive())
    {
        bzippedArchive.SetSource(cpioArchive);
        bzippedArchive.Save("archive.cpio.bz2");
    }
}

Remarks

Use este método para compilar o arquivo conjunto cpio.bz2.

 Português