DbCommand.ExecuteDbDataReaderAsync(CommandBehavior, 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.
Os fornecedores devem implementar este método para fornecer uma implementação não padrão para ExecuteReader sobrecargas.
A implementação padrão invoca o método síncrono ExecuteReader() e devolve uma tarefa concluída, bloqueando a thread que chama. A implementação por defeito devolverá uma tarefa cancelada se for recebida um token de cancelamento já cancelado. As exceções lançadas pelo ExecuteReader serão comunicadas através da propriedade de Exceção de Tarefa devolvida.
Este método aceita um token de cancelamento que pode ser usado para pedir que a operação seja cancelada antecipadamente. As implementações podem ignorar este pedido.
protected:
virtual System::Threading::Tasks::Task<System::Data::Common::DbDataReader ^> ^ ExecuteDbDataReaderAsync(System::Data::CommandBehavior behavior, System::Threading::CancellationToken cancellationToken);protected virtual System.Threading.Tasks.Task<System.Data.Common.DbDataReader> ExecuteDbDataReaderAsync(System.Data.CommandBehavior behavior, System.Threading.CancellationToken cancellationToken);abstract member ExecuteDbDataReaderAsync : System.Data.CommandBehavior * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Data.Common.DbDataReader>
override this.ExecuteDbDataReaderAsync : System.Data.CommandBehavior * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Data.Common.DbDataReader>Protected Overridable Function ExecuteDbDataReaderAsync (behavior As CommandBehavior, cancellationToken As CancellationToken) As Task(Of DbDataReader)Parâmetros
- behavior
- CommandBehavior
Uma instância de CommandBehavior, especificando opções para execução de comandos e recuperação de dados.
- cancellationToken
- CancellationToken
Um token para cancelar a operação assíncrona.
Devoluções
Uma tarefa que representa a operação assíncrona.
Exceções
Ocorreu um erro durante a execução do comando.
Um valor inválido CommandBehavior .
O token de cancelamento foi cancelado. Esta exceção é armazenada na tarefa devolvida.
Observações
Para mais informações sobre programação assíncrona, veja 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 ExecuteDbDataReader(CommandBehavior).