SqlConnection.OpenAsync(CancellationToken) Yöntem

Tanım

Ad Alanı:
System.Data.SqlClient
Bütünleştirilmiş Kod:
System.Data.dll

tarafından belirtilen Open()özellik ayarlarıyla bir veritabanı bağlantısı açan zaman uyumsuz sürümüConnectionString. İptal belirteci, bağlantı zaman aşımı tamamlanmadan önce işlemin terk edilmesi isteğinde bulunmak için kullanılabilir. Özel durumlar döndürülen Görev aracılığıyla yayılır. Bağlantı zaman aşımı süresi başarıyla bağlanmadan sona ererse, döndürülen Görev bir Özel Durum ile hatalı olarak işaretlenir. Uygulama, hem havuza alınan hem de havuza alınmayan bağlantılar için çağıran iş parçacığını engellemeden bir Görev döndürür.

public:
 override System::Threading::Tasks::Task ^ OpenAsync(System::Threading::CancellationToken cancellationToken);
public override System.Threading.Tasks.Task OpenAsync(System.Threading.CancellationToken cancellationToken);
override this.OpenAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task
Public Overrides Function OpenAsync (cancellationToken As CancellationToken) As Task

Parametreler

cancellationToken
CancellationToken

İptal talimatı.

Döndürülenler

Task

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

Özel durumlar

InvalidOperationException

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

Context Connection=true bağlantı dizesi belirtilir.

Bağlantı zaman aşımına uğramadan önce bağlantı havuzundan bağlantı kullanılamıyordu.

SqlException

Bağlantı açılırken oluşan SQL Server tarafından döndürülen tüm hatalar.

OperationCanceledException

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

Açıklamalar

çağrıldıktan OpenAsyncState sonra, döndürülen Task tamamlanana kadar döndürülmelidirConnecting. Ardından, bağlantı başarılı olursa döndürmelidir StateOpen. Bağlantı başarısız olursa döndürmelidir StateClosed.

çağrısı, ilgili OpenAsync aramayı Close iptal etmeye veya kapatmaya çalışır.

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

Şunlara uygulanır

Ayrıca bkz.