DbDataReader.ReadAsync Método

Definição

Namespace:

System.Data.Common

Assembly:

System.Data.Common.dll

Avança de maneira assíncrona o leitor para o próximo registro em um conjunto de resultados.

Sobrecargas

ReadAsync()	Avança de maneira assíncrona o leitor para o próximo registro em um conjunto de resultados.
ReadAsync(CancellationToken)	Avança de maneira assíncrona o leitor para o próximo registro em um conjunto de resultados.

Comentários

Para obter mais informações sobre programação assíncrona, consulte Programação assíncrona.

ReadAsync()

Origem:

DbDataReader.cs

Avança de maneira assíncrona o leitor para o próximo registro em um conjunto de resultados.

public:
 System::Threading::Tasks::Task<bool> ^ ReadAsync();

public System.Threading.Tasks.Task<bool> ReadAsync ();

member this.ReadAsync : unit -> System.Threading.Tasks.Task<bool>

Public Function ReadAsync () As Task(Of Boolean)

Retornos

Task<Boolean>

Um Task<TResult> cuja propriedade Result será true se houver mais linhas de resultados ou false se não houver.

Exceções

DbException

Ocorreu um erro ao executar o texto do comando.

Comentários

A implementação padrão desse método assíncrono invoca sua contraparte síncrona e retorna uma Tarefa concluída, 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.

Outros métodos e propriedades do objeto DbDataReader não devem ser chamados enquanto a Tarefa retornada ainda não tiver sido concluída.

Esse método armazena na tarefa que retorna todas as exceções de não uso que a contraparte síncrona 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 Read().

Confira também

• Visão geral do ADO.NET

ReadAsync(CancellationToken)

Origem:

DbDataReader.cs

Avança de maneira assíncrona o leitor para o próximo registro em um conjunto de resultados.

public:
 virtual System::Threading::Tasks::Task<bool> ^ ReadAsync(System::Threading::CancellationToken cancellationToken);

public virtual System.Threading.Tasks.Task<bool> ReadAsync (System.Threading.CancellationToken cancellationToken);

abstract member ReadAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>
override this.ReadAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>

Public Overridable Function ReadAsync (cancellationToken As CancellationToken) As Task(Of Boolean)

Parâmetros

cancellationToken

CancellationToken

A instrução de cancelamento.

Retornos

Task<Boolean>

Um Task<TResult> cuja propriedade Result será true se houver mais linhas de resultados ou false se não houver.

Exceções

DbException

Ocorreu um erro ao executar o texto do comando.

OperationCanceledException

O token de cancelamento foi cancelado. Essa exceção é armazenada na tarefa retornada.

Comentários

A implementação padrão desse método assíncrono invoca sua contraparte síncrona e retorna uma Tarefa concluída, potencialmente bloqueando o thread de chamada. A implementação padrão também retornará uma tarefa cancelada se for aprovada um token de cancelamento já cancelado.

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 aceita um token de cancelamento que pode ser usado para solicitar a operação a ser cancelada no início. As implementações podem ignorar essa solicitação.

Outros métodos e propriedades do objeto DbDataReader não devem ser chamados enquanto a Tarefa retornada ainda não tiver sido concluída.

Esse método armazena na tarefa que retorna todas as exceções de não uso que a contraparte síncrona 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 Read().

Confira também

• Visão geral do ADO.NET