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