DbCommand.ExecuteDbDataReaderAsync(CommandBehavior, CancellationToken) Yöntem

  • Başvuru

Tanım

Ad Alanı:
System.Data.Common
Bütünleştirilmiş Kod:
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

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, iptal edilmiş bir iptal belirteci geçirilirse iptal edilmiş bir görev döndürür. ExecuteReader tarafından oluşturulan ö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 atabileceği tüm kullanım dışı özel durumları döndürdüğü görevde depolar. Döndürülen görevde bir özel durum depolanıyorsa, görev beklenirken bu özel durum oluşturulur. gibi ArgumentExceptionkullanım özel durumları yine de zaman uyumlu olarak oluşturulur. Depolanan özel durumlar için tarafından oluşan ExecuteDbDataReader(CommandBehavior)özel durumlara bakın.

Şunlara uygulanır

Ayrıca bkz.