Kelas COleDBRecordView

Tampilan yang menampilkan rekaman database dalam kontrol.

Sintaks

class COleDBRecordView : public CFormView

Anggota

Konstruktor yang Dilindungi

Nama	Deskripsi
COleDBRecordView::COleDBRecordView	Membuat COleDBRecordView objek.

Metode Publik

Nama	Deskripsi
COleDBRecordView::OnGetRowset	Mengembalikan nilai HRESULT standar.
COleDBRecordView::OnMove	Memperbarui rekaman saat ini (jika kotor) pada sumber data lalu berpindah ke rekaman yang ditentukan (berikutnya, sebelumnya, pertama, atau terakhir).

Keterangan

Tampilan adalah tampilan formulir yang terhubung langsung ke CRowset objek. Tampilan dibuat dari sumber daya templat dialog dan menampilkan bidang CRowset objek dalam kontrol templat dialog. Objek COleDBRecordView menggunakan pertukaran data dialog (DDX), dan fungsionalitas navigasi bawaan CRowset, untuk mengotomatiskan pergerakan data antara kontrol pada formulir dan bidang set baris. COleDBRecordView juga menyediakan implementasi default untuk pindah ke rekaman pertama, berikutnya, sebelumnya, atau terakhir dan antarmuka untuk memperbarui rekaman yang saat ini sedang dilihat.

Anda dapat menggunakan fungsi DDX dengan COleDbRecordView untuk mendapatkan data langsung dari kumpulan rekaman database dan menampilkannya dalam kontrol dialog. Anda harus menggunakan DDX_* metode (seperti DDX_Text), bukan DDX_Field* fungsi (seperti DDX_FieldText) dengan COleDbRecordView. DDX_FieldText tidak akan bekerja dengan COleDbRecordView karena DDX_FieldText mengambil argumen tambahan dari jenis CRecordset* (untuk CRecordView) atau CDaoRecordset* (untuk CDaoRecordView).

Catatan

Jika Anda bekerja dengan kelas Objek Akses Data (DAO) daripada kelas Templat Konsumen OLE DB, gunakan kelas CDaoRecordView sebagai gantinya. Untuk informasi selengkapnya, lihat artikel Gambaran Umum: Pemrograman Database.

COleDBRecordView melacak posisi pengguna di set baris sehingga tampilan rekaman dapat memperbarui antarmuka pengguna. Saat pengguna berpindah ke salah satu akhir set baris, tampilan rekaman menonaktifkan objek antarmuka pengguna — seperti item menu atau tombol toolbar — untuk bergerak lebih jauh ke arah yang sama.

Untuk informasi selengkapnya tentang kelas set baris, lihat artikel Menggunakan Templat Konsumen OLE DB.

Hierarki Warisan

CObject

CCmdTarget

CWnd

CView

CScrollView

CFormView

COleDBRecordView

Persyaratan

Header: afxoledb.h

COleDBRecordView::COleDBRecordView

Membuat COleDBRecordView objek.

COleDBRecordView(LPCTSTR lpszTemplateName);
COleDBRecordView(UINT nIDTemplate);

Parameter

lpszTemplateName
Berisi string null-terminated yang merupakan nama sumber daya dialog-template.

nIDTemplate
Berisi nomor ID sumber daya dialog-templat.

Keterangan

Saat Anda membuat objek dari jenis yang berasal dari COleDBRecordView, panggil salah satu konstruktor untuk membuat objek tampilan dan mengidentifikasi sumber daya dialog tempat tampilan berada. Anda dapat mengidentifikasi sumber daya baik berdasarkan nama (berikan string sebagai argumen ke konstruktor) atau dengan ID-nya (berikan bilangan bulat yang tidak ditandatangani sebagai argumen).

Catatan

Kelas turunan Anda harus menyediakan konstruktornya sendiri. Di konstruktor, panggil konstruktor, COleDBRecordView::COleDBRecordView, dengan nama sumber daya atau ID sebagai argumen.

COleDBRecordView::OnGetRowset

Mengembalikan handel untuk objek CRowset<> yang terkait dengan tampilan rekaman.

virtual CRowset<>* OnGetRowset() = 0;

Tampilkan Nilai

Nilai HRESULT standar.

Keterangan

Anda harus mengambil alih fungsi anggota ini untuk membangun atau mendapatkan objek set baris dan mengembalikan handel ke dalamnya. Jika Anda mendeklarasikan kelas tampilan rekaman Anda dengan ClassWizard, wizard akan menulis penimpaan default untuk Anda. Implementasi default ClassWizard mengembalikan handel set baris yang disimpan dalam tampilan rekaman jika ada. Jika tidak, ini membangun objek set baris dari jenis yang Anda tentukan dengan ClassWizard dan memanggil fungsi anggotanya Open untuk membuka tabel atau menjalankan kueri, lalu mengembalikan handel ke objek.

Catatan

Sebelumnya ke MFC 7.0, OnGetRowset mengembalikan pointer ke CRowset. Jika Anda memiliki kode yang memanggil OnGetRowset, Anda perlu mengubah jenis pengembalian ke kelas templat CRowset<>.

Contoh

CFrameWnd* pFrame = (CFrameWnd*)AfxGetMainWnd();
COleDBRecordView* pView = (COleDBRecordView*)pFrame->GetActiveView();

// CProductAccessor is a user-defined accessor class
CRowset<CAccessor<CProductAccessor>>* pRowSet =
(CRowset<CAccessor<CProductAccessor>>*)pView->OnGetRowset();

Untuk informasi dan contoh selengkapnya, lihat artikel Tampilan Rekaman: Menggunakan Tampilan Rekaman.

COleDBRecordView::OnMove

Berpindah ke rekaman lain dalam set baris dan menampilkan bidangnya dalam kontrol tampilan rekaman.

virtual BOOL OnMove(UINT nIDMoveCommand);

Parameter

nIDMoveCommand
Salah satu nilai ID perintah standar berikut:

• ID_RECORD_FIRST — Pindahkan ke rekaman pertama di kumpulan rekaman.

• ID_RECORD_LAST — Pindahkan ke rekaman terakhir di kumpulan rekaman.

• ID_RECORD_NEXT — Pindahkan ke rekaman berikutnya di kumpulan rekaman.

• ID_RECORD_PREV — Pindahkan ke rekaman sebelumnya di kumpulan rekaman.

Tampilkan Nilai

Bukan nol jika pemindahan berhasil; jika tidak, 0 jika permintaan pemindahan ditolak.

Keterangan

Implementasi default memanggil fungsi anggota objek yang sesuai Move yang CRowset terkait dengan tampilan rekaman.

Secara default, OnMove memperbarui rekaman saat ini pada sumber data jika pengguna telah mengubahnya dalam tampilan rekaman.

Panduan Aplikasi membuat sumber daya menu dengan item menu Rekaman Pertama, Rekaman Terakhir, Rekaman Berikutnya, dan Rekaman Sebelumnya. Jika Anda memilih opsi Bilah Alat yang Dapat Ditampung, Wizard Aplikasi juga membuat toolbar dengan tombol yang sesuai dengan perintah ini.

Jika Anda memindahkan rekaman terakhir di kumpulan rekaman, tampilan rekaman akan terus menampilkan rekaman terakhir. Jika Anda bergerak mundur melewati rekaman pertama, tampilan rekaman akan terus menampilkan rekaman pertama.

Baca juga

Bagan Hierarki