ATL OLE DB 消費者精靈

Visual Studio 2019 及更新版本中未提供此精靈。

此精靈會設定 OLE DB 消費者類別，其中含有透過指定的 OLE DB 提供者存取指定資料來源所需的資料繫結。

UIElement 清單

• 資料來源

  [資料來源] 按鈕可讓您使用指定的 OLE DB 提供者來設定指定的資料來源。 當您按一下此按鈕時，[資料連結屬性] 對話方塊隨即出現。 如需有關建置連接字串和 [資料連結屬性] 對話方塊的詳細資訊，請參閱 Windows SDK 文件中的資料連結 API 概觀。

  下列其他資訊將說明 [資料連結屬性] 對話方塊中的索引標籤。

  • [提供者] 索引標籤

    選取適當的提供者來管理資料來源的連線。 提供者的類型通常取決於您所連線的資料庫類型。 按一下 [下一步] 按鈕或 [連線] 索引標籤。

  • [連線] 索引標籤

    此索引標籤的內容取決於您選取的提供者。 雖然有許多類型的提供者，但本節涵蓋兩種最常見的連線：SQL 和 ODBC 數據。 其他的則為此處所述欄位上的類似變體。

    針對 SQL 資料：

    1. 選取或輸入伺服器名稱： 按下拉功能表以顯示網路上所有已註冊的數據伺服器，然後選取一部。

    2. 輸入登入伺服器的信息： 輸入使用者名稱和密碼以登入資料伺服器。

       注意

       有個關於 [資料連結屬性] 對話方塊中「允許儲存密碼」功能的安全性問題。 在 [輸入資訊以登入伺服器] 中，有兩個選項按鈕：

       • 使用 Windows NT 整合安全性
       • 使用特定的使用者名稱和密碼

       如果您選取 [使用特定的使用者名稱和密碼]，則可選擇儲存密碼 (使用「允許儲存密碼」的核取方塊)；不過，這個選項不安全。 建議您選取 [使用 Windows NT 整合安全性]；這個選項很安全，因為它會將密碼加密。 在某些情況下，您可能想要選取 [允許儲存密碼]。例如，如果您使用私人資料庫解決方案發行連結庫，則不應該直接存取資料庫，而是改用仲介層應用程式來驗證使用者（透過您選擇的驗證配置），然後限制使用者可用的數據種類。

    3. 選取伺服器上的資料庫： 按下拉功能表，在數據伺服器上顯示所有已註冊的資料庫，然後選取一個資料庫。

       - 或 -

       將資料庫檔案附加為資料庫名稱： 指定要作為資料庫使用的檔案;輸入明確的路徑名稱。

    針對 ODBC 資料：

    1. 指定資料來源：您可以使用資料來源名稱或 連接字串。

       使用數據來源名稱： 此下拉式清單會顯示在您的計算機中註冊的數據源。 您可以事先使用 ODBC 資料來源管理員來設定資料來源

       - 或 -

       使用 連接字串：輸入您已經取得的 連接字串，或按兩下 [建置] 按鈕;[選取數據源] 對話框隨即出現。 選取檔案或機器資料來源，然後按一下 [確定]。

       注意

       您可以在 [伺服器總管] 中檢視現有連線的屬性來取得連接字串，或者，您可以在 [伺服器總管] 中按兩下 [新增連線] 來建立連線。

    2. 輸入登入伺服器的信息： 輸入使用者名稱和密碼以登入資料伺服器。

    3. 輸入要使用的初始目錄。

    4. 按一下 [測試連線]；如果測試成功，按一下 [確定]。 如果沒有，請檢查您的登入資訊、嘗試另一個資料庫或嘗試另一部資料伺服器。

  • 進階索引標籤

    網路設定： 指定 模擬層級（模擬伺服器在模擬客戶端時允許使用的模擬層級 ;直接對應至 RPC 模擬層級）和保護 層級（用戶端與伺服器之間所傳送數據的保護層級;直接對應至 RPC 保護層級 ）。

    其他： 在 [連線逾時] 中，指定逾時前允許的空閒時間秒數。 在 [存取權限] 中，指定資料連線的存取權限。

    如需進階初始化屬性的詳細資訊，請參閱每個特定 OLE DB 提供者所提供的文件。

  • [全部] 索引標籤

    此索引標籤會顯示您已指定之資料來源與連線的初始化屬性摘要。 您可以編輯這些值。

    按一下 [確定] 以完成。 [選取資料庫物件] 對話方塊隨即出現。 從這個對話方塊中，選取消費者將使用的資料表、檢視或預存程序。

• 類別

  選取資料來源之後，根據您所選取的資料表或預存程序，使用預設類別名稱填入此方塊 (請參閱下方的選取資料來源)。 您可以編輯類別名稱。

• .h 檔案

  選取資料來源之後，根據您所選取的資料表或預存程序，使用預設標頭類別名稱填入此方塊 (請參閱下方的選取資料來源)。 您可以編輯標頭檔的名稱或選取現有的標頭檔。

• 使用屬性

  這個選項會指定精靈是否將使用屬性或範本宣告來建立消費者類別。 當您選取此選項時，精靈會使用屬性而非範本宣告 (這是預設選項)。 當您取消選取此選項時，精靈會使用範本宣告而非屬性。

  • 如果您針對消費者型別選取 [資料表]，精靈就會使用 db_source 和 db_table 屬性來建立資料表和資料表存取子類別宣告，並使用 db_column 來建立資料行對應。 例如，它會建立此對應：

    // Inject table class and table accessor class declarations
    [db_source("<initialization_string>"), db_table("dbo.Orders")]
    ...
    // Column map
    [ db_column(1, status=m_dwOrderIDStatus, length=m_dwOrderIDLength) ] LONG m_OrderID;
    [ db_column(2, status=m_dwCustomerIDStatus, length=m_dwCustomerIDLength) ] TCHAR m_CustomerID[6];
    ...
    

    而不使用 CTable 範本類別來宣告資料表和資料表存取子類別，以及 BEGIN_COLUMN_MAP 和 END_COLUMN_MAP 巨集來建立資料行對應，如此範例所示：

    // Table accessor class
        class COrdersAccessor; // Table class
        class COrders : public CTable<CAccessor<COrdersAccessor>>;
    // ...
    // Column map
        BEGIN_COLUMN_MAP(COrderDetailsAccessor)
            COLUMN_ENTRY_LENGTH_STATUS(1, m_OrderID, m_dwOrderIDLength, m_dwOrderIDStatus)
            COLUMN_ENTRY_LENGTH_STATUS(2, m_CustomerID, m_dwCustomerIDLength, m_dwCustomerIDStatus)
            // ...
        END_COLUMN_MAP()
    

  • 如果您針對消費者型別選取 [命令]，精靈會使用 db_source 和 db_command 屬性，並使用 db_column 來建立資料行對應。 例如，它會建立此對應：

    [db_source("<initialization_string>"), db_command("SQL_command")]
    ...
    // Column map using db_column is the same as for consumer type of 'table'
    

    而不使用命令類別 .h 檔案中的命令和命令存取子類別宣告，例如：

    // Command accessor class:
        class CListOrdersAccessor;
    // Command class:
        class CListOrders : public CCommand<CAccessor<CListOrdersAccessor>>;
    // ...
    // Column map using BEGIN_COLUMN_MAP ... END_COLUMN_MAP is the same as
    // for consumer type of 'table'
    

    如需詳細資訊，請參閱屬性的基本機制。

• 類型

  選取這些選項按鈕其中一個，以指定是否將從 CTable 或 CCommand (預設值) 衍生消費者類別。

  • Table

    如果您想要使用 CTable 或 db_table 來建立資料表和資料表存取子類別宣告，請選取此選項。

  • 命令

    如果您想要使用 CCommand 或 db_command 來建立命令和命令存取子類別宣告，請選取此選項。 這是預設選項。

• 支援

  選取核取方塊以指定消費者中支援的更新類型 (預設值為無)。 下列各項將設定 DBPROP_IRowsetChange，並在屬性設定對應中針對 DBPROP_UPDATABILITY 設定適當的項目。

  • 變更

    指定消費者支援更新資料列集中的資料列資料。

  • 插入

    指定消費者支援將資料列插入至資料列集。

  • 刪除

    指定消費者支援從資料列集刪除資料列。