Partilhar via


DbDataReader.ReadAsync Método

Definição

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
Origem:
DbDataReader.cs
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

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

Exceções

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

Aplica-se a

ReadAsync(CancellationToken)

Origem:
DbDataReader.cs
Origem:
DbDataReader.cs
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

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

Exceções

Ocorreu um erro ao executar o texto do comando.

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

Aplica-se a