DbCommand.ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) Método

Definição

Os provedores devem implementar esse método para fornecer uma implementação não padrão para sobrecargas ExecuteReader.Providers should implement this method to provide a non-default implementation for ExecuteReader overloads.

A implementação padrão invoca o método ExecuteReader() síncrono e retorna uma tarefa concluída, bloqueando o thread de chamada.The default implementation invokes the synchronous ExecuteReader() method and returns a completed task, blocking the calling thread. A implementação padrão retornará uma tarefa cancelada se já tiver passado um token de cancelamento.The default implementation will return a cancelled task if passed an already cancelled cancellation token. Exceções geradas por ExecuteReader serão comunicadas por meio da propriedade Exceção de Tarefa retornada.Exceptions thrown by ExecuteReader will be communicated via the returned Task Exception property.

Esse método aceita um token de cancelamento que pode ser usado para solicitar a operação a ser cancelada no início.This method accepts a cancellation token that can be used to request the operation to be cancelled early. As implementações podem ignorar essa solicitação.Implementations may ignore this request.

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

Opções de recuperação de dados e execução de instrução.Options for statement execution and data retrieval.

cancellationToken
CancellationToken

Um token para cancelar a operação assíncrona.A token to cancel the asynchronous operation.

Retornos

Task<DbDataReader>

Uma tarefa que representa a operação assíncrona.A task representing the asynchronous operation.

Exceções

Ocorreu um erro ao executar o texto do comando.An error occurred while executing the command text.

Um valor CommandBehavior inválido.An invalid CommandBehavior value.

Comentários

Para obter mais informações sobre programação assíncrona, consulte programação assíncrona.For more information about asynchronous programming, see Asynchronous Programming.

Aplica-se a