SqlConnection.OpenAsync(CancellationToken) Yöntem

  • Başvuru

Tanım

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

tarafından belirtilen ConnectionStringözellik ayarlarıyla bir veritabanı bağlantısı açan zaman uyumsuz sürümüOpen(). İ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 yönergesi.

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=truebağ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ürmelidirConnecting. 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ı'nda zaman uyumsuz programlama hakkında daha fazla bilgi için bkz. Zaman Uyumsuz Programlama.

Bu yöntem, görevin içinde depolar ve yöntemin zaman uyumlu karşılık geleninin atabileceği tüm kullanım dışı özel durumları döndürür. Döndürülen görevde bir özel durum depolanırsa, görev beklenirken bu özel durum oluşturulur. gibi ArgumentExceptionkullanım özel durumları yine zaman uyumlu olarak oluşturulur. Depolanan özel durumlar için tarafından oluşan Open()özel durumlara bakın.

Şunlara uygulanır

Ayrıca bkz.