Class TarArchive

Class TarArchive

Namespace: Aspose.Zip.Tar
Assembly: Aspose.Zip.dll (25.1.0)

Esta classe representa um arquivo de arquivo tar. Use-a para compor, extrair ou atualizar arquivos tar.

public class TarArchive : IArchive, IDisposable

Herança

objectTarArchive

Implementa

IArchive, IDisposable

Membros Herdados

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

Construtores

TarArchive()

Inicializa uma nova instância da classe Aspose.Zip.Tar.TarArchive.

public TarArchive()

Exemplos

O seguinte exemplo mostra como comprimir um arquivo.

using (var archive = new TarArchive())
{
    archive.CreateEntry("first.bin", "data.bin");
    archive.Save("archive.tar");
}

TarArchive(Stream)

Inicializa uma nova instância da classe Aspose.Zip.Archive e compõe a lista de entradas que podem ser extraídas do arquivo.

public TarArchive(Stream sourceStream)

Parâmetros

sourceStream Stream

A fonte do arquivo. Deve ser buscável.

Exemplos

O seguinte exemplo mostra como extrair todas as entradas para um diretório.

using (var archive = new TarArchive(File.OpenRead("archive.tar")))
{ 
   archive.ExtractToDirectory("C:\extracted");
}

Observações

Este construtor não descompacta nenhuma entrada. Veja o método Aspose.Zip.Tar.TarEntry.Open para descompactação.

Exceções

InvalidDataException

sourceStream não é buscável.

TarArchive(string)

Inicializa uma nova instância da classe Aspose.Zip.Tar.TarArchive e compõe a lista de entradas que podem ser extraídas do arquivo.

public TarArchive(string path)

Parâmetros

path string

O caminho para o arquivo do arquivo.

Exemplos

O seguinte exemplo mostra como extrair todas as entradas para um diretório.

using (var archive = new TarArchive("archive.tar")) 
{ 
   archive.ExtractToDirectory("C:\extracted");
}

Observações

Este construtor não descompacta nenhuma entrada. Veja o método Aspose.Zip.Tar.TarEntry.Open para descompactação.

Exceções

ArgumentNullException

path é nulo.

SecurityException

O chamador não possui 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 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 dos 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.

Propriedades

Entries

Obtém as entradas do tipo Aspose.Zip.Tar.TarEntry que constituem o arquivo.

public ReadOnlyCollection<tarentry> Entries { get; }

Valor da Propriedade

ReadOnlyCollection<TarEntry&gt;

Métodos

CreateEntries(DirectoryInfo, bool)

Adiciona ao arquivo todos os arquivos e diretórios recursivamente no diretório fornecido.

public TarArchive CreateEntries(DirectoryInfo directory, bool includeRootDirectory = true)

Parâmetros

directory DirectoryInfo

Diretório a ser compactado.

includeRootDirectory bool

Indica se deve incluir o diretório raiz em si ou não.

Retorna

TarArchive

O arquivo com entradas compostas.

Exemplos

using (FileStream tarFile = File.Open("archive.tar", FileMode.Create))
{
    using (var archive = new TarArchive())
    {
        archive.CreateEntries(new DirectoryInfo("C:\folder"), false);
        archive.Save(tarFile);
    }
}

CreateEntries(string, bool)

Adiciona ao arquivo todos os arquivos e diretórios recursivamente no diretório fornecido.

public TarArchive CreateEntries(string sourceDirectory, bool includeRootDirectory = true)

Parâmetros

sourceDirectory string

Diretório a ser compactado.

includeRootDirectory bool

Indica se deve incluir o diretório raiz em si ou não.

Retorna

TarArchive

O arquivo com entradas compostas.

Exemplos

using (FileStream tarFile = File.Open("archive.tar", FileMode.Create))
{
    using (var archive = new TarArchive())
    {
        archive.CreateEntries("C:\folder", false);
        archive.Save(tarFile);
    }
}

Exceções

ArgumentNullException

sourceDirectory é nulo.

SecurityException

O chamador não possui a permissão necessária para acessar sourceDirectory.

ArgumentException

sourceDirectory contém caracteres inválidos, como “, <, > ou |.

PathTooLongException

O caminho, 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 caminho, nome do arquivo ou ambos são longos demais.

CreateEntry(string, Stream, FileSystemInfo)

Cria uma única entrada dentro do arquivo.

public TarEntry CreateEntry(string name, Stream source, FileSystemInfo fileInfo = null)

Parâmetros

name string

O nome da entrada.

source Stream

O fluxo de entrada para a entrada.

fileInfo FileSystemInfo

Os metadados do arquivo ou pasta a ser compactado.

Retorna

TarEntry

Instância da entrada Tar.

Exemplos

using (var archive = new TarArchive())
{
   archive.CreateEntry("bytes", new MemoryStream(new byte[] {0x00, 0xFF}));
   archive.Save(tarFile);
}

Observações

O nome da entrada é definido exclusivamente no parâmetro name. O nome do arquivo fornecido no parâmetro fileInfo não afeta o nome da entrada.

fileInfo pode referir-se a System.IO.DirectoryInfo se a entrada for um diretório.

Exceções

PathTooLongException

name é longo demais para tar de acordo com o padrão IEEE 1003.1-1998.

ArgumentException

O nome do arquivo, como parte de name, excede 100 símbolos.

CreateEntry(string, FileInfo, bool)

Cria uma única entrada dentro do arquivo.

public TarEntry CreateEntry(string name, FileInfo fileInfo, bool openImmediately = false)

Parâmetros

name string

O nome da entrada.

fileInfo FileInfo

Os metadados do arquivo ou pasta a ser compactado.

openImmediately bool

Verdadeiro se abrir o arquivo imediatamente, caso contrário, abrir o arquivo ao salvar o arquivo.

Retorna

TarEntry

Instância da entrada Tar.

Exemplos

FileInfo fi = new FileInfo("data.bin");
using (var archive = new TarArchive())
{
   archive.CreateEntry("data.bin", fi);
   archive.Save(tarFile);
}

Observações

O nome da entrada é definido exclusivamente no parâmetro name. O nome do arquivo fornecido no parâmetro fileInfo não afeta o nome da entrada.

fileInfo pode referir-se a System.IO.DirectoryInfo se a entrada for um diretório.

Se o arquivo for aberto imediatamente com o parâmetro openImmediately, ele ficará bloqueado até que o arquivo seja descartado.

Exceções

PathTooLongException

name é longo demais para tar de acordo com o padrão IEEE 1003.1-1998.

ArgumentException

O nome do arquivo, como parte de name, excede 100 símbolos.

CreateEntry(string, string, bool)

Cria uma única entrada dentro do arquivo.

public TarEntry CreateEntry(string name, string path, bool openImmediately = false)

Parâmetros

name string

O nome da entrada.

path string

Caminho para o arquivo a ser compactado.

openImmediately bool

Verdadeiro se abrir o arquivo imediatamente, caso contrário, abrir o arquivo ao salvar o arquivo.

Retorna

TarEntry

Instância da entrada Tar.

Exemplos

using (var archive = new TarArchive())
{
    archive.CreateEntry("first.bin", "data.bin");
    archive.Save(outputTarFile);
}

Observações

O nome da entrada é definido exclusivamente no parâmetro name. O nome do arquivo fornecido no parâmetro path não afeta o nome da entrada.

Se o arquivo for aberto imediatamente com o parâmetro openImmediately, ele ficará bloqueado até que o arquivo seja descartado.

Exceções

ArgumentNullException

path é nulo.

SecurityException

O chamador não possui 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. - ou - O nome do arquivo, como parte de name, excede 100 símbolos.

UnauthorizedAccessException

O 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 dos arquivos devem ter menos de 260 caracteres. - ou - name é longo demais para tar de acordo com o padrão IEEE 1003.1-1998.

NotSupportedException

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

DeleteEntry(TarEntry)

Remove a primeira ocorrência de uma entrada específica da lista de entradas.

public TarArchive DeleteEntry(TarEntry entry)

Parâmetros

entry TarEntry

A entrada a ser removida da lista de entradas.

Retorna

TarArchive

O arquivo com a entrada excluída.

Exemplos

Aqui está como você pode remover todas as entradas, exceto a última:

using (var archive = new TarArchive("archive.tar"))
{
    while (archive.Entries.Count &gt; 1)
        archive.DeleteEntry(archive.Entries[0]);
    archive.Save(outputTarFile);
}

DeleteEntry(int)

Remove a entrada da lista de entradas pelo índice.

public TarArchive DeleteEntry(int entryIndex)

Parâmetros

entryIndex int

O índice baseado em zero da entrada a ser removida.

Retorna

TarArchive

O arquivo com a entrada excluída.

Exemplos

using (var archive = new TarArchive("two_files.tar"))
{
    archive.DeleteEntry(0);
    archive.Save("single_file.tar");
}

Exceções

ArgumentOutOfRangeException

entryIndex é menor que 0.-ou- entryIndex é igual ou maior que a contagem de Entries.

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

ExtractToDirectory(string)

Extrai todos os arquivos no 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.

Exemplos

using (var archive = new TarArchive("archive.tar")) 
{ 
   archive.ExtractToDirectory("C:\extracted");
}

Observações

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

Exceções

ArgumentNullException

path é 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 possui 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

path é 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- path é 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.

FromGZip(Stream)

Extrai o arquivo gzip fornecido e compõe Aspose.Zip.Tar.TarArchive a partir dos dados extraídos.

Importante: o arquivo gzip é totalmente extraído dentro deste método, seu conteúdo é mantido internamente. Cuidado com o consumo de memória.

public static TarArchive FromGZip(Stream source)

Parâmetros

source Stream

A fonte do arquivo.

Retorna

TarArchive

Uma instância de Aspose.Zip.Tar.TarArchive

Observações

O fluxo de extração GZip não é buscável pela natureza do algoritmo de compressão. O arquivo Tar fornece a facilidade de extrair registros arbitrários, portanto, deve operar em um fluxo buscável internamente.

Exceções

InvalidDataException

O arquivo está corrompido.

FromGZip(string)

Extrai o arquivo gzip fornecido e compõe Aspose.Zip.Tar.TarArchive a partir dos dados extraídos.

Importante: o arquivo gzip é totalmente extraído dentro deste método, seu conteúdo é mantido internamente. Cuidado com o consumo de memória.

public static TarArchive FromGZip(string path)

Parâmetros

path string

O caminho para o arquivo do arquivo.

Retorna

TarArchive

Uma instância de Aspose.Zip.Tar.TarArchive

Observações

O fluxo de extração GZip não é buscável pela natureza do algoritmo de compressão. O arquivo Tar fornece a facilidade de extrair registros arbitrários, portanto, deve operar em um fluxo buscável internamente.

Exceções

InvalidDataException

O arquivo está corrompido.

FromLZMA(Stream)

Extrai o arquivo LZMA fornecido e compõe Aspose.Zip.Tar.TarArchive a partir dos dados extraídos.

Importante: o arquivo LZMA é totalmente extraído dentro deste método, seu conteúdo é mantido internamente. Cuidado com o consumo de memória.

public static TarArchive FromLZMA(Stream source)

Parâmetros

source Stream

A fonte do arquivo.

Retorna

TarArchive

Uma instância de Aspose.Zip.Tar.TarArchive

Observações

O fluxo de extração LZMA não é buscável pela natureza do algoritmo de compressão. O arquivo Tar fornece a facilidade de extrair registros arbitrários, portanto, deve operar em um fluxo buscável internamente.

FromLZMA(string)

Extrai o arquivo LZMA fornecido e compõe Aspose.Zip.Tar.TarArchive a partir dos dados extraídos.

Importante: o arquivo LZMA é totalmente extraído dentro deste método, seu conteúdo é mantido internamente. Cuidado com o consumo de memória.

public static TarArchive FromLZMA(string path)

Parâmetros

path string

O caminho para o arquivo do arquivo.

Retorna

TarArchive

Uma instância de Aspose.Zip.Tar.TarArchive

Observações

O fluxo de extração LZMA não é buscável pela natureza do algoritmo de compressão. O arquivo Tar fornece a facilidade de extrair registros arbitrários, portanto, deve operar em um fluxo buscável internamente.

FromLZip(Stream)

Extrai o arquivo lzip fornecido e compõe Aspose.Zip.Tar.TarArchive a partir dos dados extraídos.

Importante: o arquivo lzip é totalmente extraído dentro deste método, seu conteúdo é mantido internamente. Cuidado com o consumo de memória.

public static TarArchive FromLZip(Stream source)

Parâmetros

source Stream

A fonte do arquivo.

Retorna

TarArchive

Uma instância de Aspose.Zip.Tar.TarArchive

Observações

O fluxo de extração Lzip não é buscável pela natureza do algoritmo de compressão. O arquivo Tar fornece a facilidade de extrair registros arbitrários, portanto, deve operar em um fluxo buscável internamente.

FromLZip(string)

Extrai o arquivo lzip fornecido e compõe Aspose.Zip.Tar.TarArchive a partir dos dados extraídos.

Importante: o arquivo lzip é totalmente extraído dentro deste método, seu conteúdo é mantido internamente. Cuidado com o consumo de memória.

public static TarArchive FromLZip(string path)

Parâmetros

path string

O caminho para o arquivo do arquivo.

Retorna

TarArchive

Uma instância de Aspose.Zip.Tar.TarArchive

Observações

O fluxo de extração Lzip não é buscável pela natureza do algoritmo de compressão. O arquivo Tar fornece a facilidade de extrair registros arbitrários, portanto, deve operar em um fluxo buscável internamente.

FromXz(Stream)

Extrai o arquivo no formato xz fornecido e compõe Aspose.Zip.Tar.TarArchive a partir dos dados extraídos.

Importante: o arquivo xz é totalmente extraído dentro deste método, seu conteúdo é mantido internamente. Cuidado com o consumo de memória.

public static TarArchive FromXz(Stream source)

Parâmetros

source Stream

A fonte do arquivo.

Retorna

TarArchive

Uma instância de Aspose.Zip.Tar.TarArchive

Observações

O arquivo Tar fornece a facilidade de extrair registros arbitrários, portanto, deve operar em um fluxo buscável internamente.

FromXz(string)

Extrai o arquivo no formato xz fornecido e compõe Aspose.Zip.Tar.TarArchive a partir dos dados extraídos.

Importante: o arquivo xz é totalmente extraído dentro deste método, seu conteúdo é mantido internamente. Cuidado com o consumo de memória.

public static TarArchive FromXz(string path)

Parâmetros

path string

O caminho para o arquivo do arquivo.

Retorna

TarArchive

Uma instância de Aspose.Zip.Tar.TarArchive

Observações

O arquivo Tar fornece a facilidade de extrair registros arbitrários, portanto, deve operar em um fluxo buscável internamente.

FromZ(Stream)

Extrai o arquivo no formato Z fornecido e compõe Aspose.Zip.Tar.TarArchive a partir dos dados extraídos.

Importante: o arquivo Z é totalmente extraído dentro deste método, seu conteúdo é mantido internamente. Cuidado com o consumo de memória.

public static TarArchive FromZ(Stream source)

Parâmetros

source Stream

A fonte do arquivo.

Retorna

TarArchive

Uma instância de Aspose.Zip.Tar.TarArchive

Observações

O arquivo Tar fornece a facilidade de extrair registros arbitrários, portanto, deve operar em um fluxo buscável internamente.

FromZ(string)

Extrai o arquivo no formato Z fornecido e compõe Aspose.Zip.Tar.TarArchive a partir dos dados extraídos.

Importante: o arquivo Z é totalmente extraído dentro deste método, seu conteúdo é mantido internamente. Cuidado com o consumo de memória.

public static TarArchive FromZ(string path)

Parâmetros

path string

O caminho para o arquivo do arquivo.

Retorna

TarArchive

Uma instância de Aspose.Zip.Tar.TarArchive

Observações

O arquivo Tar fornece a facilidade de extrair registros arbitrários, portanto, deve operar em um fluxo buscável internamente.

FromZstandard(Stream)

Extrai o arquivo no formato Zstandard fornecido e compõe Aspose.Zip.Tar.TarArchive a partir dos dados extraídos.

Importante: o arquivo Zstandard é totalmente extraído dentro deste método, seu conteúdo é mantido internamente. Cuidado com o consumo de memória.

public static TarArchive FromZstandard(Stream source)

Parâmetros

source Stream

A fonte do arquivo.

Retorna

TarArchive

Uma instância de Aspose.Zip.Tar.TarArchive

Exceções

IOException

O fluxo Zstandard está corrompido ou não é legível.

InvalidDataException

Os dados estão corrompidos.

FromZstandard(string)

Extrai o arquivo no formato Zstandard fornecido e compõe Aspose.Zip.Tar.TarArchive a partir dos dados extraídos.

Importante: o arquivo Zstandard é totalmente extraído dentro deste método, seu conteúdo é mantido internamente. Cuidado com o consumo de memória.

public static TarArchive FromZstandard(string path)

Parâmetros

path string

O caminho para o arquivo do arquivo.

Retorna

TarArchive

Uma instância de Aspose.Zip.Tar.TarArchive

Exceções

IOException

O fluxo Zstandard está corrompido ou não é legível.

InvalidDataException

Os dados estão corrompidos.

Save(Stream, TarFormat?)

Salva o arquivo no fluxo fornecido.

public void Save(Stream output, TarFormat? format = null)

Parâmetros

output Stream

Fluxo de destino.

format TarFormat?

Define o formato do cabeçalho tar. Um valor nulo será tratado como USTar quando possível.

Exemplos

using (FileStream tarFile = File.Open("archive.tar", FileMode.Create))
{
    using (var archive = new TarArchive())
    {
        archive.CreateEntry("entry1", "data.bin");
        archive.Save(tarFile);
    }
}

Observações

output deve ser gravável.

Exceções

ArgumentException

output não é gravável. - ou - output é o mesmo fluxo de onde extraímos. - OU - É impossível salvar o arquivo no format devido a restrições de formato.

Save(string, TarFormat?)

Salva o arquivo no arquivo de destino fornecido.

public void Save(string destinationFileName, TarFormat? format = null)

Parâmetros

destinationFileName string

O caminho do arquivo a ser criado. Se o nome do arquivo especificado aponta para um arquivo existente, ele será sobrescrito.

format TarFormat?

Define o formato do cabeçalho tar. Um valor nulo será tratado como USTar quando possível.

Exemplos

using (var archive = new TarArchive())
{
    archive.CreateEntry("entry1", "data.bin");        
    archive.Save("myarchive.tar");
}

Observações

É possível salvar um arquivo no mesmo caminho de onde foi carregado. No entanto, isso não é recomendado porque essa abordagem utiliza cópias para um arquivo temporário.

Exceções

ArgumentException

destinationFileName é uma string de comprimento zero, contém apenas espaços em branco ou contém um ou mais caracteres inválidos conforme definido por System.IO.Path.InvalidPathChars.

ArgumentNullException

destinationFileName é nulo.

PathTooLongException

O destinationFileName 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.

DirectoryNotFoundException

O destinationFileName especificado é inválido, (por exemplo, está em uma unidade não mapeada).

IOException

Ocorreu um erro de E/S ao abrir o arquivo.

UnauthorizedAccessException

destinationFileName especificou um arquivo que é somente leitura e o acesso não é de leitura.-ou- o caminho especificou um diretório.-ou- O chamador não possui a permissão necessária.

NotSupportedException

destinationFileName está em um formato inválido.

FileNotFoundException

O arquivo não foi encontrado.

SaveGzipped(Stream, TarFormat?)

Salva o arquivo no fluxo com compressão gzip.

public void SaveGzipped(Stream output, TarFormat? format = null)

Parâmetros

output Stream

Fluxo de destino.

format TarFormat?

Define o formato do cabeçalho tar. Um valor nulo será tratado como USTar quando possível.

Exemplos

using (FileStream result = File.OpenWrite("result.tar.gz"))
{
    using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
    {
        using (var archive = new TarArchive())
        {
            archive.CreateEntry("entry.bin", source);
            archive.SaveGzipped(result);
        }
    }
}

Observações

output deve ser gravável.

Exceções

ArgumentNullException

output é nulo.

ArgumentException

output não é gravável.

SaveGzipped(string, TarFormat?)

Salva o arquivo no caminho especificado com compressão gzip.

public void SaveGzipped(string path, TarFormat? format = null)

Parâmetros

path string

O caminho do arquivo a ser criado. Se o nome do arquivo especificado aponta para um arquivo existente, ele será sobrescrito.

format TarFormat?

Define o formato do cabeçalho tar. Um valor nulo será tratado como USTar quando possível.

Exemplos

using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
    using (var archive = new TarArchive())
    {
        archive.CreateEntry("entry.bin", source);
        archive.SaveGzipped("result.tar.gz");
    }
}

SaveLZMACompressed(Stream, TarFormat?)

Salva o arquivo no fluxo com compressão LZMA.

public void SaveLZMACompressed(Stream output, TarFormat? format = null)

Parâmetros

output Stream

Fluxo de destino.

format TarFormat?

Define o formato do cabeçalho tar. Um valor nulo será tratado como USTar quando possível.

Exemplos

using (FileStream result = File.OpenWrite("result.tar.lzma"))
{
    using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
    {
        using (var archive = new TarArchive())
        {
            archive.CreateEntry("entry.bin", source);
            archive.SaveLZMACompressed(result);
        }
    }
}

Observações

output deve ser gravável.

Importante: o arquivo tar é composto e depois compactado dentro deste método, seu conteúdo é mantido internamente. Cuidado com o consumo de memória.

Exceções

ArgumentNullException

output é nulo.

ArgumentException

output não é gravável.

SaveLZMACompressed(string, TarFormat?)

Salva o arquivo no caminho especificado com compressão lzma.

public void SaveLZMACompressed(string path, TarFormat? format = null)

Parâmetros

path string

O caminho do arquivo a ser criado. Se o nome do arquivo especificado aponta para um arquivo existente, ele será sobrescrito.

format TarFormat?

Define o formato do cabeçalho tar. Um valor nulo será tratado como USTar quando possível.

Exemplos

using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
    using (var archive = new TarArchive())
    {
        archive.CreateEntry("entry.bin", source);
        archive.SaveLZMACompressed("result.tar.lzma");
    }
}

Observações

Importante: o arquivo tar é composto e depois compactado dentro deste método, seu conteúdo é mantido internamente. Cuidado com o consumo de memória.

SaveLzipped(Stream, TarFormat?)

Salva o arquivo no fluxo com compressão lzip.

public void SaveLzipped(Stream output, TarFormat? format = null)

Parâmetros

output Stream

Fluxo de destino.

format TarFormat?

Define o formato do cabeçalho tar. Um valor nulo será tratado como USTar quando possível.

Exemplos

using (FileStream result = File.OpenWrite("result.tar.lz"))
{
    using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
    {
        using (var archive = new TarArchive())
        {
            archive.CreateEntry("entry.bin", source);
            archive.SaveLzipped(result);
        }
    }
}

Observações

output deve ser gravável.

Exceções

ArgumentNullException

output é nulo.

ArgumentException

output não é gravável.

SaveLzipped(string, TarFormat?)

Salva o arquivo no caminho especificado com compressão lzip.

public void SaveLzipped(string path, TarFormat? format = null)

Parâmetros

path string

O caminho do arquivo a ser criado. Se o nome do arquivo especificado aponta para um arquivo existente, ele será sobrescrito.

format TarFormat?

Define o formato do cabeçalho tar. Um valor nulo será tratado como USTar quando possível.

Exemplos

using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
    using (var archive = new TarArchive())
    {
        archive.CreateEntry("entry.bin", source);
        archive.SaveGzipped("result.tar.lz");
    }
}

SaveXzCompressed(Stream, TarFormat?, XzArchiveSettings)

Salva o arquivo no fluxo com compressão xz.

public void SaveXzCompressed(Stream output, TarFormat? format = null, XzArchiveSettings settings = null)

Parâmetros

output Stream

Fluxo de destino.

format TarFormat?

Define o formato do cabeçalho tar. Um valor nulo será tratado como USTar quando possível.

settings XzArchiveSettings

Conjunto de configurações do arquivo xz específico: tamanho do dicionário, tamanho do bloco, tipo de verificação.

Exemplos

using (FileStream result = File.OpenWrite("result.tar.xz"))
{
    using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
    {
        using (var archive = new TarArchive())
        {
            archive.CreateEntry("entry.bin", source);
            archive.SaveXzCompressed(result);
        }
    }
}

Observações

output O fluxo deve ser gravável.

Exceções

ArgumentNullException

output é nulo.

ArgumentException

output não é gravável.

SaveXzCompressed(string, TarFormat?, XzArchiveSettings)

Salva o arquivo no caminho especificado com compressão xz.

public void SaveXzCompressed(string path, TarFormat? format = null, XzArchiveSettings settings = null)

Parâmetros

path string

O caminho do arquivo a ser criado. Se o nome do arquivo especificado aponta para um arquivo existente, ele será sobrescrito.

format TarFormat?

Define o formato do cabeçalho tar. Um valor nulo será tratado como USTar quando possível.

settings XzArchiveSettings

Conjunto de configurações do arquivo xz específico: tamanho do dicionário, tamanho do bloco, tipo de verificação.

Exemplos

using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
    using (var archive = new TarArchive())
    {
        archive.CreateEntry("entry.bin", source);
        archive.SaveXzCompressed("result.tar.xz");
    }
}

SaveZCompressed(Stream, TarFormat?)

Salva o arquivo no fluxo com compressão Z.

public void SaveZCompressed(Stream output, TarFormat? format = null)

Parâmetros

output Stream

Fluxo de destino.

format TarFormat?

Define o formato do cabeçalho tar. Um valor nulo será tratado como USTar quando possível.

Exemplos

using (FileStream result = File.OpenWrite("result.tar.Z"))
{
    using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
    {
        using (var archive = new TarArchive())
        {
            archive.CreateEntry("entry.bin", source);
            archive.SaveZCompressed(result);
        }
    }
}

Observações

output deve ser gravável.

Exceções

ArgumentNullException

output é nulo.

ArgumentException

output não é gravável.

SaveZCompressed(string, TarFormat?)

Salva o arquivo no caminho especificado com compressão Z.

public void SaveZCompressed(string path, TarFormat? format = null)

Parâmetros

path string

O caminho do arquivo a ser criado. Se o nome do arquivo especificado aponta para um arquivo existente, ele será sobrescrito.

format TarFormat?

Define o formato do cabeçalho tar. Um valor nulo será tratado como USTar quando possível.

Exemplos

using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
    using (var archive = new TarArchive())
    {
        archive.CreateEntry("entry.bin", source);
        archive.SaveZCompressed("result.tar.Z");
    }
}

SaveZstandard(Stream, TarFormat?)

Salva o arquivo no fluxo com compressão Zstandard.

public void SaveZstandard(Stream output, TarFormat? format = null)

Parâmetros

output Stream

Fluxo de destino.

format TarFormat?

Define o formato do cabeçalho tar. Um valor nulo será tratado como USTar quando possível.

Exemplos

using (FileStream result = File.OpenWrite("result.tar.zst"))
{
    using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
    {
        using (var archive = new TarArchive())
        {
            archive.CreateEntry("entry.bin", source);
            archive.SaveZstandard(result);
        }
    }
}

Observações

output deve ser gravável.

Exceções

ArgumentNullException

output é nulo.

ArgumentException

output não é gravável.

SaveZstandard(string, TarFormat?)

Salva o arquivo no caminho especificado com compressão Zstandard.

public void SaveZstandard(string path, TarFormat? format = null)

Parâmetros

path string

O caminho do arquivo a ser criado. Se o nome do arquivo especificado aponta para um arquivo existente, ele será sobrescrito.

format TarFormat?

Define o formato do cabeçalho tar. Um valor nulo será tratado como USTar quando possível.

Exemplos

using (FileStream source = File.Open("data.bin", FileMode.Open, FileAccess.Read))
{
    using (var archive = new TarArchive())
    {
        archive.CreateEntry("entry.bin", source);
        archive.SaveZstandard("result.tar.zst");
    }
}
 Português