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
Implementa
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
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
path
é nulo.
O chamador não possui a permissão necessária para acessar.
O path
está vazio, contém apenas espaços em branco ou contém caracteres inválidos.
O acesso ao arquivo path
foi negado.
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.
O arquivo em path
contém dois pontos (:) no meio da string.
O arquivo não foi encontrado.
O caminho especificado é inválido, como estar em uma unidade não mapeada.
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>
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
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
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
sourceDirectory
é nulo.
O chamador não possui a permissão necessária para acessar sourceDirectory
.
sourceDirectory
contém caracteres inválidos, como “, <, > ou |.
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
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
name
é longo demais para tar de acordo com o padrão IEEE 1003.1-1998.
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
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
name
é longo demais para tar de acordo com o padrão IEEE 1003.1-1998.
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
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
path
é nulo.
O chamador não possui a permissão necessária para acessar.
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.
O acesso ao arquivo path
foi negado.
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.
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
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 > 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
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
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
path é nulo.
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.
O chamador não possui a permissão necessária para acessar o diretório existente.
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:").
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 (:).
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
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
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
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
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
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
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
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
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
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
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
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
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
Uma instância de Aspose.Zip.Tar.TarArchive
Exceções
O fluxo Zstandard está corrompido ou não é legível.
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
Uma instância de Aspose.Zip.Tar.TarArchive
Exceções
O fluxo Zstandard está corrompido ou não é legível.
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
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
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.
destinationFileName
é nulo.
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.
O destinationFileName
especificado é inválido, (por exemplo, está em uma unidade não mapeada).
Ocorreu um erro de E/S ao abrir o arquivo.
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.
destinationFileName
está em um formato inválido.
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
output
é nulo.
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.
Exceções
output
é nulo.
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
output
é nulo.
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
output
é nulo.
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
output
é nulo.
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
output
é nulo.
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");
}
}