DbCommand.ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) Yöntem

Tanım

Sağlayıcılar, aşırı yüklemeler için varsayılan olmayan bir uygulama sağlamak üzere bu yöntemi uygulamalıdır ExecuteReader .Providers should implement this method to provide a non-default implementation for ExecuteReader overloads.

Varsayılan uygulama, zaman uyumlu ExecuteReader() yöntemi çağırır ve tamamlanan bir görevi döndürür ve çağıran iş parçacığını engeller.The default implementation invokes the synchronous ExecuteReader() method and returns a completed task, blocking the calling thread. Zaten iptal edilmiş bir iptal belirteci geçirilirse varsayılan uygulama iptal edilen bir görev döndürür.The default implementation will return a cancelled task if passed an already cancelled cancellation token. ExecuteReader tarafından oluşturulan özel durumlar, döndürülen görev özel durumu özelliği aracılığıyla iletilecektir.Exceptions thrown by ExecuteReader will be communicated via the returned Task Exception property.

Bu yöntem, işlemi erken iptal edilecek şekilde istemek için kullanılabilen bir iptal belirtecini kabul eder.This method accepts a cancellation token that can be used to request the operation to be cancelled early. Uygulamalar bu isteği yok sayabilir.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)

Parametreler

behavior
CommandBehavior

Ekstre yürütme ve veri alımı seçenekleri.Options for statement execution and data retrieval.

cancellationToken
CancellationToken

Zaman uyumsuz işlemi iptal etmek için bir belirteç.A token to cancel the asynchronous operation.

Döndürülenler

Task<DbDataReader>

Zaman uyumsuz işlemi temsil eden bir görev.A task representing the asynchronous operation.

Özel durumlar

Komut metni yürütülürken bir hata oluştu.An error occurred while executing the command text.

Geçersiz bir CommandBehavior değer.An invalid CommandBehavior value.

Açıklamalar

Zaman uyumsuz programlama hakkında daha fazla bilgi için bkz. zaman uyumsuz programlama.For more information about asynchronous programming, see Asynchronous Programming.

Şunlara uygulanır

Ayrıca bkz.