Compartilhar via


DbDataReader.NextResultAsync Método

Definição

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

Uma tarefa cuja propriedade Result será true se houver mais conjuntos 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 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

Aplica-se a

NextResultAsync(CancellationToken)

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

Um Task<TResult> cuja propriedade Result será true se houver mais conjuntos 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 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

Aplica-se a