共用方式為


逐步解說:以多個查詢建立 TableAdapter

更新:2007 年 11 月

在這個逐步解說中,您將使用資料來源組態精靈,在資料集建立 TableAdapter。此逐步解說將引導您使用 DataSet 設計工具內的 TableAdapter 查詢組態精靈,建立 TableAdapter 的第二個查詢。

逐步解說將說明的工作包括:

  • 建立新的 [Windows 應用程式] 專案。

  • 使用 [資料來源組態精靈] 建置資料集,藉以建立和設定應用程式中的資料來源。

  • 在 [DataSet 設計工具] 中開啟新的資料集。

  • 使用 [TableAdapter 查詢組態精靈],將查詢加入至 TableAdapter。

必要條件

若要完成這個逐步解說,您必須要有:

建立新的 Windows 應用程式

第一個步驟是建立 Windows 應用程式

若要建立新的 Windows 應用程式專案

  1. 在 Visual Studio 中,從 [檔案] 功能表建立新專案。

  2. 在 [專案類型] 窗格中,選擇程式設計語言。

  3. 在 [範本] 窗格中,按一下 [Windows 應用程式]。

  4. 將專案命名為 TableAdapterQueriesWalkthrough,再按 [確定]。

    Visual Studio 隨即將專案加入至 [方案總管],並在設計工具中顯示新表單。

使用 TableAdapter 建立資料庫資料來源

這個步驟會使用 [資料來源組態精靈],根據 Northwind 範例資料庫的 Customers 資料表建立資料來源。您必須可以存取 Northwind 範例資料庫,才能建立連接。如需設定 Northwind 範例資料庫的詳細資訊,請參閱 HOW TO:安裝範例資料庫

若要建立資料來源

  1. 在 [資料] 功能表上,請按一下 [顯示資料來源]。

  2. 在 [資料來源] 視窗中,選取 [加入新資料來源],啟動 [資料來源組態精靈]。

  3. 選取 [選擇資料來源類型] 頁面上的 [資料庫],再按 [下一步]。

  4. 在 [選擇資料連接] 頁面上,執行下列其中一項動作:

    • 如果下拉式清單中有提供 Northwind 範例資料庫的資料連接,請選取這個資料連接。

      -或-

    • 選取 [新增連接],啟動 [新增/修改連接] 對話方塊。如需詳細資訊,請參閱新增/修改連接對話方塊 (一般)

  5. 如果資料庫需要密碼,請選取選項來加入敏感性資料,然後按一下 [下一步]。

  6. 按一下 [將連接字串儲存到應用程式組態檔] 頁面上的 [下一步]。

  7. 在 [選擇您的資料庫物件] 頁面上,展開 [資料表] 節點。

  8. 選取 [Customers] 資料表,再按 [完成]。

    [NorthwindDataSet] 會加入至專案,而且 [Customers] 資料表會出現在 [資料來源] 視窗中。

在 Dataset 設計工具中開啟資料集

若要在 DataSet 設計工具中開啟資料集

  1. 在 [資料來源] 視窗的 [NorthwindDataset] 上按一下滑鼠右鍵。

  2. 在快速鍵功能表上選擇 [以設計工具編輯資料集]。

    NorthwindDataset 隨即在 [DataSet 設計工具] 中開啟。

將第二個查詢加入至 CustomersTableAdapter

精靈會建立具有 [Customers] 資料表和 [CustomersTableAdapter] 的資料集。本節的逐步解說會將第二個查詢加入至 [CustomersTableAdapter]。

若要將查詢加入至 CustomersTableAdapter

  1. 從 [工具箱] 的 [資料集] 索引標籤,將 [查詢] 拖曳至 [Customers] 資料表。

    TableAdapter 查詢組態精靈隨即開啟。

  2. 選取 [使用 SQL 陳述式],再按 [下一步]。

  3. 選取 [傳回資料列的 SELECT],再按 [下一步]。

  4. 將 WHERE 子句加入至查詢,如下所示:

    SELECT CustomerID, CompanyName, ContactName, ContactTitle, Address, City, Region, PostalCode, Country, Phone, Fax 
    FROM Customers 
    WHERE City = @City
    
    注意事項:

    如果您使用 Access 版本的 Northwind,請將 @City 參數替換成問號。(SELECT CustomerID, CompanyName, ContactName, ContactTitle, Address, City, Region, PostalCode, Country, Phone, Fax FROM Customers WHERE City = ?)

  5. 在 [選擇要產生的方法] 頁面上,將 [填入 DataTable] 方法命名為 FillByCity。

    注意事項:

    這個逐步解說不使用 [傳回 DataTable] 的方法,所以您可以清除此核取方塊或保留預設名稱。

  6. 按 [下一步],完成精靈。

    [FillByCity] 查詢隨即加入至 [CustomersTableAdapter]。

加入程式碼,在表單上執行其他查詢

若要執行查詢

  1. 從 [方案總管] 中,選取 [Form1],再按一下 [檢視表設計工具]。

  2. 從 [資料來源] 視窗,將 [客戶] 節點拖曳至 [Form1]。

  3. 從 [檢視] 功能表中選取 [程式碼],以切換至程式碼檢視。

  4. 將 Form1_Load 事件處理常式中的程式碼替換為下列程式碼,以執行 FillByCity 查詢。

    Dim cityValue As String = "Seattle"
    CustomersTableAdapter.FillByCity(NorthwindDataSet.Customers, cityValue)
    
    string cityValue = "Seattle";
    customersTableAdapter.FillByCity(northwindDataSet.Customers, cityValue);
    

執行應用程式

若要執行應用程式

  • 按 F5。

  • 此資料格會填入 City 值為 Seattle 的客戶。

後續步驟

若要將功能加入至應用程式中

  • 加入 TextBox 控制項和 Button 控制項,並將文字方塊中的值傳遞給查詢。(CustomersTableAdapter.FillByCity(NorthwindDataSet.Customers, TextBox1.Text)).

  • 將驗證邏輯加入資料集內資料表的 ColumnChangingRowChanging 事件中。如需詳細資訊,請參閱資料驗證概觀

請參閱

工作

HOW TO:建立 TableAdapter

HOW TO:建立 TableAdapter 查詢

概念

TableAdapter 概觀

資料的新功能

其他資源

資料逐步解說

連接至 Visual Studio 中的資料

準備您的應用程式以接收資料

將資料擷取至您的應用程式中

顯示 Windows 應用程式之表單上的資料

在您的應用程式中編輯資料