FileStream.FlushAsync(CancellationToken) Método

Definição

O processo asíncrono limpa todos os buffers deste fluxo, faz com que quaisquer dados armazenados no ficheiro sejam escritos no ficheiro e monitoriza pedidos de cancelamento.

public:
 override System::Threading::Tasks::Task ^ FlushAsync(System::Threading::CancellationToken cancellationToken);
public override System.Threading.Tasks.Task FlushAsync(System.Threading.CancellationToken cancellationToken);
[System.Runtime.InteropServices.ComVisible(false)]
public override System.Threading.Tasks.Task FlushAsync(System.Threading.CancellationToken cancellationToken);
override this.FlushAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task
[<System.Runtime.InteropServices.ComVisible(false)>]
override this.FlushAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task
abstract member FlushAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.FlushAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Overrides Function FlushAsync (cancellationToken As CancellationToken) As Task

Parâmetros

cancellationToken
CancellationToken

O token para monitorizar pedidos de cancelamento.

Devoluções

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

Atributos

Exceções

O riacho foi eliminado.

O token de cancelamento foi cancelado. Esta exceção é armazenada na tarefa devolvida.

Observações

Este método limpa os buffers de fluxo .NET para o ficheiro, mas não limpa buffers intermédios no sistema operativo. Para garantir que todos os dados armazenados em buffer são escritos no dispositivo de armazenamento subjacente, use o Flush(Boolean) método com o flushToDisk parâmetro definido como true.

Se a operação for cancelada antes de ser concluída, a tarefa devolvida contém o Canceled valor da Status propriedade. Se o handle do ficheiro for eliminado, a tarefa devolvida contém a ObjectDisposedException exceção na Exception propriedade.

Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas por Flush().

Aplica-se a

Ver também