DbConnection.OpenAsync Yöntem

Tanım

Ad Alanı:

System.Data.Common

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Data.Common.dll

Bu yöntem, zaman uyumsuz bir sürümünü Open()uygular.

Aşırı Yüklemeler

Name	Description
OpenAsync()	tarafından belirtilen Open()ayarlarla bir veritabanı bağlantısı açan zaman uyumsuz sürümüConnectionString. Bu yöntem CancellationToken.None ile sanal yöntemi OpenAsync(CancellationToken) çağırır.
OpenAsync(CancellationToken)	Bu, zaman uyumsuz sürümüdür Open(). Sağlayıcılar uygun bir uygulamayla geçersiz kılmalıdır. İptal belirteci isteğe bağlı olarak kabul edilebilir. Varsayılan uygulama zaman uyumlu Open() çağrıyı çağırır ve tamamlanmış bir görev döndürür. Varsayılan uygulama, iptal edilmiş bir cancellationToken geçirilirse iptal edilmiş bir görev döndürür. Open tarafından oluşan özel durumlar, döndürülen Görev Özel Durumu özelliği aracılığıyla iletilecektir. Döndürülen Görev tamamlanana kadar nesnenin DbConnection diğer yöntemlerini ve özelliklerini çağırmayın.

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.

OpenAsync()

Kaynak:

DbConnection.cs

tarafından belirtilen Open()ayarlarla bir veritabanı bağlantısı açan zaman uyumsuz sürümüConnectionString. Bu yöntem CancellationToken.None ile sanal yöntemi OpenAsync(CancellationToken) çağırır.

public:
 System::Threading::Tasks::Task ^ OpenAsync();

public System.Threading.Tasks.Task OpenAsync();

member this.OpenAsync : unit -> System.Threading.Tasks.Task

Public Function OpenAsync () As Task

Döndürülenler

Task

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

Açıklamalar

çağrıldıktan OpenAsyncState sonra, döndürülen Connecting tamamlanana kadar döndürülmelidirTask. 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 Close aramayı OpenAsync 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.

Ayrıca bkz.

• ADO.NET’e Genel Bakış

OpenAsync(CancellationToken)

Kaynak:

DbConnection.cs

Bu, zaman uyumsuz sürümüdür Open(). Sağlayıcılar uygun bir uygulamayla geçersiz kılmalıdır. İptal belirteci isteğe bağlı olarak kabul edilebilir.

Varsayılan uygulama zaman uyumlu Open() çağrıyı çağırır ve tamamlanmış bir görev döndürür. Varsayılan uygulama, iptal edilmiş bir cancellationToken geçirilirse iptal edilmiş bir görev döndürür. Open tarafından oluşan özel durumlar, döndürülen Görev Özel Durumu özelliği aracılığıyla iletilecektir.

Döndürülen Görev tamamlanana kadar nesnenin DbConnection diğer yöntemlerini ve özelliklerini çağırmayın.

public:
 virtual System::Threading::Tasks::Task ^ OpenAsync(System::Threading::CancellationToken cancellationToken);

public virtual System.Threading.Tasks.Task OpenAsync(System.Threading.CancellationToken cancellationToken);

abstract member OpenAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.OpenAsync : System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Overridable 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

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 Connecting tamamlanana kadar döndürülmelidirTask. 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 Close aramayı OpenAsync 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.

Ayrıca bkz.

• ADO.NET’e Genel Bakış