DbConnection.OpenAsync Metoda

Definicja

Przestrzeń nazw:

System.Data.Common

Zestaw:

System.Data.Common.dll

Ta metoda implementuje asynchroniczną wersję programu Open().

Przeciążenia

OpenAsync()

Wersja asynchroniczna programu Open(), która otwiera połączenie bazy danych z ustawieniami określonymi przez .ConnectionString Ta metoda wywołuje metodę OpenAsync(CancellationToken) wirtualną z elementem CancellationToken.None.

OpenAsync(CancellationToken)

Jest to asynchroniczna wersja programu Open(). Dostawcy powinni zastąpić odpowiednią implementacją. Token anulowania można opcjonalnie uhonorować. Domyślna implementacja wywołuje wywołanie synchroniczne Open() i zwraca ukończone zadanie. Domyślna implementacja zwróci anulowane zadanie, jeśli przekazano już anulowane odwołanieToken. Wyjątki zgłaszane przez program Open będą przekazywane za pośrednictwem zwróconej właściwości Wyjątek zadania. Nie należy wywoływać innych metod i właściwości DbConnection obiektu, dopóki zwrócone zadanie nie zostanie ukończone.

Uwagi

Aby uzyskać więcej informacji na temat programowania asynchronicznego w programie .NET Framework Data Provider for SQL Server, zobacz Asynchronous Programming (Programowanie asynchroniczne).

OpenAsync()

Źródło:

DbConnection.cs

Wersja asynchroniczna programu Open(), która otwiera połączenie bazy danych z ustawieniami określonymi przez .ConnectionString Ta metoda wywołuje metodę OpenAsync(CancellationToken) wirtualną z elementem CancellationToken.None.

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

Zwraca

Task

Zadanie reprezentujące operację asynchroniczną.

Uwagi

Po wywołaniu metody OpenAsyncState należy powrócić Connecting do momentu ukończenia zwróconej Task wartości. Następnie, jeśli połączenie zakończyło się pomyślnie, State musi zwrócić wartość Open. Jeśli połączenie nie powiedzie się, State należy zwrócić wartość Closed.

Wywołanie metody , aby Close podjąć próbę anulowania lub zamknięcia odpowiedniego OpenAsync wywołania.

Aby uzyskać więcej informacji na temat programowania asynchronicznego w programie .NET Framework Data Provider for SQL Server, zobacz Asynchronous Programming (Programowanie asynchroniczne).

Ta metoda jest przechowywana w zadaniu, które zwraca wszystkie wyjątki nieużytowe, które może zgłosić synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwracanym zadaniu, ten wyjątek zostanie zgłoszony podczas oczekiwania zadania. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. W przypadku przechowywanych wyjątków zobacz wyjątki zgłoszone przez Open()usługę .

Zobacz też

• Omówienie ADO.NET

OpenAsync(CancellationToken)

Źródło:

DbConnection.cs

Jest to asynchroniczna wersja programu Open(). Dostawcy powinni zastąpić odpowiednią implementacją. Token anulowania można opcjonalnie uhonorować.

Domyślna implementacja wywołuje wywołanie synchroniczne Open() i zwraca ukończone zadanie. Domyślna implementacja zwróci anulowane zadanie, jeśli przekazano już anulowane odwołanieToken. Wyjątki zgłaszane przez program Open będą przekazywane za pośrednictwem zwróconej właściwości Wyjątek zadania.

Nie należy wywoływać innych metod i właściwości DbConnection obiektu, dopóki zwrócone zadanie nie zostanie ukończone.

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

Parametry

cancellationToken

CancellationToken

Instrukcja anulowania.

Zwraca

Task

Zadanie reprezentujące operację asynchroniczną.

Wyjątki

OperationCanceledException

Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwracanym zadaniu.

Uwagi

Po wywołaniu metody OpenAsyncState należy powrócić Connecting do momentu ukończenia zwróconej Task wartości. Następnie, jeśli połączenie zakończyło się pomyślnie, State musi zwrócić wartość Open. Jeśli połączenie nie powiedzie się, State należy zwrócić wartość Closed.

Wywołanie metody , aby Close podjąć próbę anulowania lub zamknięcia odpowiedniego OpenAsync wywołania.

Aby uzyskać więcej informacji na temat programowania asynchronicznego w programie .NET Framework Data Provider for SQL Server, zobacz Asynchronous Programming (Programowanie asynchroniczne).

Ta metoda jest przechowywana w zadaniu, które zwraca wszystkie wyjątki nieużytowe, które może zgłosić synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwracanym zadaniu, ten wyjątek zostanie zgłoszony podczas oczekiwania zadania. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. W przypadku przechowywanych wyjątków zobacz wyjątki zgłoszone przez Open()usługę .

Zobacz też

• Omówienie ADO.NET