DbConnection.BeginTransactionAsync Metoda

Definice

Obor názvů:

System.Data.Common

Sestavení:

System.Data.Common.dll

Přetížení

BeginTransactionAsync(CancellationToken)	Asynchronně zahájí transakci databáze.
BeginTransactionAsync(IsolationLevel, CancellationToken)	Asynchronně zahájí transakci databáze.

BeginTransactionAsync(CancellationToken)

Zdroj:

DbConnection.cs

Asynchronně zahájí transakci databáze.

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

Volitelný token pro zrušení asynchronní operace. Výchozí hodnota je None.

Návraty

ValueTask<DbTransaction>

Úkol, jehož Result vlastnost je objekt představující novou transakci.

Výjimky

OperationCanceledException

Token zrušení byl zrušen. Tato výjimka se uloží do vrácené úlohy.

Poznámky

Pokud nezadáte úroveň izolace, použije se výchozí úroveň izolace pro konkrétní typ připojení.

Výchozí implementace této asynchronní metody deleguje na svůj synchronní protějšek a vrátí dokončený Task, potenciálně blokuje volající vlákno.

Zprostředkovatelé dat, kteří podporují asynchronní programování , by měli přepsat výchozí implementaci pomocí asynchronních vstupně-výstupních operací.

Tato metoda ukládá do úlohy, která vrací všechny výjimky nepouužování, které může vyvolat synchronní protějšek metody. Pokud je do vrácené úlohy uložena výjimka, bude tato výjimka vyvolána, když je úloha očekávána. Výjimky použití, jako ArgumentExceptionje , se stále vyvolává synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem BeginTransaction().

BeginTransactionAsync(IsolationLevel, CancellationToken)

Zdroj:

DbConnection.cs

Asynchronně zahájí transakci databáze.

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 hodnot výčtu, která určuje úroveň izolace pro transakci použít.

cancellationToken

CancellationToken

Volitelný token pro zrušení asynchronní operace. Výchozí hodnota je None.

Návraty

ValueTask<DbTransaction>

Úkol, jehož Result vlastnost je objekt představující novou transakci.

Výjimky

OperationCanceledException

Token zrušení byl zrušen. Tato výjimka se uloží do vrácené úlohy.

Poznámky

Výchozí implementace této asynchronní metody deleguje na svůj synchronní protějšek a vrátí dokončený Task, potenciálně blokuje volající vlákno.

Zprostředkovatelé dat, kteří podporují asynchronní programování , by měli přepsat výchozí implementaci pomocí asynchronních vstupně-výstupních operací.

Tato metoda ukládá do úlohy, která vrací všechny výjimky nepouužování, které může vyvolat synchronní protějšek metody. Pokud je do vrácené úlohy uložena výjimka, bude tato výjimka vyvolána, když je úloha očekávána. Výjimky použití, jako ArgumentExceptionje , se stále vyvolává synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem BeginTransaction(IsolationLevel).