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
Implements
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
sourceStream’ is not seekable.
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
path’ is null.
O requerente não tem a permissão necessária para o acesso.
O path’ é vazio, contém apenas espaços brancos, ou contém caracteres inválidos.
O acesso ao arquivo path" é negado.
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.
O arquivo no path’ contém uma coluna (:) no meio da linha.
O arquivo não foi encontrado.
O caminho especificado é inválido, como estar em uma unidade não mapeada.
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
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
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
sourceDirectory’ is null.
O chamador não tem a permissão necessária para acessar sourceDirectory'.
sourceDirectory’ contains invalid characters such as “, <, >, or |.
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
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
name’ is too long for tar as of IEEE 1003.1-1998 standard.
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
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
name’ is too long for tar as of IEEE 1003.1-1998 standard.
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
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
path’ is null.
O requerente não tem a permissão necessária para o acesso.
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.
O acesso ao arquivo path” é negado.
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.
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
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 > 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
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
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
O caminho é zero
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.
O chamador não tem a permissão necessária para acessar o diretório existente.
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:”).
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 (:).
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
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
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
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
path’ is null.
O path’ é vazio, contém apenas espaços brancos, ou contém caracteres inválidos.
O acesso ao arquivo path" é negado.
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.
O arquivo no path" está em um formato invalido.
O caminho especificado é inválido, como estar em uma unidade não mapeada.
O arquivo não foi encontrado.
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
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
path’ is null.
O usuário não tem a permissão necessária para acessar
O path’ é vazio, contém apenas espaços brancos, ou contém caracteres inválidos.
O acesso ao arquivo path" é negado.
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.
O arquivo no path" está em um formato invalido.
O caminho especificado é inválido, como estar em uma unidade não mapeada.
O arquivo não foi encontrado.
O arquivo é muito curto.
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
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
Não se pode ler de source’
source’ is null.
source’ is too short.
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
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
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
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
path’ is null.
O path’ é vazio, contém apenas espaços brancos, ou contém caracteres inválidos.
O acesso ao arquivo path" é negado.
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.
O arquivo no path" está em um formato invalido.
O caminho especificado é inválido, como estar em uma unidade não mapeada.
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
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
O arquivo é corrompido.
source’ is not seekable.
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
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
path’ is null.
O path’ é vazio, contém apenas espaços brancos, ou contém caracteres inválidos.
O acesso ao arquivo path" é negado.
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.
O arquivo no path" está em um formato invalido.
O caminho especificado é inválido, como estar em uma unidade não mapeada.
O arquivo não foi encontrado.
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
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
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
path’ is null.
O path’ é vazio, contém apenas espaços brancos, ou contém caracteres inválidos.
O acesso ao arquivo path" é negado.
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.
O arquivo no path" está em um formato invalido.
O caminho especificado é inválido, como estar em uma unidade não mapeada.
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
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
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
path’ is null.
O path’ é vazio, contém apenas espaços brancos, ou contém caracteres inválidos.
O acesso ao arquivo path" é negado.
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.
O arquivo no path" está em um formato invalido.
O caminho especificado é inválido, como estar em uma unidade não mapeada.
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
Um exemplo de Aspose.Zip.Tar.TarArchive
Exceptions
A corrente padrão é corrompida ou não lida.
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
Um exemplo de Aspose.Zip.Tar.TarArchive
Exceptions
path’ is null.
O path’ é vazio, contém apenas espaços brancos, ou contém caracteres inválidos.
O acesso ao arquivo path" é negado.
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.
O arquivo no path" está em um formato invalido.
O caminho especificado é inválido, como estar em uma unidade não mapeada.
O arquivo não foi encontrado.
A corrente padrão é corrompida ou não lida.
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
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
destinationFileName’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by System.IO.Path.InvalidPathChars.
destinationFileName’ is null.
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.
A destinationFileName’ especificada é invalida (por exemplo, está em um disco não mapeado).
Um erro I/O ocorreu ao abrir o arquivo.
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.
destinationFileName’ is in an invalid format.
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
output’ is null.
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
O chamador não tem a permissão necessária. -or- path’ especificado um arquivo ou diretório apenas lido.
path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.
path’ is null.
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.
O path" especificado é invalido (por exemplo, está em um disco não mapeado).
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
output’ is null.
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
O chamador não tem a permissão necessária. -or- path’ especificado um arquivo ou diretório apenas lido.
path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.
path’ is null.
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.
O path" especificado é invalido (por exemplo, está em um disco não mapeado).
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
output’ is null.
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
O chamador não tem a permissão necessária. -or- path’ especificado um arquivo ou diretório apenas lido.
path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.
path’ is null.
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.
O path" especificado é invalido (por exemplo, está em um disco não mapeado).
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
output’ is null.
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
O chamador não tem a permissão necessária. -or- path’ especificado um arquivo ou diretório apenas lido.
path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.
path’ is null.
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.
O path" especificado é invalido (por exemplo, está em um disco não mapeado).
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
output’ is null.
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
O chamador não tem a permissão necessária. -or- path’ especificado um arquivo ou diretório apenas lido.
path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.
path’ is null.
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.
O path" especificado é invalido (por exemplo, está em um disco não mapeado).
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
output’ is null.
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
O chamador não tem a permissão necessária. -or- path’ especificado um arquivo ou diretório apenas lido.
path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.
path’ is null.
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.
O path" especificado é invalido (por exemplo, está em um disco não mapeado).
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
output’ is null.
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
O chamador não tem a permissão necessária. -or- path’ especificado um arquivo ou diretório apenas lido.
path’ is a zero-length string, contains only white space, or contains one or more invalid characters as defined by InvalidPathChars.
path’ is null.
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.
O path" especificado é invalido (por exemplo, está em um disco não mapeado).
path’ is in an invalid format.