DbConnection.ChangeDatabaseAsync(String, CancellationToken) Yöntem

Tanım

Ad Alanı:

System.Data.Common

Bütünleştirilmiş Kod:

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 muadilini temsil eder ve tamamlanmış Taskbir 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.