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

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

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.

ADO.NET’e Genel Bakış