TarFile.CreateFromDirectoryAsync Método

Definição

Namespace:

System.Formats.Tar

Assembly:

System.Formats.Tar.dll

Sobrecargas

CreateFromDirectoryAsync(String, Stream, Boolean, CancellationToken)	Cria de forma assíncrona um fluxo tar que contém todas as entradas do sistema de arquivos do diretório especificado.
CreateFromDirectoryAsync(String, String, Boolean, CancellationToken)	Cria de forma assíncrona um arquivo tar do conteúdo do diretório especificado e os gera no caminho especificado. Opcionalmente, pode incluir o diretório base como o prefixo para os nomes de entrada.

CreateFromDirectoryAsync(String, Stream, Boolean, CancellationToken)

Origem:

TarFile.cs

Cria de forma assíncrona um fluxo tar que contém todas as entradas do sistema de arquivos do diretório especificado.

public static System.Threading.Tasks.Task CreateFromDirectoryAsync (string sourceDirectoryName, System.IO.Stream destination, bool includeBaseDirectory, System.Threading.CancellationToken cancellationToken = default);

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

Public Shared Function CreateFromDirectoryAsync (sourceDirectoryName As String, destination As Stream, includeBaseDirectory As Boolean, Optional cancellationToken As CancellationToken = Nothing) As Task

Parâmetros

sourceDirectoryName

String

O caminho do diretório para arquivar.

destination

Stream

O fluxo de destino do arquivo morto.

includeBaseDirectory

Boolean

true para incluir o nome do diretório base como o primeiro segmento de caminho em todos os nomes das entradas de arquivo morto. false para excluir o nome do diretório base dos caminhos de nome de entrada.

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 criação assíncrona.

Exceções

ArgumentNullException

sourceDirectoryName ou destination é null.

ArgumentException

sourceDirectoryName está vazio.

- ou -

destination não dá suporte à gravação.

DirectoryNotFoundException

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

IOException

Ocorreu uma exceção de E/S.

OperationCanceledException

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

Comentários

Esse método armazena na tarefa que retorna todas as exceções de não uso que o equivalente síncrono 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 CreateFromDirectory(String, Stream, Boolean).

CreateFromDirectoryAsync(String, String, Boolean, CancellationToken)

Origem:

TarFile.cs

Cria de forma assíncrona um arquivo tar do conteúdo do diretório especificado e os gera no caminho especificado. Opcionalmente, pode incluir o diretório base como o prefixo para os nomes de entrada.

public static System.Threading.Tasks.Task CreateFromDirectoryAsync (string sourceDirectoryName, string destinationFileName, bool includeBaseDirectory, System.Threading.CancellationToken cancellationToken = default);

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

Public Shared Function CreateFromDirectoryAsync (sourceDirectoryName As String, destinationFileName As String, includeBaseDirectory As Boolean, Optional cancellationToken As CancellationToken = Nothing) As Task

Parâmetros

sourceDirectoryName

String

O caminho do diretório para arquivar.

destinationFileName

String

O caminho do arquivo morto de destino.

includeBaseDirectory

Boolean

true para incluir o nome do diretório base como o primeiro segmento de caminho em todos os nomes das entradas de arquivo morto. false para excluir o nome do diretório base dos caminhos de nome de entrada.

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 criação assíncrona.

Exceções

ArgumentNullException

sourceDirectoryName ou destinationFileName é null.

ArgumentException

sourceDirectoryName ou destinationFileName está vazio.

DirectoryNotFoundException

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

IOException

Ocorreu uma exceção de E/S.

OperationCanceledException

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

Comentários

Esse método armazena na tarefa que retorna todas as exceções de não uso que o equivalente síncrono 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 CreateFromDirectory(String, String, Boolean).