DbDataReader.NextResultAsync Método

Definição

Namespace:

System.Data.Common

Assembly:

System.Data.Common.dll

Avança de maneira assíncrona o leitor para o resultado seguinte ao ler os resultados de um lote de instruções.

Sobrecargas

NextResultAsync()	Avança de maneira assíncrona o leitor para o resultado seguinte ao ler os resultados de um lote de instruções.
NextResultAsync(CancellationToken)	Avança de maneira assíncrona o leitor para o resultado seguinte ao ler os resultados de um lote de instruções.

Comentários

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

NextResultAsync()

Origem:

DbDataReader.cs

Avança de maneira assíncrona o leitor para o resultado seguinte ao ler os resultados de um lote de instruções.

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

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

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

Public Function NextResultAsync () As Task(Of Boolean)

Retornos

Task<Boolean>

Uma tarefa cuja propriedade Result será true se houver mais conjuntos 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 seu equivalente síncrono 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 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 NextResult().

Confira também

• Visão geral do ADO.NET

NextResultAsync(CancellationToken)

Origem:

DbDataReader.cs

Avança de maneira assíncrona o leitor para o resultado seguinte ao ler os resultados de um lote de instruções.

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

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

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

Public Overridable Function NextResultAsync (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 conjuntos 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 seu equivalente síncrono e retorna uma Tarefa concluída, potencialmente bloqueando o thread de chamada. A implementação padrão também retorna uma tarefa cancelada se passar 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 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 NextResult().

Confira também

• Visão geral do ADO.NET