Partilhar via

TarFile.ExtractToDirectory Método

Definição

Namespace:
System.Formats.Tar
Assembly:
System.Formats.Tar.dll

Sobrecargas

Nome Description
ExtractToDirectory(Stream, String, Boolean)

Extrai o conteúdo de um fluxo que representa um arquivo tar no diretório especificado.
ExtractToDirectory(Stream, String, TarExtractOptions)
ExtractToDirectory(String, String, Boolean)

Extrai o conteúdo de um arquivo tar no diretório especificado.
ExtractToDirectory(String, String, TarExtractOptions)

ExtractToDirectory(Stream, String, Boolean)

Origem:
TarFile.cs
Origem:
TarFile.cs
Origem:
TarFile.cs
Origem:
TarFile.cs
Origem:
TarFile.cs

Extrai o conteúdo de um fluxo que representa um arquivo tar no diretório especificado.

public:
 static void ExtractToDirectory(System::IO::Stream ^ source, System::String ^ destinationDirectoryName, bool overwriteFiles);
public static void ExtractToDirectory(System.IO.Stream source, string destinationDirectoryName, bool overwriteFiles);
static member ExtractToDirectory : System.IO.Stream * string * bool -> unit
Public Shared Sub ExtractToDirectory (source As Stream, destinationDirectoryName As String, overwriteFiles As Boolean)

Parâmetros

source
Stream

O fluxo que contém o arquivo tar.

destinationDirectoryName
String

O caminho do diretório de destino em que as entradas do sistema de arquivos devem ser extraídas.

overwriteFiles
Boolean

true para substituir arquivos e diretórios em destinationDirectoryName; false para evitar substituição e gerar se quaisquer arquivos ou diretórios forem encontrados com nomes existentes.

Exceções

ArgumentNullException

source ou destinationDirectoryName é null.

DirectoryNotFoundException

O destinationDirectoryName caminho do diretório não foi encontrado.

UnauthorizedAccessException

As permissões são insuficientes.

ArgumentException

Extrair uma das entradas tar resultaria em um arquivo fora do diretório de destino especificado.

- ou -

destinationDirectoryName está vazio.

- ou -

source não dá suporte à leitura.

InvalidDataException

Somente versões .NET 11 e posteriores: a soma de verificação de uma entrada é inválida.

IOException

Ocorreu uma exceção de E/S.

Comentários

Se um link simbólico ou junção no arquivo tar resultar em um arquivo sendo extraído fora do especificado destinationDirectoryName, um IOException será gerado para garantir que a extração permaneça dentro do mesmo diretório.

Se destinationDirectoryName ou qualquer um de seus diretórios pai for uma junção pré-existente ou um link simbólico, o link será seguido e a extração será gravada na pasta de destino final.

Arquivos do tipo BlockDevice, CharacterDeviceou Fifo só podem ser extraídos em plataformas Unix.

A elevação é necessária para extrair um disco ou CharacterDevice um BlockDevice disco.

Esse método não limita o tamanho total extraído ou o número de entradas extraídas do arquivo morto. Ao processar arquivos de fontes não confiáveis, itere sobre as entradas usando TarReadermanualmente e valide se o tamanho e o número de entradas estão dentro dos limites aceitáveis para seu cenário.

Aplica-se a

ExtractToDirectory(Stream, String, TarExtractOptions)

Origem:
TarFile.cs
public:
 static void ExtractToDirectory(System::IO::Stream ^ source, System::String ^ destinationDirectoryName, System::Formats::Tar::TarExtractOptions ^ options);
public static void ExtractToDirectory(System.IO.Stream source, string destinationDirectoryName, System.Formats.Tar.TarExtractOptions options);
static member ExtractToDirectory : System.IO.Stream * string * System.Formats.Tar.TarExtractOptions -> unit
Public Shared Sub ExtractToDirectory (source As Stream, destinationDirectoryName As String, options As TarExtractOptions)

Parâmetros

source
Stream
destinationDirectoryName
String
options
TarExtractOptions

Aplica-se a

ExtractToDirectory(String, String, Boolean)

Origem:
TarFile.cs
Origem:
TarFile.cs
Origem:
TarFile.cs
Origem:
TarFile.cs
Origem:
TarFile.cs

Extrai o conteúdo de um arquivo tar no diretório especificado.

public:
 static void ExtractToDirectory(System::String ^ sourceFileName, System::String ^ destinationDirectoryName, bool overwriteFiles);
public static void ExtractToDirectory(string sourceFileName, string destinationDirectoryName, bool overwriteFiles);
static member ExtractToDirectory : string * string * bool -> unit
Public Shared Sub ExtractToDirectory (sourceFileName As String, destinationDirectoryName As String, overwriteFiles As Boolean)

Parâmetros

sourceFileName
String

O caminho do arquivo tar a ser extraído.

destinationDirectoryName
String

O caminho do diretório de destino em que as entradas do sistema de arquivos devem ser extraídas.

overwriteFiles
Boolean

true para substituir arquivos e diretórios em destinationDirectoryName; false para evitar substituição e gerar se quaisquer arquivos ou diretórios forem encontrados com nomes existentes.

Exceções

ArgumentNullException

sourceFileName ou destinationDirectoryName é null.

DirectoryNotFoundException

O destinationDirectoryName caminho do diretório não foi encontrado.

FileNotFoundException

O sourceFileName caminho do arquivo não foi encontrado.

UnauthorizedAccessException

As permissões são insuficientes.

ArgumentException

Extrair uma das entradas tar resultaria em um arquivo fora do diretório de destino especificado.

- ou -

sourceFileName ou destinationDirectoryName está vazio.

InvalidDataException

Somente versões .NET 11 e posteriores: a soma de verificação de uma entrada é inválida.

IOException

Ocorreu uma exceção de E/S.

Comentários

Se um link simbólico ou junção no arquivo tar resultar em um arquivo sendo extraído fora do especificado destinationDirectoryName, um IOException será gerado para garantir que a extração permaneça dentro do mesmo diretório.

Se destinationDirectoryName ou qualquer um de seus diretórios pai for uma junção pré-existente ou um link simbólico, o link será seguido e a extração será gravada na pasta de destino final.

Arquivos do tipo BlockDevice, CharacterDeviceou Fifo só podem ser extraídos em plataformas Unix.

A elevação é necessária para extrair um disco ou CharacterDevice um BlockDevice disco.

Esse método não limita o tamanho total extraído ou o número de entradas extraídas do arquivo morto. Ao processar arquivos de fontes não confiáveis, itere sobre as entradas usando TarReadermanualmente e valide se o tamanho e o número de entradas estão dentro dos limites aceitáveis para seu cenário.

Aplica-se a

ExtractToDirectory(String, String, TarExtractOptions)

Origem:
TarFile.cs
public:
 static void ExtractToDirectory(System::String ^ sourceFileName, System::String ^ destinationDirectoryName, System::Formats::Tar::TarExtractOptions ^ options);
public static void ExtractToDirectory(string sourceFileName, string destinationDirectoryName, System.Formats.Tar.TarExtractOptions options);
static member ExtractToDirectory : string * string * System.Formats.Tar.TarExtractOptions -> unit
Public Shared Sub ExtractToDirectory (sourceFileName As String, destinationDirectoryName As String, options As TarExtractOptions)

Parâmetros

sourceFileName
String
destinationDirectoryName
String
options
TarExtractOptions

Aplica-se a