TarFile.ExtractToDirectoryAsync Método

Definição

Namespace:

System.Formats.Tar

Assembly:

System.Formats.Tar.dll

Sobrecargas

ExtractToDirectoryAsync(Stream, String, Boolean, CancellationToken)	Extrai de forma assíncrona o conteúdo de um fluxo que representa um arquivo tar no diretório especificado.
ExtractToDirectoryAsync(String, String, Boolean, CancellationToken)	Extrai de forma assíncrona o conteúdo de um arquivo tar para o diretório especificado.

ExtractToDirectoryAsync(Stream, String, Boolean, CancellationToken)

Origem:

TarFile.cs

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

public static System.Threading.Tasks.Task ExtractToDirectoryAsync (System.IO.Stream source, string destinationDirectoryName, bool overwriteFiles, System.Threading.CancellationToken cancellationToken = default);

static member ExtractToDirectoryAsync : System.IO.Stream * string * bool * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Shared Function ExtractToDirectoryAsync (source As Stream, destinationDirectoryName As String, overwriteFiles As Boolean, Optional cancellationToken As CancellationToken = Nothing) As Task

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 a substituição e gerar se algum arquivo ou diretório for encontrado com nomes existentes.

cancellationToken

CancellationToken

O token a se monitorar para solicitações de cancelamento. O valor padrão é None.

Retornos

Task

Uma tarefa que representa a operação de extração assíncrona.

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.

IOException

Ocorreu uma exceção de E/S.

OperationCanceledException

O token de cancelamento foi cancelado. Essa exceção é armazenada na tarefa retornada.

Comentários

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

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

Esse método armazena na tarefa que retorna todas as exceções de não uso que a contraparte síncrona do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas por ExtractToDirectory(Stream, String, Boolean).

ExtractToDirectoryAsync(String, String, Boolean, CancellationToken)

Origem:

TarFile.cs

Extrai de forma assíncrona o conteúdo de um arquivo tar para o diretório especificado.

public static System.Threading.Tasks.Task ExtractToDirectoryAsync (string sourceFileName, string destinationDirectoryName, bool overwriteFiles, System.Threading.CancellationToken cancellationToken = default);

static member ExtractToDirectoryAsync : string * string * bool * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Shared Function ExtractToDirectoryAsync (sourceFileName As String, destinationDirectoryName As String, overwriteFiles As Boolean, Optional cancellationToken As CancellationToken = Nothing) As Task

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 a substituição e gerar se algum arquivo ou diretório for encontrado com nomes existentes.

cancellationToken

CancellationToken

O token a se monitorar para solicitações de cancelamento. O valor padrão é None.

Retornos

Task

Uma tarefa que representa a operação de extração assíncrona.

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.

IOException

Ocorreu uma exceção de E/S.

OperationCanceledException

O token de cancelamento foi cancelado. Essa exceção é armazenada na tarefa retornada.

Comentários

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

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

Esse método armazena na tarefa que retorna todas as exceções de não uso que a contraparte síncrona do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas por ExtractToDirectory(String, String, Boolean).