db_source

Membuat koneksi ke sumber data.

Sintaks

[ db_source(db_source, name, hresult) ]

Parameter

db_source
string koneksi digunakan untuk menyambungkan ke sumber data. Untuk format string koneksi, lihat String Koneksi dan Tautan Data di SDK Microsoft Data Access Components (MDAC).

nama
(Opsional) Saat Anda menggunakan db_source di kelas, nama adalah instans objek sumber data yang memiliki atribut db_source diterapkan padanya (lihat contoh 1). Saat Anda menggunakan db_source sebaris dalam implementasi metode, nama adalah variabel (lokal ke metode) yang dapat digunakan untuk mengakses sumber data (lihat contoh 2). Anda meneruskan nama ini ke parameter db_command source_name untuk mengaitkan sumber data dengan perintah.

hresult
(Opsional) Mengidentifikasi variabel yang akan menerima HRESULT dari perintah database ini. Jika variabel tidak ada, variabel akan secara otomatis disuntikkan oleh atribut .

Keterangan

db_source membuat CDataSource dan objek CSession, yang bersama-sama mewakili koneksi dengan sumber data konsumen OLE DB.

Saat Anda menggunakan db_source pada kelas, CSession objek menjadi anggota kelas.

Ketika Anda menggunakan db_source dalam metode , kode yang disuntikkan akan dijalankan dalam cakupan metode, dan CSession objek dibuat sebagai variabel lokal.

db_source menambahkan properti sumber data ke kelas atau dalam metode. Ini digunakan bersama dengan db_command (yang mengambil parameter nama db_source sebagai parameter source_name).

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.

Untuk contoh atribut ini yang digunakan dalam aplikasi, lihat MultiRead.

Contoh

Sampel ini memanggil db_source di kelas untuk membuat koneksi ke sumber ds data menggunakan database Northwind. ds adalah handel untuk sumber data, yang dapat digunakan secara internal ke CMyCommand kelas .

// db_source_1.cpp
// compile with: /LD
#include <atlbase.h>
#include <atlplus.h>
#include <atldbcli.h>

[
  db_source(L"my_connection_string", name="ds"),
  db_command(L"select * from Products")
]
class CMyCommand {};

Persyaratan

Konteks atribut	Nilai
Berlaku untuk	class, struct, anggota, metode, lokal
Berulang	No
Atribut yang diperlukan	Tidak
Atribut tidak valid	Tidak

Untuk informasi selengkapnya tentang konteks atribut, lihat Konteks Atribut.

Lihat juga

Atribut Konsumen OLE DB