DbConnection.BeginTransactionAsync Metode

Definisi

Ruang nama:

System.Data.Common

Rakitan:

System.Data.Common.dll

Overload

BeginTransactionAsync(CancellationToken)	Secara asinkron memulai transaksi database.
BeginTransactionAsync(IsolationLevel, CancellationToken)	Secara asinkron memulai transaksi database.

BeginTransactionAsync(CancellationToken)

Sumber:

DbConnection.cs

Secara asinkron memulai transaksi database.

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)

Parameter

cancellationToken

CancellationToken

Token opsional untuk membatalkan operasi asinkron. Nilai defaultnya adalah None.

Mengembalikan

ValueTask<DbTransaction>

Tugas yang propertinya Result adalah objek yang mewakili transaksi baru.

Pengecualian

OperationCanceledException

Token pembatalan dibatalkan. Pengecualian ini disimpan ke dalam tugas yang dikembalikan.

Keterangan

Jika Anda tidak menentukan tingkat isolasi, tingkat isolasi default untuk jenis koneksi tertentu akan digunakan.

Implementasi default dari metode asinkron ini mendelegasikan ke rekan sinkronnya dan mengembalikan yang selesai Task, berpotensi memblokir utas panggilan.

Penyedia data yang mendukung pemrograman asinkron harus mengambil alih implementasi default menggunakan operasi I/O asinkron.

Metode ini disimpan dalam tugas yang menampilkan semua pengecualian non-penggunaan yang dapat dilemparkan oleh rekan sinkron metode. Jika pengecualian disimpan ke dalam tugas yang dikembalikan, pengecualian tersebut akan dilemparkan saat tugas ditunggu. Pengecualian penggunaan, seperti ArgumentException, masih dilemparkan secara sinkron. Untuk pengecualian yang disimpan, lihat pengecualian yang dilemparkan oleh BeginTransaction().

BeginTransactionAsync(IsolationLevel, CancellationToken)

Sumber:

DbConnection.cs

Secara asinkron memulai transaksi database.

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)

Parameter

isolationLevel

IsolationLevel

Salah satu nilai enumerasi yang menentukan tingkat isolasi untuk digunakan transaksi.

cancellationToken

CancellationToken

Token opsional untuk membatalkan operasi asinkron. Nilai defaultnya adalah None.

Mengembalikan

ValueTask<DbTransaction>

Tugas yang propertinya Result adalah objek yang mewakili transaksi baru.

Pengecualian

OperationCanceledException

Token pembatalan dibatalkan. Pengecualian ini disimpan ke dalam tugas yang dikembalikan.

Keterangan

Implementasi default dari metode asinkron ini mendelegasikan ke rekan sinkronnya dan mengembalikan yang selesai Task, berpotensi memblokir utas panggilan.

Penyedia data yang mendukung pemrograman asinkron harus mengambil alih implementasi default menggunakan operasi I/O asinkron.

Metode ini disimpan dalam tugas yang menampilkan semua pengecualian non-penggunaan yang dapat dilemparkan oleh rekan sinkron metode. Jika pengecualian disimpan ke dalam tugas yang dikembalikan, pengecualian tersebut akan dilemparkan saat tugas ditunggu. Pengecualian penggunaan, seperti ArgumentException, masih dilemparkan secara sinkron. Untuk pengecualian yang disimpan, lihat pengecualian yang dilemparkan oleh BeginTransaction(IsolationLevel).