DbDataReader.DisposeAsync Método

Definição

Libera de forma assíncrona todos os recursos usados pela instância atual da classe DbDataReader.

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

Retornos

Um ValueTask representando a operação assíncrona.

Implementações

Comentários

Chame Dispose ou DisposeAsync quando terminar de usar o DbDataReader. Chamar um desses métodos deixa o DbDataReader em um estado inutilizável. Depois de descartar, você deve liberar todas as referências para o DbDataReader para que o coletor de lixo possa recuperar a memória que o DbDataReader estava ocupando.

Para obter mais informações, consulte Limpando recursos não gerenciados e implementando um método dispose.

Observação

Sempre descarte antes de lançar sua última referência ao DbDataReader. Caso contrário, os recursos que ele está usando não serão liberados até que o coletor de lixo chame o DbDataReader método do Finalize objeto.

A implementação padrão desse método assíncrono delega ao seu equivalente síncrono e retorna um concluído ValueTask, potencialmente bloqueando o thread de chamada.

Os provedores de dados que dão suporte à programação assíncrona devem substituir a implementação padrão usando operações de E/S assíncronas.

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

Aplica-se a

Produto Versões
.NET Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Standard 2.1