DbConnection.BeginTransactionAsync Metoda

Definicja

Przestrzeń nazw:

System.Data.Common

Zestaw:

System.Data.Common.dll

Przeciążenia

BeginTransactionAsync(CancellationToken)	Asynchronicznie rozpoczyna transakcję bazy danych.
BeginTransactionAsync(IsolationLevel, CancellationToken)	Asynchronicznie rozpoczyna transakcję bazy danych.

BeginTransactionAsync(CancellationToken)

Źródło:

DbConnection.cs

Asynchronicznie rozpoczyna transakcję bazy danych.

public System.Threading.Tasks.ValueTask<System.Data.Common.DbTransaction> BeginTransactionAsync (System.Threading.CancellationToken cancellationToken = default);

member this.BeginTransactionAsync : System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<System.Data.Common.DbTransaction>

Public Function BeginTransactionAsync (Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of DbTransaction)

Parametry

cancellationToken

CancellationToken

Opcjonalny token umożliwiający anulowanie operacji asynchronicznej. Wartość domyślna to None.

Zwraca

ValueTask<DbTransaction>

Zadanie, którego Result właściwość jest obiektem reprezentującym nową transakcję.

Wyjątki

OperationCanceledException

Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwróconym zadaniu.

Uwagi

Jeśli nie określisz poziomu izolacji, zostanie użyty domyślny poziom izolacji dla określonego typu połączenia.

Domyślna implementacja tej asynchronicznej metody deleguje do jego synchronicznego odpowiednika i zwraca ukończony Task, potencjalnie blokujący wątek wywołujący.

Dostawcy danych, którzy obsługują programowanie asynchroniczne , powinni zastąpić domyślną implementację przy użyciu asynchronicznych operacji we/wy.

Ta metoda przechowuje w zadaniu wszystkie wyjątki inne niż użycie, które mogą zgłaszać synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony po oczekiwaniu na zadanie. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. Aby uzyskać informacje o przechowywanych wyjątkach, zobacz wyjątki zgłaszane przez BeginTransaction()usługę .

BeginTransactionAsync(IsolationLevel, CancellationToken)

Źródło:

DbConnection.cs

Asynchronicznie rozpoczyna transakcję bazy danych.

public System.Threading.Tasks.ValueTask<System.Data.Common.DbTransaction> BeginTransactionAsync (System.Data.IsolationLevel isolationLevel, System.Threading.CancellationToken cancellationToken = default);

member this.BeginTransactionAsync : System.Data.IsolationLevel * System.Threading.CancellationToken -> System.Threading.Tasks.ValueTask<System.Data.Common.DbTransaction>

Public Function BeginTransactionAsync (isolationLevel As IsolationLevel, Optional cancellationToken As CancellationToken = Nothing) As ValueTask(Of DbTransaction)

Parametry

isolationLevel

IsolationLevel

Jedna z wartości wyliczenia, która określa poziom izolacji dla transakcji do użycia.

cancellationToken

CancellationToken

Opcjonalny token umożliwiający anulowanie operacji asynchronicznej. Wartość domyślna to None.

Zwraca

ValueTask<DbTransaction>

Zadanie, którego Result właściwość jest obiektem reprezentującym nową transakcję.

Wyjątki

OperationCanceledException

Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwróconym zadaniu.

Uwagi

Domyślna implementacja tej asynchronicznej metody deleguje do jego synchronicznego odpowiednika i zwraca ukończony Task, potencjalnie blokujący wątek wywołujący.

Dostawcy danych, którzy obsługują programowanie asynchroniczne , powinni zastąpić domyślną implementację przy użyciu asynchronicznych operacji we/wy.

Ta metoda przechowuje w zadaniu wszystkie wyjątki inne niż użycie, które mogą zgłaszać synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony po oczekiwaniu na zadanie. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. Aby uzyskać informacje o przechowywanych wyjątkach, zobacz wyjątki zgłaszane przez BeginTransaction(IsolationLevel)usługę .