Objek Recordset ADO

Contoh

GetRows
Contoh ini menunjukkan bagaimana untuk menggunakan metode GetRows.

Objek Recordset

Objek Recordset ADO digunakan untuk menampung kumpulan rekod dari tabel database. Objek Recordset terdiri daripada rekod dan lajur (medan).

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

ProgID

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

Ketika anda membuka Recordset untuk pertama kalinya, penuding rekod sekarang akan menunjuk kepada rekod pertama, dan atribut BOF dan EOF adalah False. Jika tiada rekod, atribut BOF dan EOF adalah True.

Objek Recordset dapat mendukung 2 jenis perbaruan:

  • Perbaruan Langsung - Setelah dipanggil metode Update, semua perubahan akan segera disimpan ke database.
  • Perbaruan Batch - Provider akan mengecache beberapa perubahan, lalu mengirimkan perubahan tersebut ke database melalui metode UpdateBatch.

Dalam ADO, terdefinikan 4 jenis kursor (poin) yang berbeza:

  • Kursor Dinamik - Memungkinkan anda melihat penambahan, perubahan dan penghapusan yang dilakukan oleh pengguna lain
  • Kursor Kumpulan - Seperti kursor dinamik, tetapi anda tidak dapat lihat penambahan yang dilakukan oleh pengguna lain, dan ia akan mencegah anda mengakses rekod yang dihapus oleh pengguna lain. Perubahan data yang dilakukan oleh pengguna lain masih dapat dilihat.
  • Kursor statik - Menyediakan salinan statik rekod set, boleh 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 sah sahnya yang diizinkan semasa membuka objek Recordset pelanggan.
  • Kursor sejuk - Hanya membenarkan penarikan ke depan dalam Recordset. Selain itu, penambahan, perubahan dan penghapusan yang dilakukan oleh pengguna lain akan tak terlihat.

Tipe kursor boleh ditetapkan melalui properti CursorType atau parameter CursorType dalam kaedah Open.

Keterangan:Bukan semua penyeragam (providers) menyokong semua kaedah dan properti objek Recordset.

Sifat

Sifat Penerangan
AbsolutePage Tetapkan atau kembalikan nilai yang boleh ditentukan halaman kini dalam objek Recordset.
AbsolutePosition Tetapkan atau kembalikan nilai yang boleh ditentukan posisi urutan rekod kini dalam objek Recordset (posisi nombor).
ActiveCommand Kembalikan objek Command yang berkaitan dengan objek Recordset.
ActiveConnection Tetapkan atau kembalikan definisi koneksi jika koneksi ditutup, jika koneksi dibuka, tetapkan atau kembalikan objek Connection kini.
BOF Kembalikan true jika posisi rekod kini di sebelum pertama rekod, sebaliknya kembalikan false.
Bookmark Tetapkan atau kembalikan bookmark. Bookmark ini menyimpan lokasi rekod kini.
CacheSize Tetapkan atau kembalikan bilangan rekod yang boleh disimpan di dalam cache.
CursorLocation Tetapkan atau kembalikan lokasi layanan kursor.
CursorType Tetapkan atau kembalikan jenis kursor untuk objek Recordset.
DataMember Tetapkan atau kembalikan nama anggota data yang hendak diambil dari objek yang diambil daripada properti DataSource.
DataSource Tentukan objek yang mengandungi data yang akan dipaparkan sebagai objek Recordset.
EditMode Kembalikan status edit rekod kini.
EOF Kembalikan true jika posisi rekod kini di belakang rekod terakhir, sebaliknya kembalikan false.
Filter Kembalikan penapisan untuk data objek Recordset.
Index Tetapkan atau kembalikan nama indeks kini untuk objek Recordset.
LockType Tetapkan atau kembalikan nilai, nilai ini boleh ditentukan jenis kunci yang boleh ditentukan semasa mengedit satu rekod dalam Recordset.
MarshalOptions Tetapkan atau kembalikan nilai, nilai ini menentukan rekod mana yang akan dihantar ke pelayan.
MaxRecords Tetapkan atau kembalikan bilangan maksimum rekod yang boleh diambil daripada Recordset yang dihasilkan daripada kueri.
PageCount Kembalikan bilangan halaman data dalam objek Recordset.
PageSize Tetapkan atau kembalikan bilangan maksimum rekod yang diizinkan di halaman tunggal objek Recordset.
RecordCount Kembalikan bilangan rekod dalam objek Recordset.
Sort Tetapkan atau kembalikan nama medan yang digunakan sebagai asas pengurutan Recordset.
Source Tetapkan nilai string, atau rujukan objek Command, atau kembalikan nilai string yang dapat menunjukkan sumber data objek Recordset.
State Kembalikan nilai yang dapat menggambarkan sama ada objek Recordset adalah dibuka, ditutup, sedang disambung, sedang dijalankan atau sedang mengambil data.
Status Kembalikan status rekod untuk kemas kini batch atau operasi besar lain.
StayInSync Tetapkan atau kembalikan sama ada rujukan rekod anak akan diubah apabila kedudukan rekod bapa berubah.

Method

Method Penerangan
AddNew Cipta satu rekod baru.
Cancel Batal sekurang-kurangnya satu pelaksanaan.
CancelBatch Batal ubah sekurang-kurangnya satu kemas kini batch.
CancelUpdate Batal ubah yang dilakukan kepada satu rekod objek Recordset.
Clone Cipta salinan Recordset yang sudah wujud.
Close Tutup satu Recordset.
CompareBookmarks Bandingkan dua bookmark.
Delete Hapus satu rekod atau sekumpulan rekod.
Find Cari satu rekod yang memenuhi syarat yang dinyatakan di dalam Recordset.
GetRows Salin beberapa rekod daripada objek Recordset ke array dua dimensi.
GetString Kembalikan Recordset sebagai string.
Move Alihkan penunjuk rekod di dalam objek Recordset.
MoveFirst Alihkan penunjuk rekod ke rekod pertama.
MoveLast Alihkan penunjuk rekod ke rekod terakhir.
MoveNext Alihkan penunjuk rekod ke rekod berikutnya.
MovePrevious Alihkan penunjuk rekod ke rekod terdahulu.
NextRecordset Bersihkan objek Recordset semasa dengan melaksanakan sekumpulan arahan dan kembalikan Recordset berikutnya.
Open Buka elemen pangkalan data, elemen ini boleh memberikan akses kepada rekod tabel, hasil pindahan atau Recordset disimpan.
Requery Memperbarui data Recordset dengan mengulangi kueri yang berdasarkan objek.
Resync Segarkan data Recordset saat ini dari database asli.
Save Simpan objek Recordset ke file atau objek Stream.
Seek Cari indeks Recordset untuk menempatkan baris yang cocok dengan nilai yang ditentukan dan jadikan baris saat ini.
Supports Mengembalikan nilai boolean yang menentukan apakah objek Recordset mendukung tipe fungsi tertentu.
Update Simpan semua perubahan yang ada terhadap suatu catatan tunggal dalam objek Recordset.
UpdateBatch Simpan semua perubahan yang ada di dalam 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 Penerangan
EndOfRecordset Dipanggil saat berusaha untuk bergerak ke baris di luar akhir Recordset.
FetchComplete Dipanggil saat semua catatan dalam operasi asinkron telah diambil.
FetchProgress Dipanggil secara teratur selama operasi asinkron, melaporkan berapa banyak catatan yang telah diambil.
FieldChangeComplete Dipanggil setelah nilai objek Field diubah.
MoveComplete Dipanggil setelah perubahan posisi Recordset.
RecordChangeComplete Dipanggil setelah perubahan suatu catatan.
RecordsetChangeComplete Dipanggil setelah perubahan Recordset.
WillChangeField Dipanggil sebelum nilai objek Field diubah.
WillChangeRecord Dipanggil sebelum perubahan suatu catatan.
WillChangeRecordset Dipanggil sebelum perubahan Recordset.
WillMove Dipanggil sebelum perubahan posisi Recordset.

Koleksi

Koleksi Penerangan
Fields Menunjukkan jumlah objek Field dalam objek Recordset ini.
Properties Termasuk semua objek Property dalam objek Recordset.

Sifat Projektor Fields

Sifat Penerangan
Jumlah

Kembalikan bilangan projektor dalam projektor fields. Mula dari 0.

Contoh:

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

Kembalikan projektor dalam projektor fields yang ditentukan.

Contoh:

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

Sifat Projektor Properties

Sifat Penerangan
Jumlah

Kembalikan bilangan projektor dalam projektor properties. Mula dari 0.

Contoh:

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

Kembalikan projektor properties bagi projektor yang ditentukan.

Contoh:

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