SqlCommand.ExecuteReaderAsync Yöntem

Tanım

Ad Alanı:

System.Data.SqlClient

Bütünleştirilmiş Kod:

System.Data.dll

bu SqlCommandtarafından açıklanan Transact-SQL deyiminin veya saklı yordamın zaman uyumsuz yürütülmesini başlatır.

Aşırı Yüklemeler

Name	Description
ExecuteReaderAsync()	öğesini adresine gönderen ExecuteReader()CommandText ve bir oluşturan zaman uyumsuz sürümüConnectionSqlDataReader. Özel durumlar döndürülen Görev nesnesi aracılığıyla bildirilir.
ExecuteReaderAsync(CommandBehavior)	öğesini öğesine gönderen ExecuteReader(CommandBehavior)CommandTextve bir oluşturan zaman uyumsuz sürümüConnectionSqlDataReader. Özel durumlar döndürülen Görev nesnesi aracılığıyla bildirilir.
ExecuteReaderAsync(CancellationToken)	öğesini adresine gönderen ExecuteReader()CommandText ve bir oluşturan zaman uyumsuz sürümüConnectionSqlDataReader. İptal belirteci, komut zaman aşımı tamamlanmadan önce işlemin terk edilmesi isteğinde bulunmak için kullanılabilir. Özel durumlar döndürülen Görev nesnesi aracılığıyla bildirilir.
ExecuteReaderAsync(CommandBehavior, CancellationToken)	öğesini öğesine gönderen ExecuteReader(CommandBehavior)CommandTextve bir oluşturan zaman uyumsuz sürümü ConnectionSqlDataReader İptal belirteci, komut zaman aşımı tamamlanmadan önce işlemin terk edilmesi isteğinde bulunmak için kullanılabilir. Özel durumlar döndürülen Görev nesnesi aracılığıyla bildirilir.

Açıklamalar

SQL Server için .NET Framework Veri Sağlayıcısı zaman uyumsuz programlama hakkında daha fazla bilgi için bkz. Asynchronous Programming.

ExecuteReaderAsync()

öğesini adresine gönderen ExecuteReader()CommandText ve bir oluşturan zaman uyumsuz sürümüConnectionSqlDataReader. Özel durumlar döndürülen Görev nesnesi aracılığıyla bildirilir.

public:
 System::Threading::Tasks::Task<System::Data::SqlClient::SqlDataReader ^> ^ ExecuteReaderAsync();

public System.Threading.Tasks.Task<System.Data.SqlClient.SqlDataReader> ExecuteReaderAsync();

override this.ExecuteReaderAsync : unit -> System.Threading.Tasks.Task<System.Data.SqlClient.SqlDataReader>

Public Function ExecuteReaderAsync () As Task(Of SqlDataReader)

Döndürülenler

Task<SqlDataReader>

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

Özel durumlar

InvalidCastException

SqlDbType olarak ayarlandığında İkili veya Value dışında bir değer kullanıldıStream. Akış hakkında daha fazla bilgi için bkz. SqlClient Akış Desteği.

-veya-

SqlDbType Olarak ayarlandığında Char, NChar, NVarChar, VarChar veya Value dışında bir değer kullanıldıTextReader.

-veya-

SqlDbType olarak ayarlandığında Value dışında bir değer kullanıldıXmlReader.

ArgumentException

Geçersiz CommandBehavior bir değer.

InvalidOperationException

Görev tamamlanmadan önce aynı örnek için birden çok kez çağrılması ExecuteReaderAsync() .

-veya-

Akış SqlConnection işlemi sırasında kapatılan veya bırakılan. Akış hakkında daha fazla bilgi için bkz. SqlClient Akış Desteği.

-veya-

Context Connection=true bağlantı dizesi belirtilir.

SqlException

SQL Server komut metni yürütülürken bir hata döndürdü.

-veya-

Akış işlemi sırasında zaman aşımı oluştu. Akış hakkında daha fazla bilgi için bkz. SqlClient Akış Desteği.

IOException

Akış işlemi sırasında bir Streamveya XmlReaderTextReader nesnesinde hata oluştu. Akış hakkında daha fazla bilgi için bkz. SqlClient Akış Desteği.

ObjectDisposedException

bir Streamakış işlemi sırasında , XmlReader veya TextReader nesnesi kapatıldı. Akış hakkında daha fazla bilgi için bkz. SqlClient Akış Desteği.

Açıklamalar

SQL Server için .NET Framework Veri Sağlayıcısı zaman uyumsuz programlama hakkında daha fazla bilgi için bkz. Asynchronous Programming.

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 ExecuteReader()oluşan özel durumlara bakın.

Ayrıca bkz.

• ADO.NET’e Genel Bakış

ExecuteReaderAsync(CommandBehavior)

öğesini öğesine gönderen ExecuteReader(CommandBehavior)CommandTextve bir oluşturan zaman uyumsuz sürümüConnectionSqlDataReader. Özel durumlar döndürülen Görev nesnesi aracılığıyla bildirilir.

public:
 System::Threading::Tasks::Task<System::Data::SqlClient::SqlDataReader ^> ^ ExecuteReaderAsync(System::Data::CommandBehavior behavior);

public System.Threading.Tasks.Task<System.Data.SqlClient.SqlDataReader> ExecuteReaderAsync(System.Data.CommandBehavior behavior);

override this.ExecuteReaderAsync : System.Data.CommandBehavior -> System.Threading.Tasks.Task<System.Data.SqlClient.SqlDataReader>

Public Function ExecuteReaderAsync (behavior As CommandBehavior) As Task(Of SqlDataReader)

Parametreler

behavior

CommandBehavior

Deyim yürütme ve veri alma seçenekleri. olarak ayarlandığında Default, ReadAsync(CancellationToken) tam bir Görev döndürmeden önce satırın tamamını okur.

Döndürülenler

Task<SqlDataReader>

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

Özel durumlar

InvalidCastException

SqlDbType olarak ayarlandığında İkili veya Value dışında bir değer kullanıldıStream. Akış hakkında daha fazla bilgi için bkz. SqlClient Akış Desteği.

-veya-

SqlDbType Olarak ayarlandığında Char, NChar, NVarChar, VarChar veya Value dışında bir değer kullanıldıTextReader.

-veya-

SqlDbType olarak ayarlandığında Value dışında bir değer kullanıldıXmlReader.

ArgumentException

Geçersiz CommandBehavior bir değer.

InvalidOperationException

Görev tamamlanmadan önce aynı örnek için birden çok kez çağrılması ExecuteReaderAsync(CommandBehavior) .

-veya-

Akış SqlConnection işlemi sırasında kapatılan veya bırakılan. Akış hakkında daha fazla bilgi için bkz. SqlClient Akış Desteği.

-veya-

Context Connection=true bağlantı dizesi belirtilir.

SqlException

SQL Server komut metni yürütülürken bir hata döndürdü.

-veya-

Akış işlemi sırasında zaman aşımı oluştu. Akış hakkında daha fazla bilgi için bkz. SqlClient Akış Desteği.

IOException

Akış işlemi sırasında bir Streamveya XmlReaderTextReader nesnesinde hata oluştu. Akış hakkında daha fazla bilgi için bkz. SqlClient Akış Desteği.

ObjectDisposedException

bir Streamakış işlemi sırasında , XmlReader veya TextReader nesnesi kapatıldı. Akış hakkında daha fazla bilgi için bkz. SqlClient Akış Desteği.

Açıklamalar

SQL Server için .NET Framework Veri Sağlayıcısı zaman uyumsuz programlama hakkında daha fazla bilgi için bkz. Asynchronous Programming.

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 ExecuteReader(CommandBehavior)oluşan özel durumlara bakın.

Ayrıca bkz.

• ADO.NET’e Genel Bakış

ExecuteReaderAsync(CancellationToken)

öğesini adresine gönderen ExecuteReader()CommandText ve bir oluşturan zaman uyumsuz sürümüConnectionSqlDataReader.

İptal belirteci, komut zaman aşımı tamamlanmadan önce işlemin terk edilmesi isteğinde bulunmak için kullanılabilir. Özel durumlar döndürülen Görev nesnesi aracılığıyla bildirilir.

public:
 System::Threading::Tasks::Task<System::Data::SqlClient::SqlDataReader ^> ^ ExecuteReaderAsync(System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task<System.Data.SqlClient.SqlDataReader> ExecuteReaderAsync(System.Threading.CancellationToken cancellationToken);

override this.ExecuteReaderAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Data.SqlClient.SqlDataReader>

Public Function ExecuteReaderAsync (cancellationToken As CancellationToken) As Task(Of SqlDataReader)

Parametreler

cancellationToken

CancellationToken

İptal talimatı.

Döndürülenler

Task<SqlDataReader>

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

Özel durumlar

InvalidCastException

SqlDbType olarak ayarlandığında İkili veya Value dışında bir değer kullanıldıStream. Akış hakkında daha fazla bilgi için bkz. SqlClient Akış Desteği.

-veya-

SqlDbType Olarak ayarlandığında Char, NChar, NVarChar, VarChar veya Value dışında bir değer kullanıldıTextReader.

-veya-

SqlDbType olarak ayarlandığında Value dışında bir değer kullanıldıXmlReader.

ArgumentException

Geçersiz CommandBehavior bir değer.

InvalidOperationException

Görev tamamlanmadan önce aynı örnek için birden çok kez çağrılması ExecuteReaderAsync(CommandBehavior, CancellationToken) .

-veya-

Akış SqlConnection işlemi sırasında kapatılan veya bırakılan. Akış hakkında daha fazla bilgi için bkz. SqlClient Akış Desteği.

-veya-

Context Connection=true bağlantı dizesi belirtilir.

SqlException

SQL Server komut metni yürütülürken bir hata döndürdü.

-veya-

Akış işlemi sırasında zaman aşımı oluştu. Akış hakkında daha fazla bilgi için bkz. SqlClient Akış Desteği.

IOException

Akış işlemi sırasında bir Streamveya XmlReaderTextReader nesnesinde hata oluştu. Akış hakkında daha fazla bilgi için bkz. SqlClient Akış Desteği.

ObjectDisposedException

bir Streamakış işlemi sırasında , XmlReader veya TextReader nesnesi kapatıldı. Akış hakkında daha fazla bilgi için bkz. SqlClient Akış Desteği.

OperationCanceledException

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

Açıklamalar

SQL Server için .NET Framework Veri Sağlayıcısı zaman uyumsuz programlama hakkında daha fazla bilgi için bkz. Asynchronous Programming.

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 ExecuteReader()oluşan özel durumlara bakın.

Ayrıca bkz.

• ADO.NET’e Genel Bakış

ExecuteReaderAsync(CommandBehavior, CancellationToken)

öğesini öğesine gönderen ExecuteReader(CommandBehavior)CommandTextve bir oluşturan zaman uyumsuz sürümü ConnectionSqlDataReader

İptal belirteci, komut zaman aşımı tamamlanmadan önce işlemin terk edilmesi isteğinde bulunmak için kullanılabilir. Özel durumlar döndürülen Görev nesnesi aracılığıyla bildirilir.

public:
 System::Threading::Tasks::Task<System::Data::SqlClient::SqlDataReader ^> ^ ExecuteReaderAsync(System::Data::CommandBehavior behavior, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task<System.Data.SqlClient.SqlDataReader> ExecuteReaderAsync(System.Data.CommandBehavior behavior, System.Threading.CancellationToken cancellationToken);

override this.ExecuteReaderAsync : System.Data.CommandBehavior * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Data.SqlClient.SqlDataReader>

Public Function ExecuteReaderAsync (behavior As CommandBehavior, cancellationToken As CancellationToken) As Task(Of SqlDataReader)

Parametreler

behavior

CommandBehavior

Deyim yürütme ve veri alma seçenekleri. olarak ayarlandığında Default, ReadAsync(CancellationToken) tam bir Görev döndürmeden önce satırın tamamını okur.

cancellationToken

CancellationToken

İptal talimatı.

Döndürülenler

Task<SqlDataReader>

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

Özel durumlar

InvalidCastException

SqlDbType olarak ayarlandığında İkili veya Value dışında bir değer kullanıldıStream. Akış hakkında daha fazla bilgi için bkz. SqlClient Akış Desteği.

-veya-

SqlDbType Olarak ayarlandığında Char, NChar, NVarChar, VarChar veya Value dışında bir değer kullanıldıTextReader.

-veya-

SqlDbType olarak ayarlandığında Value dışında bir değer kullanıldıXmlReader.

ArgumentException

Geçersiz CommandBehavior bir değer.

InvalidOperationException

Görev tamamlanmadan önce aynı örnek için birden çok kez çağrılması ExecuteReaderAsync(CommandBehavior, CancellationToken) .

-veya-

Akış SqlConnection işlemi sırasında kapatılan veya bırakılan. Akış hakkında daha fazla bilgi için bkz. SqlClient Akış Desteği.

-veya-

Context Connection=true bağlantı dizesi belirtilir.

SqlException

SQL Server komut metni yürütülürken bir hata döndürdü.

-veya-

Akış işlemi sırasında zaman aşımı oluştu. Akış hakkında daha fazla bilgi için bkz. SqlClient Akış Desteği.

IOException

Akış işlemi sırasında bir Streamveya XmlReaderTextReader nesnesinde hata oluştu. Akış hakkında daha fazla bilgi için bkz. SqlClient Akış Desteği.

ObjectDisposedException

bir Streamakış işlemi sırasında , XmlReader veya TextReader nesnesi kapatıldı. Akış hakkında daha fazla bilgi için bkz. SqlClient Akış Desteği.

OperationCanceledException

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

Açıklamalar

SQL Server için .NET Framework Veri Sağlayıcısı zaman uyumsuz programlama hakkında daha fazla bilgi için bkz. Asynchronous Programming.

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 ExecuteReader(CommandBehavior)oluşan özel durumlara bakın.

Ayrıca bkz.

• ADO.NET’e Genel Bakış