ADO Recordset Object

---

contoh

GetRows
Contoh ini menunjukkan bagaimana menggunakan metode GetRows.

---

Obyek Recordset

ADO Recordset objek digunakan untuk menyimpan satu set catatan dari tabel database. Sebuah objek Recordset terdiri dari catatan dan kolom (fields) .

Dalam ADO, objek ini adalah yang paling penting dan yang paling sering digunakan untuk memanipulasi data dari database.

ProgID

Ketika Anda pertama kali membuka Recordset, catatan pointer saat ini akan menunjuk ke record pertama dan BOF dan sifat EOF adalah False. Jika tidak ada catatan, BOF dan properti EOF yang Benar.

objek Recordset dapat mendukung dua jenis memperbarui:

• Immediate updating - semua perubahan ditulis langsung ke database setelah Anda memanggil metode Update.
• Batch updating - provider akan cache beberapa perubahan dan kemudian mengirimkannya ke database dengan metode UpdateBatch.

Dalam ADO ada 4 jenis kursor yang berbeda didefinisikan:

• Dynamic cursor - Memungkinkan Anda untuk melihat penambahan, perubahan, dan penghapusan oleh pengguna lain.
• Keyset cursor - Seperti kursor dinamis, kecuali bahwa Anda tidak dapat melihat penambahan oleh pengguna lain, dan mencegah akses ke catatan bahwa pengguna lain telah dihapus. Data perubahan oleh pengguna lain masih akan terlihat.
• Static cursor - Menyediakan salinan statis recordset untuk Anda gunakan untuk menemukan data atau menghasilkan laporan. Penambahan, perubahan, atau penghapusan oleh pengguna lain tidak akan terlihat. Ini adalah satu-satunya jenis kursor diperbolehkan ketika Anda membuka objek Recordset sisi klien.
• Forward-only cursor - Memungkinkan Anda untuk hanya gulir maju melalui Recordset. Penambahan, perubahan, atau penghapusan oleh pengguna lain tidak akan terlihat.

Jenis kursor dapat diatur oleh properti CursorType atau dengan parameter CursorType dalam metode Terbuka.

Note: Tidak semua penyedia mendukung semua metode atau properti dari objek Recordset.

---

properti

Milik	Deskripsi
AbsolutePage	Set atau mengembalikan nilai yang menentukan nomor halaman di objek Recordset
AbsolutePosition	Set atau mengembalikan nilai yang menentukan posisi ordinal dari catatan saat ini di objek Recordset
ActiveCommand	Mengembalikan objek Command terkait dengan Recordset
ActiveConnection	Set atau mengembalikan definisi untuk koneksi jika koneksi ditutup, atau benda Connection saat ini jika sambungan terbuka
BOF	Mengembalikan nilai true jika posisi rekor saat ini adalah sebelum record pertama, jika tidak palsu
Bookmark	Menetapkan atau mengembalikan bookmark. bookmark menyimpan posisi record saat ini
CacheSize	Menetapkan atau mengembalikan jumlah record yang dapat di-cache
CursorLocation	Menetapkan atau mengembalikan lokasi layanan kursor
CursorType	Set atau mengembalikan jenis kursor dari objek Recordset
DataMember	Set atau mengembalikan nama anggota data yang akan diambil dari obyek yang dirujuk oleh properti DataSource
DataSource	Menentukan sebuah objek yang berisi data untuk diwakili sebagai Recordset objek
EditMode	Mengembalikan status pengeditan catatan saat ini
EOF	Mengembalikan nilai true jika posisi rekor saat ini adalah setelah catatan terakhir, jika tidak palsu
Filter	Set atau mengembalikan filter untuk data dalam sebuah objek Recordset
Index	Set atau mengembalikan nama indeks saat ini untuk objek Recordset
LockType	Set atau mengembalikan nilai yang menentukan jenis penguncian saat mengedit catatan dalam Recordset
MarshalOptions	Set atau mengembalikan nilai yang menentukan catatan yang harus dikembalikan ke server
MaxRecords	Set atau mengembalikan jumlah maksimum record untuk kembali ke objek Recordset dari query
PageCount	Mengembalikan jumlah halaman dengan data dalam sebuah objek Recordset
PageSize	Set atau mengembalikan jumlah maksimum catatan diperbolehkan pada satu halaman dari sebuah object Recordset
RecordCount	Mengembalikan jumlah record dalam sebuah objek Recordset
Sort	Set atau mengembalikan nama field pada Recordset untuk mengurutkan
Source	Menetapkan nilai string atau referensi obyek Command, atau mengembalikan nilai String yang menunjukkan sumber data dari objek Recordset
State	Mengembalikan nilai yang menggambarkan jika objek Recordset terbuka, tertutup, menghubungkan, melaksanakan atau mengambil data
Status	Mengembalikan status dari record saat ini berkaitan dengan update batch atau operasi massal lainnya
StayInSync	Set atau kembali apakah mengacu pada catatan anak akan berubah ketika perubahan posisi record parent

metode

metode	Deskripsi
AddNew	Menciptakan rekor baru
Cancel	Membatalkan eksekusi
CancelBatch	Membatalkan batch update
CancelUpdate	Membatalkan perubahan yang dibuat ke rekor dari object Recordset
Clone	Membuat duplikat dari Recordset yang ada
Close	Menutup Recordset
CompareBookmarks	Membandingkan dua bookmark
Delete	Menghapus catatan atau sekelompok catatan
Find	Pencarian untuk catatan dalam Recordset yang memenuhi kriteria tertentu
GetRows	Salinan beberapa catatan dari object Recordset menjadi array dua dimensi
GetString	Mengembalikan Recordset sebagai string
Move	Memindahkan pointer record dalam sebuah objek Recordset
MoveFirst	Memindahkan record pointer ke record pertama
MoveLast	Memindahkan record pointer ke record terakhir
MoveNext	Memindahkan record pointer ke record berikutnya
MovePrevious	Memindahkan record pointer ke rekor sebelumnya
NextRecordset	Menghapus objek Recordset saat ini dan mengembalikan objek Recordset berikutnya dengan perulangan melalui serangkaian perintah
Open	Membuka elemen database yang memberikan Anda akses ke record dalam sebuah tabel, hasil query, atau ke Recordset disimpan
Requery	Update data dalam sebuah Recordset dengan re-mengeksekusi query yang membuat Recordset asli
Resync	Refresh data di Recordset saat ini dari database asli
Save	Menyimpan objek Recordset ke file atau objek Streaming
Seek	Mencari indeks Recordset untuk menemukan catatan yang cocok dengan nilai-nilai yang ditentukan
Supports	Mengembalikan nilai boolean yang mendefinisikan apakah atau tidak objek Recordset mendukung jenis tertentu dari fungsi
Update	Menyimpan semua perubahan yang dibuat untuk satu catatan dalam sebuah objek Recordset
UpdateBatch	Menyimpan semua perubahan dalam Recordset ke database. Digunakan ketika bekerja dalam modus batch update

Acara

Note: Anda tidak dapat menangani peristiwa menggunakan VBScript atau JScript (hanya Visual Basic, Visual C ++, dan Visual J ++ bahasa dapat menangani peristiwa).

Peristiwa	Deskripsi
EndOfRecordset	Dipicu ketika Anda mencoba untuk pindah ke rekor setelah catatan terakhir
FetchComplete	Dipicu setelah semua catatan dalam sebuah operasi asynchronous telah diambil
FetchProgress	Dipicu berkala dalam sebuah operasi asynchronous, untuk menyatakan berapa banyak catatan yang telah diambil
FieldChangeComplete	Dipicu setelah nilai perubahan object Field
MoveComplete	Dipicu setelah posisi saat ini di Recordset telah berubah
RecordChangeComplete	Dipicu setelah rekor telah berubah
RecordsetChangeComplete	Dipicu setelah Recordset telah berubah
WillChangeField	Dipicu sebelum nilai perubahan object Field
WillChangeRecord	Dipicu sebelum perubahan record
WillChangeRecordset	Dipicu sebelum perubahan Recordset
Akan pindah	Dipicu sebelum posisi saat ini dalam perubahan Recordset

koleksi

Koleksi	Deskripsi
Fields	Menunjukkan jumlah objek Lapangan di objek Recordset
Properties	Berisi semua objek Properti di objek Recordset

Properti Bidang Collection

Milik	Deskripsi
Count	Mengembalikan jumlah item dalam koleksi bidang. Dimulai dari nol. Contoh: countfields = rs.Fields.Count
Item(named_item/number)	Mengembalikan item tertentu dalam koleksi bidang. Contoh: itemfields = rs.Fields. Item(1) atau itemfields = rs.Fields. Item("Name")

Properties Properties Collection

Milik	Deskripsi
Count	Mengembalikan jumlah item dalam koleksi properti. Dimulai dari nol. Contoh: countprop = rs.Properties.Count
Item(named_item/number)	Mengembalikan item tertentu dalam koleksi properti. Contoh: itemprop = rs.Properties. Item(1) atau itemprop = rs.Properties. Item("Name")