Stream.DisposeAsync Método

Definição

Namespace:

System.IO

Assembly:

System.Runtime.dll

Origem:

Stream.cs

Libera de forma assíncrona os recursos não gerenciados usados pelo Stream.

public:
 virtual System::Threading::Tasks::ValueTask DisposeAsync();

public virtual System.Threading.Tasks.ValueTask DisposeAsync ();

abstract member DisposeAsync : unit -> System.Threading.Tasks.ValueTask
override this.DisposeAsync : unit -> System.Threading.Tasks.ValueTask

Public Overridable Function DisposeAsync () As ValueTask

Retornos

ValueTask

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

Implementações

DisposeAsync()

Comentários

O DisposeAsync método permite que você execute uma operação de descarte com uso intensivo de recursos sem bloquear o thread main. Essa consideração sobre o desempenho é particularmente importante em um aplicativo da Microsoft Store 8.x ou aplicativo de desktop em que uma operação demorada de fluxo pode bloquear o thread de interface do usuário e fazer seu aplicativo parecer como se não estivesse funcionando. Os métodos assíncronos são usados em conjunto com as async palavras-chave e await no Visual Basic e no C#.

Esse método descarta o fluxo gravando todas as alterações no repositório de backup e fechando o fluxo para liberar recursos.

A chamada DisposeAsync permite que os recursos usados pelo Stream sejam realocados para outras finalidades. Para obter mais informações, consulte Limpando recursos não gerenciados.

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 Dispose().