Metode BeginTrans, CommitTrans, dan RollbackTrans (ADO)

  • Artikel

Metode transaksi ini mengelola pemrosesan transaksi dalam objek Koneksi sebagai berikut:

  • BeginTrans Memulai transaksi baru.

  • CommitTrans Menyimpan perubahan apa pun dan mengakhiri transaksi saat ini. Ini juga dapat memulai transaksi baru.

  • RollbackTrans Membatalkan perubahan apa pun yang dilakukan selama transaksi berjalan dan mengakhiri transaksi. Ini juga dapat memulai transaksi baru.

Sintaks

  
level = object.BeginTrans()  
object.BeginTrans  
object.CommitTrans  
object.RollbackTrans

Tampilkan Nilai

BeginTrans dapat dipanggil sebagai fungsi yang mengembalikan variabel Long yang menunjukkan tingkat bersarangnya transaksi.

Parameter

objek
Objek Koneksi .

Koneksi

Gunakan metode ini dengan objek Koneksi saat Anda ingin menyimpan atau membatalkan serangkaian perubahan yang dibuat pada data sumber sebagai satu unit. Misalnya, untuk mentransfer uang antar rekening, Anda mengurangi jumlah dari satu dan menambahkan jumlah yang sama ke akun lainnya. Jika pembaruan gagal, akun tidak lagi seimbang. Membuat perubahan ini dalam transaksi terbuka memastikan bahwa semua atau tidak ada perubahan yang dilalui.

Catatan

Tidak semua penyedia mendukung transaksi. Verifikasi bahwa properti "Transaction DDL" yang ditentukan penyedia muncul di koleksi Properti objek Koneksi, yang menunjukkan bahwa penyedia mendukung transaksi. Jika penyedia tidak mendukung transaksi, memanggil salah satu metode ini akan mengembalikan kesalahan.

Setelah Anda memanggil metode BeginTrans , penyedia tidak akan lagi secara instan menerapkan perubahan yang Anda buat sampai Anda memanggil CommitTrans atau RollbackTrans untuk mengakhiri transaksi.

Untuk penyedia yang mendukung transaksi berlapis, memanggil metode BeginTrans dalam transaksi terbuka memulai transaksi berlapis baru. Nilai pengembalian menunjukkan tingkat bersarang: nilai pengembalian "1" menunjukkan Anda telah membuka transaksi tingkat atas (yaitu, transaksi tidak berlapis dalam transaksi lain), "2" menunjukkan bahwa Anda telah membuka transaksi tingkat kedua (transaksi yang berlapis dalam transaksi tingkat atas), dan sebagainya. Memanggil CommitTrans atau RollbackTrans hanya memengaruhi transaksi yang terakhir dibuka; Anda harus menutup atau mengembalikan transaksi saat ini sebelum dapat menyelesaikan transaksi tingkat yang lebih tinggi.

Memanggil metode CommitTrans menyimpan perubahan yang dilakukan dalam transaksi terbuka pada koneksi dan mengakhiri transaksi. Memanggil metode RollbackTrans membalikkan setiap perubahan yang dilakukan dalam transaksi terbuka dan mengakhiri transaksi. Memanggil salah satu metode ketika tidak ada transaksi terbuka yang menghasilkan kesalahan.

Bergantung pada properti Atribut objek Koneksi, memanggil metode CommitTrans atau RollbackTrans dapat secara otomatis memulai transaksi baru. Jika properti Atribut diatur ke adXactCommitRetaining, penyedia secara otomatis memulai transaksi baru setelah panggilan CommitTrans . Jika properti Atribut diatur ke adXactAbortRetaining, penyedia secara otomatis memulai transaksi baru setelah panggilan RollbackTrans .

Layanan Data Jarak Jauh

Metode BeginTrans, CommitTrans, dan RollbackTrans tidak tersedia pada objek Koneksi sisi klien.

Berlaku Untuk

Objek Koneksi (ADO)

Lihat juga

Contoh Metode BeginTrans, CommitTrans, dan RollbackTrans (VB)
Contoh Metode BeginTrans, CommitTrans, dan RollbackTrans (VC++)
Properti Atribut (ADO)