Objek Recordset ADO

Contoh

GetRows
Contoh ini menunjukkan bagaimana menggunakan metode GetRows.

Objek Recordset

Objek Recordset ADO digunakan untuk menampung suatu koleksi catatan dari tabel database. Objek Recordset terdiri dari catatan dan kolom (bidang).

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

ProgID

set objRecordset = Server.CreateObject("ADODB.recordset")

Ketika Anda membuka Recordset untuk pertama kalinya, penanda catatan saat ini akan menunjuk ke catatan pertama, dan atribut BOF dan EOF akan berada di nilai False. Jika tidak ada catatan, atribut BOF dan EOF akan berada di nilai True.

Objek Recordset dapat mendukung 2 jenis pembaruan:

  • Pembaruan Langsung - Saat metode Update dipanggil, semua perubahan akan segera disimpan ke database.
  • Pembaruan Batch - Provider akan menyimpan beberapa perubahan, lalu mengirimkan perubahan tersebut ke database melalui metode UpdateBatch.

Dalam ADO, telah ditentukan 4 jenis yang berbeda dari tipe kursor (penanda):

  • Kursor Dinamis - Memungkinkan Anda melihat penambahan, perubahan, dan penghapusan yang dilakukan oleh pengguna lain
  • Kursor Kluster - Mirip dengan Kursor Dinamis, tetapi Anda tidak dapat melihat penambahan yang dilakukan oleh pengguna lain, dan ia akan mencegah Anda mengakses catatan yang dihapus oleh pengguna lain. Perubahan data yang dilakukan oleh pengguna lain masih dapat dilihat.
  • Kursor statis - Menyediakan salinan statis dari koleksi rekaman, dapat digunakan untuk mencari data atau membuat laporan. Selain itu, penambahan, perubahan, dan penghapusan yang dilakukan oleh pengguna lain akan tak terlihat. Kini ini adalah jenis kursor yang hanya diizinkan saat membuka objek Recordset klien.
  • Kursor statis - Menyediakan salinan statis dari koleksi rekaman, dapat digunakan untuk mencari data atau membuat laporan. Selain itu, penambahan, perubahan, dan penghapusan yang dilakukan oleh pengguna lain akan tak terlihat. Ini adalah jenis kursor yang hanya diizinkan saat membuka objek Recordset klien.

Tipe kursor dapat disetel melalui atribut CursorType atau parameter CursorType dalam metode Open.

Keterangan:Tidak semua provider (pemberi layanan) mendukung semua metode dan atribut objek Recordset.

Properti

Properti Deskripsi
AbsolutePage Setelai atau kembalikan nilai yang dapat menentukan halaman di objek Recordset.
AbsolutePosition Setelai atau kembalikan nilai yang dapat menentukan posisi urutan rekaman saat ini di objek Recordset (posisi urut).
ActiveCommand Kembalikan objek Command yang berhubungan dengan objek Recordset.
ActiveConnection Jika koneksi ditutup, setelai atau kembalikan definisi koneksi, jika koneksi dibuka, setelai atau kembalikan objek Connection saat ini.
BOF Kembalikan true jika posisi rekaman saat ini sebelum rekaman pertama, sebaliknya kembalikan false.
Bookmark Setelai atau kembalikan bookmark. Bookmark ini menyimpan posisi rekaman saat ini.
CacheSize Setelai atau kembalikan jumlah rekaman yang dapat disimpan di cache.
CursorLocation Setelai atau kembalikan lokasi layanan kursor.
CursorType Setelai atau kembalikan jenis kursor untuk objek Recordset.
DataMember Setelai atau kembalikan nama anggota data yang akan dipanggil dari objek yang diacu oleh atribut DataSource.
DataSource Tentukan objek yang mengandung data yang akan diwakili sebagai objek Recordset.
EditMode Kembalikan status edit rekaman saat ini.
EOF Kembalikan true jika posisi rekaman saat ini setelah rekaman terakhir, sebaliknya kembalikan false.
Filter Kembalikan penyaring untuk data objek Recordset.
Index Setelai atau kembalikan nama indeks yang saat ini aktif untuk objek Recordset.
LockType Setelai atau kembalikan nilai yang dapat ditentukan jenis kunci saat mengedit satu rekaman di Recordset.
MarshalOptions Setelai atau kembalikan nilai, nilai ini menentukan rekaman yang akan dikembalikan ke server.
MaxRecords Atur atau kembalikan jumlah maksimum catatan yang dapat dikembalikan dari query ke objek Recordset.
PageCount Kembalikan jumlah halaman data dalam objek Recordset.
PageSize Atur atau kembalikan jumlah maksimum catatan yang diizinkan di halaman tunggal objek Recordset.
RecordCount Kembalikan jumlah catatan dalam objek Recordset.
Sort Atur atau kembalikan nama field yang digunakan sebagai dasar pengurutan Recordset.
Source Atur nilai string, referensi objek Command, atau kembalikan nilai string yang dapat menunjukkan sumber data objek Recordset.
State Kembalikan nilai yang dapat menggambarkan apakah objek Recordset terbuka, tertutup, sedang terhubung, sedang dieksekusi, atau sedang mengambil data.
Status Kembalikan status catatan saat ini tentang batch update atau operasi besar lainnya.
StayInSync Atur atau kembalikan referensi catatan anak apakah berubah saat posisi catatan induk berubah.

Metode

Metode Deskripsi
AddNew Buat catatan baru.
Cancel Batalkan eksekusi sekali.
CancelBatch Batalkan batch update sekali.
CancelUpdate Batalkan perubahan yang dibuat pada catatan satu Recordset objek.
Clone Buat salinan Recordset yang sudah ada.
Close Tutup Recordset.
CompareBookmarks Bandingkan dua bookmark.
Delete Hapus catatan satu atau beberapa catatan.
Find Cari catatan dalam Recordset yang memenuhi kondisi yang ditentukan.
GetRows Salin berbagai catatan dari objek Recordset ke array dua dimensi.
GetString Kembalikan Recordset sebagai string.
Move Pindahkan penanda catatan di dalam objek Recordset.
MoveFirst Pindahkan penanda catatan ke catatan pertama.
MoveLast Pindahkan penanda catatan ke catatan terakhir.
MoveNext Pindahkan penanda catatan ke catatan berikutnya.
MovePrevious Pindahkan penanda catatan ke catatan sebelumnya.
NextRecordset Bersihkan objek Recordset saat ini dengan melaksanakan sekuel perintah dan kembalikan Recordset berikutnya.
Open Buka elemen database, elemen ini dapat menyediakan akses ke catatan tabel, hasil query, atau Recordset yang disimpan.
Requery Memperbarui data dalam objek Recordset dengan mengulangi query yang berdasarkan objek.
Resync Segarkan data saat ini dalam Recordset dari database asli.
Save Simpan objek Recordset ke file atau objek Stream.
Seek Cari indeks Recordset untuk menempatkan baris yang cocok dengan nilai yang disebutkan ke depan, dan jadikannya baris saat ini.
Supports Mengembalikan nilai boolean, yang dapat menentukan apakah objek Recordset mendukung tipe fungsi tertentu.
Update Simpan semua perubahan yang dibuat terhadap suatu catatan tunggal dalam objek Recordset.
UpdateBatch Simpan semua perubahan yang ada di Recordset ke database. Gunakan dalam mode update batch.

Peristiwa

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

Peristiwa Deskripsi
EndOfRecordset Dit触発 saat mencoba untuk bergerak ke baris di luar akhir Recordset.
FetchComplete Dit触発 setelah semua catatan dalam operasi asinkron di-baca.
FetchProgress Dit触発 secara teratur selama operasi asinkron, melaporkan berapa banyak catatan yang sudah di-read.
FieldChangeComplete Dit触発 setelah nilai objek Field diubah.
MoveComplete Dit触発 setelah perubahan posisi saat ini dalam Recordset.
RecordChangeComplete Dit触発 setelah perubahan suatu catatan.
RecordsetChangeComplete Dit触発 setelah perubahan Recordset.
WillChangeField Dit触発 sebelum nilai objek Field diubah.
WillChangeRecord Dit触発 sebelum perubahan suatu catatan.
WillChangeRecordset Dit触発 sebelum perubahan Recordset.
WillMove Dit触発 sebelum perubahan posisi saat ini dalam Recordset.

Koleksi

Koleksi Deskripsi
Fields Menunjukkan jumlah objek Field dalam Recordset ini.
Properties Mengandung semua objek Property dalam Recordset objek.

Properti koleksi Fields

Properti Deskripsi
Count

Kembalikan jumlah item di koleksi fields. Dimulai dari 0.

Contoh:

	countfields = rs.Fields.Count
Item(named_item/number)

Kembalikan item yang ditentukan di koleksi fields.

Contoh:

	itemfields = rs.Fields.Item(1)
	atau	
	itemfields = rs.Fields.Item("Name")

Properti koleksi Properties

Properti Deskripsi
Count

Kembalikan jumlah item di koleksi properties. Dimulai dari 0.

Contoh:

	countprop = rs.Properties.Count
Item(named_item/number)

Kembalikan proyek yang ditentukan di koleksi properties.

Contoh:

	itemprop = rs.Properties.Item(1)
	atau
	itemprop = rs.Properties.Item("Name")