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 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().
