TarEntry.ExtractToFileAsync(String, Boolean, CancellationToken) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Extrai de forma assíncrona a entrada atual para o sistema de arquivos.
public System.Threading.Tasks.Task ExtractToFileAsync(string destinationFileName, bool overwrite, System.Threading.CancellationToken cancellationToken = default);member this.ExtractToFileAsync : string * bool * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Function ExtractToFileAsync (destinationFileName As String, overwrite As Boolean, Optional cancellationToken As CancellationToken = Nothing) As TaskParâmetros
- destinationFileName
- String
O caminho para o arquivo de destino.
- overwrite
- Boolean
truese esse método deve substituir qualquer objeto de sistema de arquivos existente localizado no caminho; false para impedir a destinationFileName substituição.
- cancellationToken
- CancellationToken
O token a ser monitorado para solicitações de cancelamento. O valor padrão é None.
Retornos
Uma tarefa que representa a operação de extração assíncrona.
Exceções
destinationFileName é null.
destinationFileName está vazio.
O diretório pai do destinationFileName qual não existe.
- ou -
overwrite é false e um arquivo já existe em destinationFileName.
- ou -
Existe um diretório com o mesmo nome que destinationFileName.
- ou -
Ocorreu um problema de E/S.
O tipo de entrada não tem suporte.
As permissões são insuficientes.
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 disco ou BlockDevice um CharacterDevice disco.
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 ExtractToFile(String, Boolean).
