object ADO Recordset
contoh
GetRows
Contoh ini menunjukkan bagaimana menggunakan metode GetRows.
object Recordset
ADO Recordset objek digunakan untuk menyimpan satu set catatan dari tabel database. Sebuah objek Recordset terdiri dari catatan dan kolom (field) komponen.
Dalam ADO, objek ini adalah data yang paling penting dan paling sering digunakan dalam objek database untuk beroperasi.
ProgID
Ketika Anda pertama kali membuka sebuah Recordset, catatan pointer saat akan menunjuk ke rekaman pertama, dan BOF dan EOF properti adalah False. Jika tidak ada catatan, BOF dan properti EOF untuk Benar.
objek Recordset dapat mendukung dua jenis update:
- Update - setelah Anda memanggil metode Update, semua perubahan segera ditulis ke database. Batch Update - penyedia cache beberapa perubahan, dan kemudian menggunakan metode UpdateBatch untuk mentransfer perubahan ke database.
Dalam ADO, kita mendefinisikan empat kursor yang berbeda (pointer) ketik:
- Dinamis kursor - Memungkinkan Anda untuk melihat pengguna lain menambahkan, mengubah dan menghapus
- Keyset kursor - kursor dinamis yang sama, kecuali bahwa Anda tidak dapat melihat pengguna lain yang telah Anda tambahkan, dan itu akan mencegah Anda dari mengakses pengguna dihapus catatan lain. perubahan data yang dilakukan oleh pengguna lain masih terlihat.
- kursor statis - Menyediakan salinan statis dari set record dapat digunakan untuk mencari data atau menghasilkan laporan. Selain itu, tentang penambahan yang dibuat oleh pengguna lain, mengubah, dan menghapus tidak akan terlihat. Ketika Anda membuka sebuah objek Recordset sisi klien, yang merupakan satu-satunya jenis kursor diperbolehkan.
- Maju hanya kursor - hanya mengizinkan gulir maju melalui Recordset. Selain itu, tentang penambahan yang dibuat oleh pengguna lain, mengubah, dan menghapus tidak akan terlihat.
Jenis kursor dapat diatur melalui properti CursorType atau Open metode parameter CursorType.
Catatan: Tidak semua penyedia (provider) metode dukungan Recordset objek dan properti.
milik
milik | deskripsi |
---|---|
AbsolutePage | Set atau mengembalikan nilai ditentukan jumlah Recordset halaman objek. |
AbsolutePosition | Set atau mengembalikan nilai yang dapat ditentukan posisi ordinal rekor saat (ordinal posisi) Recordset objek. |
ActiveCommand | Mengembalikan Recordset objek yang terkait objek Command. |
ActiveConnection | Jika koneksi dimatikan, atau kembali untuk menentukan sambungan, jika sambungan terbuka, menetapkan atau mengembalikan objek Connection saat ini. |
BOF | Jika posisi rekor saat ini adalah sebelum record pertama, ia mengembalikan benar, jika tidak fasle. |
Bookmark | Set atau mengembalikan bookmark. Bookmark lokasi ini untuk menyimpan catatan saat. |
CacheSize | Menetapkan atau mengembalikan jumlah record yang dapat di-cache. |
CursorLocation | Menetapkan atau mengembalikan posisi layanan kursor. |
CursorType | Set atau mengembalikan jenis kursor dari objek Recordset. |
DataMember | Set atau mengembalikan nama objek dari anggota data direferensikan properti DataSource diambil. |
DataSource | Menentukan file yang berisi objek yang akan direpresentasikan sebagai data Recordset objek. |
EditMode | Kembali ke mengedit status rekor saat. |
EOF | Jika catatan saat setelah catatan terakhir, ia mengembalikan benar, jika tidak fasle. |
filter | Mengembalikan sebuah objek Recordset untuk filter data. |
indeks | Set atau mengembalikan nama indeks Recordset objek saat. |
LockType | Set atau kembali Recordset saat mengedit catatan, nilai kunci jenis tertentu. |
MarshalOptions | Set atau mengembalikan nilai yang menentukan catatan dikembalikan ke server. |
MaxRecords | Set atau mengembalikan query yang mengembalikan sebuah objek Recordset dari jumlah maksimum record. |
PageCount | Mengembalikan Recordset objek halaman data. |
PageSize | Set atau mengembalikan jumlah maksimum record pada satu halaman Recordset objek memungkinkan. |
RecordCount | Mengembalikan jumlah record dalam sebuah objek Recordset. |
jenis | Set atau kembali satu atau lebih referensi sebagai Recordset nama field semacam. |
sumber | Menetapkan nilai string, atau referensi obyek Command, atau mengembalikan nilai string yang dapat menunjukkan sumber data objek Recordset. |
negara | Ia mengembalikan nilai yang dapat menggambarkan apakah objek Recordset terbuka, tertutup, menghubungkan, dalam proses atau mengambil data. |
status | Kembali update batch atau operasi massal lain yang berkaitan dengan status dari catatan saat ini. |
StayInSync | Set atau kembali ketika pasangan dicatat pada saat posisi record parent perubahan referensi berubah. |
cara
cara | deskripsi |
---|---|
AddNew | Membuat catatan baru. |
membatalkan | Membatalkan eksekusi terakhir. |
CancelBath | Urungkan update batch terakhir. |
CancelUpdate | Penarikan rekor dalam perubahan object Recordset. |
klon | Buat salinan dari Recordset yang ada. |
dekat | Menutup Recordset. |
CompareBookmarks | Membandingkan dua bookmark. |
Hapus | Menghapus record atau sekelompok record. |
menemukan | Cari satu Recordset yang memenuhi syarat yang ditentukan dalam rekor. |
GetRows | Beberapa salinan dari catatan dari objek Recordset menjadi array dua dimensi. |
GetString | Recordset dikembalikan sebagai string. |
bergerak | Dalam object Recordset untuk memindahkan pointer record. |
MoveFirst | Rekor pointer ke record pertama. |
MoveLast | Rekor pointer ke record terakhir. |
MoveNext | Catatan pointer bergerak ke record berikutnya. |
MovePrevious | Pindahkan record pointer ke record sebelumnya. |
NextRecordset | Menghapus objek Recordset saat ini dengan menjalankan serangkaian perintah dan mengembalikan Recordset berikutnya. |
terbuka | Membuka elemen database, yang memberikan catatan meja, hasil query atau disimpan akses Recordset. |
Requery | Untuk memperbarui data dalam objek Recordset dengan re-mengeksekusi query berbasis objek. |
resync | Refresh data di Recordset saat ini dari database asli. |
Hemat | object Recordset untuk menyimpan file atau Streaming objek. |
mencari | Recordset indeks pencarian untuk cepat menemukan nilai yang ditentukan sesuai garis dan membuat baris saat ini. |
mendukung | Ini mengembalikan nilai Boolean yang menentukan apakah suatu objek Recordset mendukung jenis tertentu fungsi. |
memperbarui | Simpan semua perubahan yang dibuat untuk satu catatan dalam objek Recordset. |
UpdateBatch | Semua perubahan Recordset disimpan dalam database. Penggunaan modus batch update. |
peristiwa
Catatan: Anda dapat menggunakan VBScript atau JScript proses (hanya memungkinkan Visual Basic, Visual C ++, dan Visual J ++ peristiwa pengolahan bahasa).
peristiwa | deskripsi |
---|---|
EndOfRecordset | Ketika Anda mencoba untuk bergerak melampaui akhir baris Recordset dipicu. |
FetchComplete | Ketika operasi asynchronous dipicu setelah semua catatan yang dibaca. |
FetchProgress | Dipicu berkala selama operasi asynchronous, itu laporan berapa banyak catatan telah membaca. |
FieldChangeComplete | Mengubah nilai dari object Field dipicu. |
MoveComplete | Recordset perubahan posisi saat setelah pelatuk. |
RecordChangeComplete | Setelah rekaman dipicu perubahan. |
RecordsetChangeComplete | Hal ini dipicu setelah perubahan Recordset. |
WillChangeField | Dipicu sebelum nilai objek perubahan Lapangan |
WillChangeRecord | Hal ini dipicu sebelum perubahan record. |
WillChangeRecordset | Hal ini dipicu sebelum perubahan Recordset. |
WillMove | Recordset dipicu sebelum perubahan posisi saat ini. |
set
set | deskripsi |
---|---|
Fields | Hal ini menunjukkan jumlah Recordset ini objek object Field. |
properti | Ini berisi semua Recordset objek objek Properti. |
Koleksi properti Fields
milik | deskripsi |
---|---|
menghitung | Mengembalikan jumlah bidang dalam koleksi item. Dimulai dari nol. contoh: countfields = rs.Fields.Count |
Item (named_item / angka) | Mengembalikan bidang dalam koleksi item tertentu. contoh: itemfields = rs.Fields.Item(1) 或者 itemfields = rs.Fields.Item("Name") |
Koleksi Properti Properti
milik | deskripsi |
---|---|
menghitung | Mengembalikan jumlah item dalam koleksi properti. Dimulai dari nol. contoh: countprop = rs.Properties.Count |
Item (named_item / angka) | Mengembalikan properti dari item tertentu dalam koleksi. contoh: itemprop = rs.Properties.Item(1) 或者 itemprop = rs.Properties.Item("Name") |