Class TarArchive

Class TarArchive

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

Esta classe representa um arquivo de tar. Use-o para compilar, extrair ou atualizar arquivos de Tar.

public class TarArchive : IArchive, IDisposable

Inheritance

object TarArchive

Implements

IArchive , IDisposable

Membros herdados

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

Constructors

TarArchive()

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

public TarArchive()

Examples

O exemplo a seguir mostra como comprimir um arquivo.

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

TarArchive(Stream)

Inicia uma nova instância da classe Aspose.Zip.Archive e compõe uma lista de entrada que pode ser extraída do arquivo.

public TarArchive(Stream sourceStream)

Parameters

sourceStream Stream

A fonte do arquivo deve ser procurável.

Examples

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

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

Remarks

Este fabricante não despaque qualquer entrada. ver Aspose.Zip.Tar.TarEntry.Open método para despaque.

Exceptions

ArgumentException

sourceStream’ is not seekable.

ArgumentNullException

sourceStream’ is null.

TarArchive(Redação)

Inicia uma nova instância da classe Aspose.Zip.Tar.tarArchive e compõe uma lista de entradas que pode ser extraída do arquivo.

public TarArchive(string path)

Parameters

path string

O caminho para o arquivo.

Examples

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

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

Remarks

Este fabricante não despaque qualquer entrada. ver Aspose.Zip.Tar.TarEntry.Open método para despaque.

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.

Properties

Entries

Recebe entradas do tipo Aspose.Zip.Tar.TarEntry que constituem o arquivo.

public ReadOnlyCollection<tarentry> Entries { get; }

Valor da propriedade

ReadOnlyCollection e o PT; TarEntry >

Methods

CreateEntries(DiretórioInfo, Bool)

Adicione ao arquivo todos os arquivos e diretórios repetidamente no diretório dado.

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

Parameters

directory DirectoryInfo

Diretório para compressão.

includeRootDirectory bool

Indica se incluir o diretório de raiz ou não.

Returns

TarArchive

Arquivo com entradas compostas.

Examples

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(Remoção, Bool)

Adicione ao arquivo todos os arquivos e diretórios repetidamente no diretório dado.

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

Parameters

sourceDirectory string

Diretório para compressão.

includeRootDirectory bool

Indica se incluir o diretório de raiz ou não.

Returns

TarArchive

Arquivo com entradas compostas.

Examples

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

Exceptions

ArgumentNullException

sourceDirectory’ is null.

SecurityException

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

ArgumentException

sourceDirectory’ contains invalid characters such as “, <, >, or |.

PathTooLongException

O caminho especificado, o nome de 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 de arquivo devem ser menores de 260 caracteres.

CreateEntry(Título: Stream, FileSystemInfo)

Crie uma única entrada dentro do arquivo.

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

Parameters

name string

O nome da entrada.

source Stream

O fluxo de entrada para a entrada.

fileInfo FileSystemInfo

Os metadados do arquivo ou folha para ser comprimido.

Returns

TarEntry

Introdução à instância.

Examples

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

Remarks

O nome de entrada é definido apenas dentro do parâmetro.O nome de arquivo fornecido no parâmetro não afeta o nome de entrada.

Pode referir-se a System.IO.DirectoryInfo se a entrada é diretório.

Exceptions

PathTooLongException

name’ is too long for tar as of IEEE 1003.1-1998 standard.

ArgumentException

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

CreateEntry(Título: FileInfo, Bool)

Crie uma única entrada dentro do arquivo.

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

Parameters

name string

O nome da entrada.

fileInfo FileInfo

Os metadados do arquivo ou folha para ser comprimido.

openImmediately bool

É verdade, se abrir o arquivo imediatamente, caso contrário, abrir o arquivo em arquivo de armazenamento.

Returns

TarEntry

Introdução à instância.

Examples

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

Remarks

O nome de entrada é definido apenas dentro do parâmetro.O nome de arquivo fornecido no parâmetro não afeta o nome de entrada.

Pode referir-se a System.IO.DirectoryInfo se a entrada é diretório.

Se o arquivo for aberto imediatamente com o parâmetro, ele será bloqueado até que o arquivo seja apagado.

Exceptions

PathTooLongException

name’ is too long for tar as of IEEE 1003.1-1998 standard.

ArgumentException

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

CreateEntry(Título: String, String, Bool)

Crie uma única entrada dentro do arquivo.

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

Parameters

name string

O nome da entrada.

path string

O caminho para o arquivo ser comprimido.

openImmediately bool

É verdade, se abrir o arquivo imediatamente, caso contrário, abrir o arquivo em arquivo de armazenamento.

Returns

TarEntry

Introdução à instância.

Examples

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

Remarks

O nome de entrada é definido apenas dentro do parâmetro.O nome de arquivo fornecido no parâmetro não afeta o nome de entrada.

Se o arquivo for aberto imediatamente com o parâmetro, ele será bloqueado até que o arquivo seja apagado.

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. - ou - Nome do arquivo, como parte do name’, excede 100 símbolos.

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. - ou - name’ é demasiado longo para o tar em relação ao padrão IEEE 1003.1-1998.

NotSupportedException

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

DeleteEntry(TarEntry)

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

public TarArchive DeleteEntry(TarEntry entry)

Parameters

entry TarEntry

A entrada para remover da lista de entradas.

Returns

TarArchive

O arquivo com a entrada foi apagado.

Examples

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)

Remova a entrada da lista de entrada por índice.

public TarArchive DeleteEntry(int entryIndex)

Parameters

entryIndex int

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

Returns

TarArchive

O arquivo com a entrada foi apagado.

Examples

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

Exceptions

ArgumentOutOfRangeException

entryIndex’ is less than 0.-or- entryIndex’ is equal to or greater than ‘Entries’ count.

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.

ExtractToDirectory(Redação)

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

Examples

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

Remarks

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

Exceptions

ArgumentNullException

O caminho é zero

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

Path é uma faixa de comprimento zero, contém apenas espaço branco, ou contêm um ou mais caracteres invalíduos. Você pode fazer uma pergunta para os personagens invalidos usando o método System.IO.Path.GetInvalidPithChars. - ou - o caminho é prefixido com ou contiver, apenas um caráter colon (:).

IOException

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

do Zip(Stream)

Extratos fornecidos arquivo gzip e compõe Aspose.Zip.Tar.TarArchive dos dados extraídos.

Importante: o arquivo gzip é totalmente extraído dentro deste método, seu conteúdo é mantido internamente.

public static TarArchive FromGZip(Stream source)

Parameters

source Stream

A fonte do arquivo.

Returns

TarArchive

Um exemplo de Aspose.Zip.Tar.TarArchive

Remarks

O fluxo de extração de GZip não é procurável pela natureza do algoritmo de compressão.O arquivo Tar fornece facilidade para extrair registros arbitrários, de modo que tem que operar o fluxo procurável debaixo do tapete.

Exceptions

InvalidDataException

O arquivo é corrompido.

do Zip(Redação)

Extratos fornecidos arquivo gzip e compõe Aspose.Zip.Tar.TarArchive dos dados extraídos.

Importante: o arquivo gzip é totalmente extraído dentro deste método, seu conteúdo é mantido internamente.

public static TarArchive FromGZip(string path)

Parameters

path string

O caminho para o arquivo.

Returns

TarArchive

Um exemplo de Aspose.Zip.Tar.TarArchive

Remarks

O fluxo de extração de GZip não é procurável pela natureza do algoritmo de compressão.O arquivo Tar fornece facilidade para extrair registros arbitrários, de modo que tem que operar o fluxo procurável debaixo do tapete.

Exceptions

ArgumentNullException

path’ is null.

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" está em um formato invalido.

DirectoryNotFoundException

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

FileNotFoundException

O arquivo não foi encontrado.

InvalidDataException

O arquivo é corrompido.

da LZ4(Redação)

Extratos fornecidos LZ4 arquivo e compõe Aspose.Zip.Tar.tarArchive dos dados extraídos.

Importante: o arquivo LZ4 é totalmente extraído dentro deste método, seu conteúdo é mantido internamente.

public static TarArchive FromLZ4(string path)

Parameters

path string

O caminho para o arquivo.

Returns

TarArchive

Um exemplo de Aspose.Zip.Tar.TarArchive

Remarks

O fluxo de extracção LZ4 não é procurável pela natureza do algoritmo de compressão. o arquivo Tar fornece facilidade para extrair registros arbitrários, por isso tem que operar fluxos procuráveis sob a casca.

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" está em um formato invalido.

DirectoryNotFoundException

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

FileNotFoundException

O arquivo não foi encontrado.

EndOfStreamException

O arquivo é muito curto.

InvalidDataException

O arquivo tem a assinatura errada.

da LZ4(Stream)

Extratos fornecidos LZ4 arquivo e compõe Aspose.Zip.Tar.tarArchive dos dados extraídos.

Importante: o arquivo LZ4 é totalmente extraído dentro deste método, seu conteúdo é mantido internamente.

public static TarArchive FromLZ4(Stream source)

Parameters

source Stream

A fonte do arquivo.

Returns

TarArchive

Um exemplo de Aspose.Zip.Tar.TarArchive

Remarks

O fluxo de extracção LZ4 não é procurável pela natureza do algoritmo de compressão. o arquivo Tar fornece facilidade para extrair registros arbitrários, por isso tem que operar fluxos procuráveis sob a casca.

Exceptions

ArgumentException

Não se pode ler de source’

ArgumentNullException

source’ is null.

EndOfStreamException

source’ is too short.

InvalidDataException

A fonte " tem a assinatura errada.

da LZMA(Stream)

Extratos fornecidos LZMA arquivo e compõe Aspose.Zip.Tar.TarArchive dos dados extraídos.

Importante: o arquivo LZMA é totalmente extraído dentro deste método, seu conteúdo é mantido internamente.

public static TarArchive FromLZMA(Stream source)

Parameters

source Stream

A fonte do arquivo.

Returns

TarArchive

Um exemplo de Aspose.Zip.Tar.TarArchive

Remarks

O fluxo de extracção LZMA não é procurável pela natureza do algoritmo de compressão. o arquivo Tar fornece facilidade para extrair registros arbitrários, por isso tem que operar o fluxo procurável sob a casca.

Exceptions

InvalidDataException

O arquivo é corrompido.

da LZMA(Redação)

Extratos fornecidos LZMA arquivo e compõe Aspose.Zip.Tar.TarArchive dos dados extraídos.

Importante: o arquivo LZMA é totalmente extraído dentro deste método, seu conteúdo é mantido internamente.

public static TarArchive FromLZMA(string path)

Parameters

path string

O caminho para o arquivo.

Returns

TarArchive

Um exemplo de Aspose.Zip.Tar.TarArchive

Remarks

O fluxo de extracção LZMA não é procurável pela natureza do algoritmo de compressão. o arquivo Tar fornece facilidade para extrair registros arbitrários, por isso tem que operar fluxos procuráveis sob a casca.

Exceptions

ArgumentNullException

path’ is null.

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" está em um formato invalido.

DirectoryNotFoundException

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

FileNotFoundException

O arquivo não foi encontrado.

da LZIP(Stream)

Extratos fornecidos arquivo lzip e compõe Aspose.Zip.Tar.TarArchive dos dados extraídos.

Importante: o arquivo lzip é totalmente extraído dentro deste método, seu conteúdo é mantido internamente.

public static TarArchive FromLZip(Stream source)

Parameters

source Stream

A fonte do arquivo.

Returns

TarArchive

Um exemplo de Aspose.Zip.Tar.TarArchive

Remarks

O fluxo de extracção Lzip não é procurável pela natureza do algoritmo de compressão. o arquivo Tar fornece facilidade para extrair registros arbitrários, por isso tem que operar o fluxo procurável sob a casca.

Exceptions

InvalidDataException

O arquivo é corrompido.

ArgumentException

source’ is not seekable.

ArgumentNullException

source’ is null.

da LZIP(Redação)

Extratos fornecidos arquivo lzip e compõe Aspose.Zip.Tar.TarArchive dos dados extraídos.

Importante: o arquivo lzip é totalmente extraído dentro deste método, seu conteúdo é mantido internamente.

public static TarArchive FromLZip(string path)

Parameters

path string

O caminho para o arquivo.

Returns

TarArchive

Um exemplo de Aspose.Zip.Tar.TarArchive

Remarks

O fluxo de extracção Lzip não é procurável pela natureza do algoritmo de compressão. o arquivo Tar fornece facilidade para extrair registros arbitrários, por isso tem que operar o fluxo procurável sob a casca.

Exceptions

ArgumentNullException

path’ is null.

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" está em um formato invalido.

DirectoryNotFoundException

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

FileNotFoundException

O arquivo não foi encontrado.

InvalidDataException

O arquivo é corrompido.

FromXz(Stream)

Extratos fornecidos arquivo de formato xz e compõem Aspose.Zip.Tar.TarArchive dos dados extraídos.

Importante: o arquivo xz é totalmente extraído dentro deste método, seu conteúdo é mantido internamente.

public static TarArchive FromXz(Stream source)

Parameters

source Stream

A fonte do arquivo.

Returns

TarArchive

Um exemplo de Aspose.Zip.Tar.TarArchive

Remarks

O arquivo Tar fornece facilidade para extrair registros arbitrários, de modo que tem que operar o fluxo procurável debaixo do tapete.

FromXz(Redação)

Extratos fornecidos arquivo de formato xz e compõem Aspose.Zip.Tar.TarArchive dos dados extraídos.

Importante: o arquivo xz é totalmente extraído dentro deste método, seu conteúdo é mantido internamente.

public static TarArchive FromXz(string path)

Parameters

path string

O caminho para o arquivo.

Returns

TarArchive

Um exemplo de Aspose.Zip.Tar.TarArchive

Remarks

O arquivo Tar fornece facilidade para extrair registros arbitrários, de modo que tem que operar o fluxo procurável debaixo do tapete.

Exceptions

ArgumentNullException

path’ is null.

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" está em um formato invalido.

DirectoryNotFoundException

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

FileNotFoundException

O arquivo não foi encontrado.

da Z(Stream)

Os extratos fornecem arquivos de formato Z e compõem Aspose.Zip.Tar.TarArchive dos dados extraídos.

Importante: o arquivo Z é totalmente extraído dentro deste método, seu conteúdo é mantido internamente.

public static TarArchive FromZ(Stream source)

Parameters

source Stream

A fonte do arquivo.

Returns

TarArchive

Um exemplo de Aspose.Zip.Tar.TarArchive

Remarks

O arquivo Tar fornece facilidade para extrair registros arbitrários, de modo que tem que operar o fluxo procurável debaixo do tapete.

da Z(Redação)

Os extratos fornecem arquivos de formato Z e compõem Aspose.Zip.Tar.TarArchive dos dados extraídos.

Importante: o arquivo Z é totalmente extraído dentro deste método, seu conteúdo é mantido internamente.

public static TarArchive FromZ(string path)

Parameters

path string

O caminho para o arquivo.

Returns

TarArchive

Um exemplo de Aspose.Zip.Tar.TarArchive

Remarks

O arquivo Tar fornece facilidade para extrair registros arbitrários, de modo que tem que operar o fluxo procurável debaixo do tapete.

Exceptions

ArgumentNullException

path’ is null.

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" está em um formato invalido.

DirectoryNotFoundException

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

FileNotFoundException

O arquivo não foi encontrado.

FromZstandard(Stream)

Extratos fornecidos arquivo Zstandard e compõe Aspose.Zip.Tar.TarArchive dos dados extraídos.

Importante: O arquivo padrão é totalmente extraído dentro deste método, seu conteúdo é mantido internamente.

public static TarArchive FromZstandard(Stream source)

Parameters

source Stream

A fonte do arquivo.

Returns

TarArchive

Um exemplo de Aspose.Zip.Tar.TarArchive

Exceptions

IOException

A corrente padrão é corrompida ou não lida.

InvalidDataException

Os dados são corruptos.

FromZstandard(Redação)

Extratos fornecidos arquivo Zstandard e compõe Aspose.Zip.Tar.TarArchive dos dados extraídos.

Importante: O arquivo padrão é totalmente extraído dentro deste método, seu conteúdo é mantido internamente.

public static TarArchive FromZstandard(string path)

Parameters

path string

O caminho para o arquivo.

Returns

TarArchive

Um exemplo de Aspose.Zip.Tar.TarArchive

Exceptions

ArgumentNullException

path’ is null.

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" está em um formato invalido.

DirectoryNotFoundException

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

FileNotFoundException

O arquivo não foi encontrado.

IOException

A corrente padrão é corrompida ou não lida.

InvalidDataException

Os dados são corruptos.

Save(Fim de transmissão, TarFormat?)

Salve arquivo para o fluxo fornecido.

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

Parameters

output Stream

fluxo de destino.

format TarFormat ?

Defina o formato de cabeçalho tar. o valor zero será tratado como USTar quando possível.

Examples

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

Remarks

Tem que ser escrita.

Exceptions

ArgumentException

output’ is not writable. - or - output’ is the same stream we extract from.- OR -It is impossible to save archive in format’ due to format restrictions.

Save(Tarefa ou Tarefa?)

Salve arquivo para um arquivo de destino fornecido.

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

Parameters

destinationFileName string

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

format TarFormat ?

Defina o formato de cabeçalho tar. o valor zero será tratado como USTar quando possível.

Examples

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

Remarks

É possível salvar um arquivo no mesmo caminho que foi carregado. no entanto, isso não é recomendado porque esta abordagem usa a cópia para um arquivo temporário.

Exceptions

ArgumentException

destinationFileName’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by System.IO.Path.InvalidPathChars.

ArgumentNullException

destinationFileName’ is null.

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.

DirectoryNotFoundException

A destinationFileName’ especificada é invalida (por exemplo, está em um disco não mapeado).

IOException

Um erro I/O ocorreu ao abrir o arquivo.

UnauthorizedAccessException

destinationFileName’ specified a file that is read-only and access is not Read.-or- path specified a directory.-or- The caller does not have the required permission.

NotSupportedException

destinationFileName’ is in an invalid format.

FileNotFoundException

O arquivo não foi encontrado.

SaveGzipped(Fim de transmissão, TarFormat?)

Salve arquivos para o fluxo com compressão gzip.

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

Parameters

output Stream

fluxo de destino.

format TarFormat ?

Defina o formato de cabeçalho tar. o valor zero será tratado como USTar quando possível.

Examples

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);
        }
    }
}

Remarks

Tem que ser escrita.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaveGzipped(Tarefa ou Tarefa?)

Salve arquivos para o arquivo por caminho com compressão gzip.

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

Parameters

path string

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

format TarFormat ?

Defina o formato de cabeçalho tar. o valor zero será tratado como USTar quando possível.

Examples

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");
    }
}

Exceptions

UnauthorizedAccessException

O chamador não tem a permissão necessária. -or- path’ especificado um arquivo ou diretório apenas lido.

ArgumentException

path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

ArgumentNullException

path’ is null.

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.

DirectoryNotFoundException

O path" especificado é invalido (por exemplo, está em um disco não mapeado).

NotSupportedException

path’ is in an invalid format.

Compressão do SaveLZ4(Fim de transmissão, TarFormat?)

Salve arquivos para o fluxo com a compressão LZ4.

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

Parameters

output Stream

fluxo de destino.

format TarFormat ?

Defina o formato de cabeçalho tar. o valor zero será tratado como USTar quando possível.

Examples

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

Remarks

Tem que ser escrita.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

Compressão do SaveLZ4(Tarefa ou Tarefa?)

Salve arquivos para o arquivo por caminho com a compressão LZ4.

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

Parameters

path string

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

format TarFormat ?

Defina o formato de cabeçalho tar. o valor zero será tratado como USTar quando possível.

Examples

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

Exceptions

UnauthorizedAccessException

O chamador não tem a permissão necessária. -or- path’ especificado um arquivo ou diretório apenas lido.

ArgumentException

path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

ArgumentNullException

path’ is null.

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.

DirectoryNotFoundException

O path" especificado é invalido (por exemplo, está em um disco não mapeado).

NotSupportedException

path’ is in an invalid format.

Salvação compressada(Fim de transmissão, TarFormat?)

Salve arquivo para o fluxo com a compressão LZMA.

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

Parameters

output Stream

fluxo de destino.

format TarFormat ?

Defina o formato de cabeçalho tar. o valor zero será tratado como USTar quando possível.

Examples

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);
        }
    }
}

Remarks

Tem que ser escrita.

Importante: o arquivo tar é compostado e então comprimido dentro deste método, o seu conteúdo é mantido internamente.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

Salvação compressada(Tarefa ou Tarefa?)

Salve arquivo para o arquivo por caminho com a compressão lzma.

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

Parameters

path string

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

format TarFormat ?

Defina o formato de cabeçalho tar. o valor zero será tratado como USTar quando possível.

Examples

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");
    }
}

Remarks

Importante: o arquivo tar é compostado e então comprimido dentro deste método, o seu conteúdo é mantido internamente.

Exceptions

UnauthorizedAccessException

O chamador não tem a permissão necessária. -or- path’ especificado um arquivo ou diretório apenas lido.

ArgumentException

path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

ArgumentNullException

path’ is null.

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.

DirectoryNotFoundException

O path" especificado é invalido (por exemplo, está em um disco não mapeado).

NotSupportedException

path’ is in an invalid format.

SaveLzipped(Fim de transmissão, TarFormat?)

Salve arquivos para o fluxo com compressão lzip.

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

Parameters

output Stream

fluxo de destino.

format TarFormat ?

Defina o formato de cabeçalho tar. o valor zero será tratado como USTar quando possível.

Examples

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);
        }
    }
}

Remarks

Tem que ser escrita.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaveLzipped(Tarefa ou Tarefa?)

Salve arquivos para o arquivo por caminho com compressão lzip.

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

Parameters

path string

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

format TarFormat ?

Defina o formato de cabeçalho tar. o valor zero será tratado como USTar quando possível.

Examples

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");
    }
}

Exceptions

UnauthorizedAccessException

O chamador não tem a permissão necessária. -or- path’ especificado um arquivo ou diretório apenas lido.

ArgumentException

path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

ArgumentNullException

path’ is null.

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.

DirectoryNotFoundException

O path" especificado é invalido (por exemplo, está em um disco não mapeado).

NotSupportedException

path’ is in an invalid format.

SaveXzCompressed(Armazém, TarFormat?, XzArchiveSettings)

Salve arquivo para o fluxo com compressão xz.

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

Parameters

output Stream

fluxo de destino.

format TarFormat ?

Defina o formato de cabeçalho tar. o valor zero será tratado como USTar quando possível.

settings XzArchiveSettings

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

Examples

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);
        }
    }
}

Remarks

O fluxo deve ser escrito.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaveXzCompressed(Arquivos, Arquivos, XzArchiveSettings)

Salve arquivos para o caminho por caminho com compressão xz.

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

Parameters

path string

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

format TarFormat ?

Defina o formato de cabeçalho tar. o valor zero será tratado como USTar quando possível.

settings XzArchiveSettings

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

Examples

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");
    }
}

Exceptions

UnauthorizedAccessException

O chamador não tem a permissão necessária. -or- path’ especificado um arquivo ou diretório apenas lido.

ArgumentException

path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

ArgumentNullException

path’ is null.

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.

DirectoryNotFoundException

O path" especificado é invalido (por exemplo, está em um disco não mapeado).

NotSupportedException

path’ is in an invalid format.

SaudaçãoCompressão(Fim de transmissão, TarFormat?)

Salve arquivo para o fluxo com compressão Z.

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

Parameters

output Stream

fluxo de destino.

format TarFormat ?

Defina o formato de cabeçalho tar. o valor zero será tratado como USTar quando possível.

Examples

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);
        }
    }
}

Remarks

Tem que ser escrita.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaudaçãoCompressão(Tarefa ou Tarefa?)

Salve arquivos para o caminho por caminho com compressão Z.

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

Parameters

path string

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

format TarFormat ?

Defina o formato de cabeçalho tar. o valor zero será tratado como USTar quando possível.

Examples

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");
    }
}

Exceptions

UnauthorizedAccessException

O chamador não tem a permissão necessária. -or- path’ especificado um arquivo ou diretório apenas lido.

ArgumentException

path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

ArgumentNullException

path’ is null.

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.

DirectoryNotFoundException

O path" especificado é invalido (por exemplo, está em um disco não mapeado).

NotSupportedException

path’ is in an invalid format.

SaveZstandard(Fim de transmissão, TarFormat?)

Salve arquivo para o fluxo com compressão padrão.

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

Parameters

output Stream

fluxo de destino.

format TarFormat ?

Defina o formato de cabeçalho tar. o valor zero será tratado como USTar quando possível.

Examples

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);
        }
    }
}

Remarks

Tem que ser escrita.

Exceptions

ArgumentNullException

output’ is null.

ArgumentException

output’ is not writable.

SaveZstandard(Tarefa ou Tarefa?)

Salve arquivos para o arquivo por caminho com compressão padrão.

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

Parameters

path string

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

format TarFormat ?

Defina o formato de cabeçalho tar. o valor zero será tratado como USTar quando possível.

Examples

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");
    }
}

Exceptions

UnauthorizedAccessException

O chamador não tem a permissão necessária. -or- path’ especificado um arquivo ou diretório apenas lido.

ArgumentException

path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.

ArgumentNullException

path’ is null.

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.

DirectoryNotFoundException

O path" especificado é invalido (por exemplo, está em um disco não mapeado).

NotSupportedException

path’ is in an invalid format.

 Português