FileStream.FlushAsync(CancellationToken) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
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().