SqlDataReader.NextResultAsync(CancellationToken) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Uma versão assíncrona de NextResult(), que avança o leitor de dados para o resultado seguinte, ao ler os resultados das instruções batch Transact-SQL.
O token de cancelamento pode ser usado para pedir que a operação seja abandonada antes do tempo limite do comando. As exceções serão reportadas através do objeto Task devolvido.
public:
override System::Threading::Tasks::Task<bool> ^ NextResultAsync(System::Threading::CancellationToken cancellationToken);public override System.Threading.Tasks.Task<bool> NextResultAsync(System.Threading.CancellationToken cancellationToken);override this.NextResultAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<bool>Public Overrides Function NextResultAsync (cancellationToken As CancellationToken) As Task(Of Boolean)Parâmetros
- cancellationToken
- CancellationToken
A instrução de cancelamento.
Devoluções
Uma tarefa que representa a operação assíncrona.
Exceções
Chamar NextResultAsync(CancellationToken) mais do que uma vez para a mesma instância antes da conclusão da tarefa.
Context Connection=true está especificado no cadeia de ligação.
O SQL Server devolveu um erro ao executar o texto do comando.
O token de cancelamento foi cancelado. Esta exceção é armazenada na tarefa devolvida.
Observações
Para mais informações sobre programação assíncrona no .NET Framework Data Provider para SQL Server, consulte Programação Assíncrona.
Este método armazena na tarefa que devolve todas as exceções de não-utilização que o equivalente síncrono do método pode lançar. Se uma exceção for armazenada na tarefa devolvida, essa exceção será lançada quando a tarefa for aguardada. As exceções de uso, como ArgumentException, ainda são lançadas de forma síncrona. Para as exceções armazenadas, veja as exceções lançadas por NextResult().