Class Lz4Archive

Class Lz4Archive

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

Esta classe representa o arquivo LZ4.Utiliza-o para extrair ou compilar arquivos L Z4.

public class Lz4Archive : IArchive, IDisposable, IArchiveFileEntry

Inheritance

object Lz4Archive

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

Constructors

Lz4Archive(Stream)

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

public Lz4Archive(Stream sourceStream)

Parameters

sourceStream Stream

A fonte do arquivo.

Examples

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

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

Remarks

Este fabricante não descomprime. ver Aspose.Zip.Lz4.Lz4Archive.Open método de descompressão.

Exceptions

ArgumentException

Não se pode ler de sourceStream'

ArgumentNullException

sourceStream’ is null.

EndOfStreamException

sourceStream’ is too short.

InvalidDataException

O sourceStream’ tem uma assinatura errada.

Lz4Archive(Redação)

Inicia uma nova instância da classe Aspose.Zip.Lz4.Lz4Archive.

public Lz4Archive(string path)

Parameters

path string

O caminho para o arquivo.

Examples

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

var ms = new MemoryStream();
using (Lz4Archive archive = new Lz4Archive("archive.lz4"))
  archive.Open().CopyTo(ms);

Remarks

Este fabricante não descomprime. ver Aspose.Zip.Lz4.Lz4Archive.Open método de descompressão.

Exceptions

ArgumentNullException

path’ is null.

SecurityException

O usuário não tem a permissão necessária para acessar

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.

EndOfStreamException

O arquivo é muito curto.

InvalidDataException

Os dados no arquivo têm a assinatura errada.

Lz4Archive(Lz4ArchiveSetting)

Inicia uma nova instância da classe de arquivo Aspose.Zip.Lz4.Lc4 preparada para compressão.

public Lz4Archive(Lz4ArchiveSetting settings = null)

Parameters

settings Lz4ArchiveSetting

A configuração do arquivo composto.

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(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 um arquivo extraído.

Exceptions

EndOfStreamException

O fluxo de fonte é muito curto.

InvalidDataException

Batos errados encontrados durante a decodificação.

NotSupportedException

Esta versão LZ4 não é suportada.

Extract(Stream)

Extrair o arquivo para o fluxo fornecido.

public void Extract(Stream destination)

Parameters

destination Stream

Destination stream. deve ser escrita.

Examples

using (var archive = new Lz4Archive("archive.lz4"))
{
     archive.Extract(httpResponseStream);
}

Exceptions

ArgumentException

destination’ does not support writing.

EndOfStreamException

O fluxo de fonte é muito curto.

InvalidDataException

Batos errados encontrados durante a decodificação.

NotSupportedException

Esta versão LZ4 não é suportada.

InvalidOperationException

O arquivo está preparado para a composição.

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.

EndOfStreamException

O fluxo de fonte é muito curto.

InvalidDataException

Batos errados encontrados ao iniciar a decodificação.

InvalidOperationException

O arquivo está preparado para a composição.

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

Extrata o arquivo e copia o conteúdo extraído para o fluxo de arquivo.

using (var archive = new Lz4Archive("archive.lz4"))
{
    using (var extracted = File.Create("data.bin"))
    {
        var unpacked = archive.Open();
        byte[] b = new byte[8192];
        int bytesRead;
        while (0 < (bytesRead = unpacked.Read(b, 0, b.Length)))
            extracted.Write(b, 0, bytesRead);
    }            
}

Você pode usar o método Stream.CopyTo para .NET 4.0 e superior: ‘unpacked.Kopy To(extraído);’

Remarks

Leia do fluxo para obter o conteúdo original de um arquivo. ver seção exemplos.

Exceptions

EndOfStreamException

O fluxo de fonte é muito curto.

InvalidDataException

Batos errados encontrados ao iniciar a decodificação.

InvalidOperationException

O arquivo está preparado para a composição.

Save(Stream)

Salve o arquivo lz4 para o fluxo fornecido.

public void Save(Stream output)

Parameters

output Stream

fluxo de destino.

Examples

using (FileStream lz4File = File.Open("archive.lz4", FileMode.Create))
{
    using (var archive = new Lz4Archive())
    {
        archive.SetSource("data.bin");
        archive.Save(lz4File);
     }
}

Remarks

Deve ser procurável.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

InvalidOperationException

O arquivo está preparado para extração. - ou - Fonte não foi fornecido.

Save(FileInfo)

Esconde o arquivo lz4 para o ficheiro de destino fornecido.

public void Save(FileInfo destination)

Parameters

destination FileInfo

FileInfo, que será aberto como fluxo de destino.

Examples

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

Exceptions

SecurityException

O chamador não tem a permissão necessária para abrir a destination'.

ArgumentException

O caminho do arquivo é vazio ou contém apenas espaços brancos.

FileNotFoundException

O arquivo não foi encontrado.

UnauthorizedAccessException

O caminho para o arquivo é apenas leitura ou é um diretório.

ArgumentNullException

destination’ is null.

DirectoryNotFoundException

O caminho especificado é inválido, como estar em uma unidade não mapeada.

IOException

O arquivo já está aberto.

InvalidOperationException

O arquivo está preparado para extracção.

Save(Redação)

Salve arquivo para o arquivo de destino fornecido.

public void Save(string destinationFileName)

Parameters

destinationFileName string

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

Examples

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

Exceptions

ArgumentNullException

destinationFileName’ is null.

SecurityException

O usuário não tem a permissão necessária para acessar

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.

InvalidOperationException

O arquivo está preparado para extracção.

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 (var archive = new Lz4Archive())
{
    archive.SetSource(new MemoryStream(new byte[] { 0x00, 0xFF }));
    archive.Save("archive.lz4");
}

Exceptions

InvalidOperationException

O arquivo está preparado para extracção.

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

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

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

Exceptions

InvalidOperationException

O arquivo está preparado para extracção.

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 lz4Archive = new Lz4Archive())
    {
        lz4Archive.SetSource(tarArchive);
        lz4Archive.Save("archive.tar.lz4");
    }
}

Remarks

Use este método para compilar o arquivo conjunto tar.lz4.

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

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

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

Exceptions

ArgumentNullException

path’ is null.

SecurityException

O usuário não tem a permissão necessária para acessar

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.

InvalidOperationException

Este arquivo está preparado para extracção.

 Português