SqlCommand.ExecuteReaderAsync Yöntem

Tanım

Ad Alanı:

Microsoft.Data.SqlClient

Bütünleştirilmiş Kod:

Microsoft.Data.SqlClient.dll

Paket:

Microsoft.Data.SqlClient v5.2.0

Aşırı Yüklemeler

ExecuteReaderAsync()	öğesine gönderen CommandText ve bir oluşturan zaman uyumsuz sürümü ExecuteReader()SqlDataReader .Connection Özel durumlar döndürülen Görev nesnesi ile bildirilir.
ExecuteReaderAsync(CommandBehavior)	öğesini öğesine gönderen CommandTextConnection ve bir SqlDataReader oluşturan zaman uyumsuz sürümü ExecuteReader(CommandBehavior) . Özel durumlar döndürülen Görev nesnesi ile bildirilir.
ExecuteReaderAsync(CancellationToken)	öğesine gönderen CommandText ve bir oluşturan zaman uyumsuz sürümü ExecuteReader()SqlDataReader .Connection İptali belirteci, işlem komut zaman aşımı dolmadan işlemin iptal edilmesini istemek için kullanılabilir. Özel durumlar döndürülen Görev nesnesi ile bildirilir.
ExecuteReaderAsync(CommandBehavior, CancellationToken)	öğesini öğesine gönderen CommandTextConnection ve bir SqlDataReader İptal belirteci oluşturan zaman uyumsuz sürümü ExecuteReader(CommandBehavior) , komut zaman aşımı sona ermeden önce işlemin terk edilmesi isteğinde bulunmak için kullanılabilir. Özel durumlar döndürülen Görev nesnesi ile bildirilir.

ExecuteReaderAsync()

öğesine gönderen CommandText ve bir oluşturan zaman uyumsuz sürümü ExecuteReader()SqlDataReader .Connection Özel durumlar döndürülen Görev nesnesi ile 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 Streamİkili veya VarBinary dışında bir değer kullanılmıştırValue. Akış hakkında daha fazla bilgi için bkz . SqlClient Akış Desteği.

-veya-

SqlDbType olarak ayarlandığında TextReaderChar, NChar, NVarChar, VarChar veya Xml dışında bir değer kullanılmıştırValue.

-veya-

olarak ayarlandığında XmlReader Xml dışında bir SqlDbType değer kullanılmıştırValue.

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.

SqlException

SQL Server komut metnini yürütü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 Stream veya XmlReaderTextReader nesnesinde hata oluştu. Akış hakkında daha fazla bilgi için bkz . SqlClient Akış Desteği.

ObjectDisposedException

bir Stream akış işlemi sırasında veya XmlReaderTextReader 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ı'nda zaman uyumsuz programlama hakkında daha fazla bilgi için bkz. Zaman Uyumsuz Programlama.

Not

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.

ExecuteReaderAsync(CommandBehavior)

öğesini öğesine gönderen CommandTextConnection ve bir SqlDataReader oluşturan zaman uyumsuz sürümü ExecuteReader(CommandBehavior) . Özel durumlar döndürülen Görev nesnesi ile 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. Ne zaman olarak ayarlanır? Default , ReadAsync(CancellationToken) eksiksiz 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 Streamİkili veya VarBinary dışında bir değer kullanılmıştırValue. Akış hakkında daha fazla bilgi için bkz . SqlClient Akış Desteği.

-veya-

SqlDbType olarak ayarlandığında TextReaderChar, NChar, NVarChar, VarChar veya Xml dışında bir değer kullanılmıştırValue.

-veya-

olarak ayarlandığında XmlReader Xml dışında bir SqlDbType değer kullanılmıştırValue.

ArgumentException

Geçersiz CommandBehavior bir değer.

InvalidOperationException

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

-or- 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 metnini yürütü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 Stream veya XmlReaderTextReader nesnesinde hata oluştu. Akış hakkında daha fazla bilgi için bkz . SqlClient Akış Desteği.

ObjectDisposedException

bir Stream akış işlemi sırasında veya XmlReaderTextReader 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ı'nda zaman uyumsuz programlama hakkında daha fazla bilgi için bkz. Zaman Uyumsuz Programlama.

ExecuteReaderAsync(CancellationToken)

öğesine gönderen CommandText ve bir oluşturan zaman uyumsuz sürümü ExecuteReader()SqlDataReader .Connection

İptali belirteci, işlem komut zaman aşımı dolmadan işlemin iptal edilmesini istemek için kullanılabilir. Özel durumlar döndürülen Görev nesnesi ile 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 yönergesi.

Döndürülenler

Task<SqlDataReader>

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

Özel durumlar

InvalidCastException

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

-veya-

SqlDbType olarak ayarlandığında TextReaderChar, NChar, NVarChar, VarChar veya Xml dışında bir değer kullanılmıştırValue.

-veya-

olarak ayarlandığında XmlReader Xml dışında bir SqlDbType değer kullanılmıştırValue.

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.

SqlException

SQL Server komut metnini yürütü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 Stream veya XmlReaderTextReader nesnesinde hata oluştu. Akış hakkında daha fazla bilgi için bkz . SqlClient Akış Desteği.

ObjectDisposedException

bir Stream akış işlemi sırasında veya XmlReaderTextReader 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ı'nda zaman uyumsuz programlama hakkında daha fazla bilgi için bkz. Zaman Uyumsuz Programlama.

ExecuteReaderAsync(CommandBehavior, CancellationToken)

öğesini öğesine gönderen ConnectionCommandText ve bir İptal belirteci oluşturan SqlDataReader zaman uyumsuz sürümü ExecuteReader(CommandBehavior) , komut zaman aşımı tamamlanmadan önce işlemin iptal edilmesi isteğinde bulunmak için kullanılabilir. Özel durumlar döndürülen Görev nesnesi ile 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. ayarlandığı zaman Default , ReadAsync(CancellationToken) eksiksiz bir Görev döndürmeden önce satırın tamamını okur.

cancellationToken

CancellationToken

İptal yönergesi.

Döndürülenler

Task<SqlDataReader>

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

Özel durumlar

InvalidCastException

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

-veya-

SqlDbType olarak ayarlandığında TextReaderChar, NChar, NVarChar, VarChar veya Xml dışında bir değer kullanılmıştırValue.

-veya-

olarak ayarlandığında XmlReader Xml dışında bir SqlDbType değer kullanılmıştırValue.

ArgumentException

Geçersiz CommandBehavior bir değer.

InvalidOperationException

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

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

SqlException

SQL Server komut metnini yürütü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 Stream veya XmlReaderTextReader nesnesinde hata oluştu. Akış hakkında daha fazla bilgi için bkz . SqlClient Akış Desteği.

ObjectDisposedException

, StreamXmlReader veya TextReader nesnesi bir akış işlemi sırasında 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ı'nda zaman uyumsuz programlama hakkında daha fazla bilgi için bkz. Zaman Uyumsuz Programlama.