db_source
建立數據源的連接。
語法
[ db_source(db_source, name, hresult) ]
參數
db_source
用來連接到數據源的 連接字串。 如需 連接字串 的格式，請參閱 Microsoft 資料存取元件 （MDAC） SDK 中的連接字串和數據連結。
name
（選擇性）當您在類別上使用db_source時，name 是已套用db_source屬性的數據源對象的實例（請參閱範例 1）。 當您在 方法實作中使用db_source 內嵌時， name 是可用來存取數據源的變數（請參閱範例 2）。 您會將此名稱傳遞至 的 db_command source_name 參數，以將數據源與命令產生關聯。
hresult
（選擇性）識別將接收這個資料庫命令之 HRESULT 的變數。 如果變數不存在，則屬性會自動予以插入。
備註
db_source會建立 CDataSource 和 CSession 物件，此物件一起代表與 OLE DB 取用者數據源的連線。
當您在類別上使用 db_source 時， CSession 物件會變成 類別的成員。
當您在方法中使用 db_source 時，插入的程式代碼將會在方法範圍內執行，而且 CSession 物件會建立為局部變數。
db_source將數據源屬性新增至類別或方法內。 它與 db_command 搭配使用（採用 db_source name 參數作為其source_name參數）。
當取用者屬性提供者將這個屬性套用至類別時，編譯程式會將類別重新命名為 _YourClassName 存取子，其中 YourClassName 是您提供類別的名稱，編譯程式也會建立名為 YourClassName的類別，其衍生自 _YourClassName 存取子。 在 [類別] 檢視中，您會看到這兩個類別。
如需應用程式中使用的此屬性範例，請參閱 MultiRead。
範例
此範例會呼叫 類別上的db_source ，以使用 Northwind 資料庫建立數據源 ds 的連線。 ds 是數據源的句柄，可在類別內部 CMyCommand 使用。
// 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 {};
需求
| 屬性內容 | 值 |
|---|---|
| 適用於 | class、、 struct成員、方法、本機 |
| 可重複 | No |
| 必要屬性 | 無 |
| 無效屬性 | 無 |
如需有關屬性內容的詳細資訊，請參閱 屬性內容。