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

  • 發行項

 

發佈時間: 2016年4月

在這個逐步解說中，您將使用資料來源組態精靈在資料集中建立 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 範例資料庫的詳細資訊，請參閱如何：安裝範例資料庫。

若要建立資料來源

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

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

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

  4. 在 [選擇資料連接] 頁面上，執行下列其中一項：

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

      -或-

    • 選取 [新增連接]，啟動 [新增/修改連接] 對話方塊。

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

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

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

  8. 選取 [Customers] 資料表，然後按一下 [完成]。

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

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

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

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

  2. 在捷徑功能表上，選擇 [以設計工具編輯資料集]。

    [DataSet 設計工具] 中就會開啟 NorthwindDataset。

將第二個查詢加入至 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
    System_CAPS_note注意事項

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

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

    System_CAPS_note注意事項

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

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

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

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

查詢查詢

  1. 在 [方案總管] 中選取 [Form1]，然後按一下 [檢視設計工具]。

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

  3. 從 [檢視] 功能表中選取 [程式碼] ，以變更為程式碼檢視。

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

    string cityValue = "Seattle";
customersTableAdapter.FillByCity(northwindDataSet.Customers, cityValue);

    Dim cityValue As String = "Seattle"
CustomersTableAdapter.FillByCity(NorthwindDataSet.Customers, cityValue)

執行應用程式

若要執行應用程式

  • 按 F5。

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

後續步驟

加入應用程式的功能

請參閱

TableAdapter 概觀
如何：建立 TableAdapter
如何：建立 TableAdapter 查詢
資料逐步解說
連接至 Visual Studio 中的資料
準備您的應用程式以接收資料
將資料擷取至您的應用程式中
將控制項繫結至 Visual Studio 中的資料
在您的應用程式中編輯資料