DbConnection.ChangeDatabaseAsync(String, CancellationToken) Yöntem
Tanım
Önemli
Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.
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
Zaman uyumsuz işlemi temsil eden bir görev.
Özel durumlar
İ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 muadilini temsil eder ve tamamlanmış Task
bir döndürür ve potansiyel olarak çağıran iş parçacığını engeller.
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, 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 ChangeDatabase(String)özel durumlara bakın.