DbDataReader.NextResultAsync Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Avança de forma assíncrona o leitor para o próximo resultado ao ler os resultados de um lote de instruções.
Sobrecargas
| Nome | Description |
|---|---|
| NextResultAsync() |
Avança de forma assíncrona o leitor para o próximo resultado ao ler os resultados de um lote de instruções. |
| NextResultAsync(CancellationToken) |
Avança de forma assíncrona o leitor para o próximo resultado 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()
Avança de forma assíncrona o leitor para o próximo resultado 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 Result propriedade é true se houver mais conjuntos de resultados ou false se não houver.
Exceções
Ocorreu um erro durante a execução do 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 invocados enquanto a Tarefa retornada ainda não estiver 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)
Avança de forma assíncrona o leitor para o próximo resultado 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
Uma Task<TResult> propriedade cuja Result propriedade será true se houver mais conjuntos de resultados ou false se não houver.
Exceções
Ocorreu um erro durante a execução do 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 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 que a operação seja cancelada antecipadamente. As implementações podem ignorar essa solicitação.
Outros métodos e propriedades do objeto DbDataReader não devem ser invocados enquanto a Tarefa retornada ainda não estiver 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().