DbConnection.ChangeDatabaseAsync(String, CancellationToken) Yöntem

Tanım

Ad Alanı:

System.Data.Common

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Data.Common.dll

Kaynak:

DbConnection.cs

Açık bağlantı için geçerli veritabanını zaman uyumsuz olarak değiştirir.

public virtual System.Threading.Tasks.Task ChangeDatabaseAsync(string databaseName, System.Threading.CancellationToken cancellationToken = default);

abstract member ChangeDatabaseAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task
override this.ChangeDatabaseAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Overridable Function ChangeDatabaseAsync (databaseName As String, Optional cancellationToken As CancellationToken = Nothing) As Task

Parametreler

databaseName

String

Kullanılacak bağlantı için veritabanının adı.

cancellationToken

CancellationToken

Zaman uyumsuz işlemi iptal etmek için isteğe bağlı bir belirteç. None varsayılan değerdir.

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

parametresinde databaseName sağlanan değer geçerli örnek için geçerli bir veritabanı adı olmalıdır.

Bu zaman uyumsuz yöntemin varsayılan uygulaması, zaman uyumlu karşılığına temsilci olarak atanır ve tamamlanmış Taskbir döndürür ve çağrılan iş parçacığını engelleme olasılığı vardır.

Zaman uyumsuz programlamayı destekleyen veri sağlayıcıları, zaman uyumsuz G/Ç işlemlerini kullanarak varsayılan uygulamayı geçersiz kılmalıdır.

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