DbConnection.OpenAsync Yöntem

Tanım

Ad Alanı:

System.Data.Common

Bütünleştirilmiş Kod:

System.Data.Common.dll

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

Aşırı Yüklemeler

OpenAsync()

tarafından belirtilen ConnectionStringayarlarla bir veritabanı bağlantısı açan zaman uyumsuz sürümüOpen(). 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, zaten 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ı'nda zaman uyumsuz programlama hakkında daha fazla bilgi için bkz. Zaman Uyumsuz Programlama.

OpenAsync()

Kaynak:

DbConnection.cs

tarafından belirtilen ConnectionStringayarlarla bir veritabanı bağlantısı açan zaman uyumsuz sürümüOpen(). 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 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.

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, zaten 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 yönergesi.

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

Ayrıca bkz.

• ADO.NET’e Genel Bakış