DbCommand.ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) Yöntem

Tanım

Ad Alanı:
System.Data.Common
Bütünleştirilmiş Kod:
System.Data.Common.dll
Bütünleştirilmiş Kodlar:
netstandard.dll, System.Data.Common.dll
Bütünleştirilmiş Kod:
System.Data.dll
Bütünleştirilmiş Kod:
netstandard.dll
Kaynak:
DbCommand.cs
Kaynak:
DbCommand.cs
Kaynak:
DbCommand.cs
Kaynak:
DbCommand.cs
Kaynak:
DbCommand.cs

Sağlayıcılar, aşırı yüklemeler için varsayılan olmayan bir uygulama sağlamak üzere ExecuteReader bu yöntemi uygulamalıdır.

Varsayılan uygulama zaman uyumlu ExecuteReader() yöntemini çağırır ve tamamlanan bir görev döndürerek çağıran iş parçacığını engeller. Varsayılan uygulama, zaten iptal edilmiş bir iptal belirteci geçirilirse iptal edilmiş bir görev döndürür. ExecuteReader tarafından oluşan özel durumlar, döndürülen Görev Özel Durumu özelliği aracılığıyla iletilecektir.

Bu yöntem, işlemin erken iptalini istemek için kullanılabilecek bir iptal belirteci kabul eder. Uygulamalar bu isteği yoksayabilir.

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

komut yürütme ve veri alma seçeneklerini belirten bir örneği CommandBehavior.

cancellationToken
CancellationToken

Zaman uyumsuz işlemi iptal etmek için bir belirteç.

Döndürülenler

Task<DbDataReader>

Zaman uyumsuz işlemi temsil eden bir görev.

Özel durumlar

DbException

Komut yürütülürken bir hata oluştu.

ArgumentException

Geçersiz CommandBehavior bir değer.

OperationCanceledException

İptal belirteci iptal edildi. Bu özel durum, döndürülen görevde depolanır.

Açıklamalar

Zaman uyumsuz programlama hakkında daha fazla bilgi için bkz. Zaman Uyumsuz Programlama.

Bu yöntem, yöntemin zaman uyumlu karşılık geleninin oluşturabileceği tüm kullanım dışı özel durumları döndürdüğü görevde depolar. Döndürülen görevde bir özel durum depolanırsa, görev beklendiğinde bu özel durum oluşturulur. ArgumentExceptiongibi kullanım özel durumları hâlâ eşzamanlı olarak fırlatılır. Depolanan özel durumlar için tarafından ExecuteDbDataReader(CommandBehavior)oluşan özel durumlara bakın.

Şunlara uygulanır

Ayrıca bkz.