Objek Recordset ADO
- Halaman Sebelumnya Record ADO
- Halaman Berikutnya Stream 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") |
- Halaman Sebelumnya Record ADO
- Halaman Berikutnya Stream ADO