db_accessor

Artikel
10/12/2023

Atribut grup db_column yang berpartisipasi dalam IAccessorpengikatan berbasis.

Sintaks

[ db_accessor(num, auto) ]

Parameter

num
Menentukan nomor aksesor (indeks bilangan bulat berbasis nol). Anda harus menentukan nomor aksesor dalam urutan yang meningkat, menggunakan bilangan bulat atau nilai yang ditentukan.

auto
Nilai Boolean yang menentukan apakah aksesor diambil secara otomatis (TRUE) atau tidak diambil (FALSE).

Keterangan

db_accessor mendefinisikan aksesor OLE DB yang mendasar db_column untuk berikutnya dan db_param atribut dalam kelas atau fungsi yang sama. db_accessor dapat digunakan pada tingkat anggota dan digunakan untuk mengelompokkan db_column atribut yang berpartisipasi dalam pengikatan berbasis OLE DBIAccessor. Ini digunakan bersama dengan db_table atribut atau db_command . Memanggil atribut ini mirip dengan memanggil makro BEGIN_ACCESSOR dan END_ACCESSOR .

db_accessor menghasilkan set baris dan mengikatnya ke peta aksesor yang sesuai. Jika Anda tidak memanggil db_accessor, aksesor 0 akan dibuat secara otomatis, dan semua pengikatan kolom akan dipetakan ke blok aksesor ini.

db_accessor mengelompokkan pengikatan kolom database ke dalam satu atau beberapa aksesor. Untuk diskusi tentang skenario di mana Anda perlu menggunakan beberapa pengakses, lihat Menggunakan Beberapa Aksesor pada Set Baris. Lihat juga "Dukungan Rekaman Pengguna untuk Beberapa Aksesor" di Rekaman Pengguna.

Ketika penyedia atribut konsumen menerapkan atribut ini ke kelas, pengkompilasi akan mengganti nama kelas menjadi _YourClassNameAccessor, di mana YourClassName adalah nama yang Anda berikan kelas, dan pengkompilasi juga akan membuat kelas yang disebut YourClassName, yang berasal dari _YourClassNameAccessor. Di Tampilan Kelas, Anda akan melihat kedua kelas.

Contoh

Contoh berikut menggunakan db_accessor untuk mengelompokkan kolom dalam tabel Pesanan dari database Northwind menjadi dua aksesor. Aksesor 0 adalah aksesor otomatis, dan aksesor 1 tidak.

// cpp_attr_ref_db_accessor.cpp
// compile with: /LD /link /OPT:NOREF
#define _ATL_ATTRIBUTES
#include <atlbase.h>
#include <atldbcli.h>

[ db_command(L"SELECT LastName, FirstName FROM Orders") ]
class CEmployees {
public:
   [ db_accessor(0, TRUE) ];
   [ db_column("1") ] LONG m_OrderID;
   [ db_column("2") ] TCHAR m_CustomerID[6];
   [ db_column("4") ] DBTIMESTAMP m_OrderDate;

   [ db_accessor(1, FALSE) ];
   [ db_column("8") ] CURRENCY m_Freight;
};

Persyaratan

Konteks atribut	Nilai
Berlaku untuk	Blok atribut
Berulang	Tidak
Atribut yang diperlukan	Tidak ada
Atribut tidak valid	Tidak ada

Untuk informasi selengkapnya tentang konteks atribut, lihat Konteks Atribut.

Bagikan melalui