SqlCommand.ExecuteReaderAsync Yöntem

Tanım

Ad Alanı:: Microsoft.Data.SqlClient

Bütünleştirilmiş Kod:: Microsoft.Data.SqlClient.dll

Paket:: Microsoft.Data.SqlClient v1.0.19269.1

Paket:: Microsoft.Data.SqlClient v1.1.4

Paket:: Microsoft.Data.SqlClient v2.0.1

Paket:: Microsoft.Data.SqlClient v2.1.4

Paket:: Microsoft.Data.SqlClient v3.0.1

Paket:: Microsoft.Data.SqlClient v3.1.0

Paket:: Microsoft.Data.SqlClient v4.0.1

Paket:: Microsoft.Data.SqlClient v4.1.0

Paket:: Microsoft.Data.SqlClient v5.0.0

Paket:: Microsoft.Data.SqlClient v5.1.0

Paket:: Microsoft.Data.SqlClient v5.2.0

Paket:: Microsoft.Data.SqlClient v6.0.2

Paket:: Microsoft.Data.SqlClient v6.1.3

Paket:: Microsoft.Data.SqlClient v7.0.1

Ö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.

Aşırı Yüklemeler

Name	Description
ExecuteReaderAsync()	öğesini adresine gönderen ExecuteReader()CommandText ve bir oluşturan zaman uyumsuz sürümüConnection SqlDataReader. Ö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üConnection SqlDataReader. Ö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üConnection SqlDataReader. İ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)CommandText ve bir İptal belirteci oluşturan zaman uyumsuz sürümüConnection SqlDataReader, komut zaman aşımı süresi dolmadan ö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()

Kaynak:: SqlCommand.cs

Kaynak:: SqlCommand.cs

Kaynak:: SqlCommand.cs

Kaynak:: SqlCommand.cs

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

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

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

override this.ExecuteReaderAsync : unit -> System.Threading.Tasks.Task<Microsoft.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 veya Binary dışında VarBinary bir değer kullanılmıştır Value Stream. Akış hakkında daha fazla bilgi için bkz. SqlClient Akış Desteği.
, , SqlDbType, Char, NCharveya NVarChar dışında VarCharbir Xml değer olarak ayarlandığında ValuekullanılmıştırTextReader.
SqlDbType olarak ayarlandığında Xmlkullanılan Value dışında XmlReader bir değer.

ArgumentException

Geçersiz CommandBehavior bir değer.

InvalidOperationException

Görev tamamlanmadan önce aynı örnek için birden çok kez çağrılması ExecuteReaderAsync() .
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.

SqlException

SQL Server komut metni yürütülürken bir hata döndürdü.
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 XmlReader TextReader 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.

Uyarı

Sunucuda uzun süre çalışan sorgular için, iptal belirteci aracılığıyla sorguları iptal etmeyle ilgili bilinen bir sorun nedeniyle kullanmayı ExecuteReader göz önünde bulundurun. Ayrıca yöntemini kullanarak yürütmeyi Cancel iptal etmeyi de göz önünde bulundurun.

Şunlara uygulanır

ExecuteReaderAsync(CommandBehavior)

Kaynak:: SqlCommand.cs

Kaynak:: SqlCommand.cs

Kaynak:: SqlCommand.cs

Kaynak:: SqlCommand.cs

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

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

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

override this.ExecuteReaderAsync : System.Data.CommandBehavior -> System.Threading.Tasks.Task<Microsoft.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 veya Binary dışında VarBinary bir değer kullanılmıştır Value Stream. Akış hakkında daha fazla bilgi için bkz. SqlClient Akış Desteği.
, , SqlDbType, Char, NCharveya NVarChar dışında VarCharbir Xml değer olarak ayarlandığında ValuekullanılmıştırTextReader.
SqlDbType olarak ayarlandığında Xmlkullanılan Value dışında XmlReader bir değer.

ArgumentException

Geçersiz CommandBehavior bir değer.

InvalidOperationException

Görev tamamlanmadan önce aynı örnek için birden çok kez çağrılması ExecuteReaderAsync(CommandBehavior) .
SqlConnection bir akış işlemi sırasında kapatıldı veya bırakıldı. Akış hakkında daha fazla bilgi için bkz. SqlClient Akış Desteği.

SqlException

SQL Server komut metni yürütülürken bir hata döndürdü.
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 XmlReader TextReader 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.

Şunlara uygulanır

ExecuteReaderAsync(CancellationToken)

Kaynak:: SqlCommand.cs

Kaynak:: SqlCommand.cs

Kaynak:: SqlCommand.cs

Kaynak:: SqlCommand.cs

öğesini adresine gönderen ExecuteReader()CommandText ve bir oluşturan zaman uyumsuz sürümüConnection SqlDataReader. İ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<Microsoft::Data::SqlClient::SqlDataReader ^> ^ ExecuteReaderAsync(System::Threading::CancellationToken cancellationToken);

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

override this.ExecuteReaderAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.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 veya Binary dışında VarBinary bir değer kullanılmıştır Value Stream. Akış hakkında daha fazla bilgi için bkz. SqlClient Akış Desteği.
, , SqlDbType, Char, NCharveya NVarChar dışında VarCharbir Xml değer olarak ayarlandığında ValuekullanılmıştırTextReader.
SqlDbType olarak ayarlandığında Xmlkullanılan Value dışında XmlReader bir değer.

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) .
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.

SqlException

SQL Server komut metni yürütülürken bir hata döndürdü.
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 XmlReader TextReader 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.

Şunlara uygulanır

ExecuteReaderAsync(CommandBehavior, CancellationToken)

Kaynak:: SqlCommand.cs

Kaynak:: SqlCommand.cs

Kaynak:: SqlCommand.cs

Kaynak:: SqlCommand.cs

öğesini öğesine gönderen ExecuteReader(CommandBehavior)CommandText ve bir İptal belirteci oluşturan zaman uyumsuz sürümüConnection SqlDataReader, komut zaman aşımı süresi dolmadan ö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<Microsoft::Data::SqlClient::SqlDataReader ^> ^ ExecuteReaderAsync(System::Data::CommandBehavior behavior, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task<Microsoft.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<Microsoft.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 veya Binary dışında VarBinary bir değer kullanılmıştır Value Stream. Akış hakkında daha fazla bilgi için bkz. SqlClient Akış Desteği.
, , SqlDbType, Char, NCharveya NVarChar dışında VarCharbir Xml değer olarak ayarlandığında ValuekullanılmıştırTextReader.
SqlDbType olarak ayarlandığında Xmlkullanılan Value dışında XmlReader bir değer.

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) .
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.

SqlException

SQL Server komut metni yürütülürken bir hata döndürdü.
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 XmlReader TextReader 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.

Şunlara uygulanır