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

發行項
08/21/2008

更新：2007 年 11 月

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

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

建立新的 [Windows 應用程式] 專案。
使用 [資料來源組態精靈] 建置資料集，藉以建立和設定應用程式中的資料來源。
在 [DataSet 設計工具] 中開啟新的資料集。
使用 [TableAdapter 查詢組態精靈]，將查詢加入至 TableAdapter。

必要條件

若要完成這個逐步解說，您必須要有：

存取 Northwind 範例資料庫 (SQL Server 或 Access 版本)。如需詳細資訊，請參閱 HOW TO：安裝範例資料庫。

建立新的 Windows 應用程式

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

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

在 Visual Studio 中，從 [檔案] 功能表建立新專案。
在 [專案類型] 窗格中，選擇程式設計語言。
在 [範本] 窗格中，按一下 [Windows 應用程式]。
將專案命名為 TableAdapterQueriesWalkthrough，再按 [確定]。

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

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

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

若要建立資料來源

在 [資料] 功能表上，請按一下 [顯示資料來源]。
在 [資料來源] 視窗中，選取 [加入新資料來源]，啟動 [資料來源組態精靈]。
選取 [選擇資料來源類型] 頁面上的 [資料庫]，再按 [下一步]。
在 [選擇資料連接] 頁面上，執行下列其中一項動作：
- 如果下拉式清單中有提供 Northwind 範例資料庫的資料連接，請選取這個資料連接。
  
  -或-
- 選取 [新增連接]，啟動 [新增/修改連接] 對話方塊。如需詳細資訊，請參閱新增/修改連接對話方塊 (一般)。
如果資料庫需要密碼，請選取選項來加入敏感性資料，然後按一下 [下一步]。
按一下 [將連接字串儲存到應用程式組態檔] 頁面上的 [下一步]。
在 [選擇您的資料庫物件] 頁面上，展開 [資料表] 節點。
選取 [Customers] 資料表，再按 [完成]。

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

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

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

在 [資料來源] 視窗的 [NorthwindDataset] 上按一下滑鼠右鍵。
在快速鍵功能表上選擇 [以設計工具編輯資料集]。

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

將第二個查詢加入至 CustomersTableAdapter

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

若要將查詢加入至 CustomersTableAdapter

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

TableAdapter 查詢組態精靈隨即開啟。
選取 [使用 SQL 陳述式]，再按 [下一步]。
選取 [傳回資料列的 SELECT]，再按 [下一步]。

將 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 = ?)

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

注意事項：

這個逐步解說不使用 [傳回 DataTable] 的方法，所以您可以清除此核取方塊或保留預設名稱。
按 [下一步]，完成精靈。

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

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

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

若要執行查詢

從 [方案總管] 中，選取 [Form1]，再按一下 [檢視表設計工具]。
從 [資料來源] 視窗，將 [客戶] 節點拖曳至 [Form1]。
從 [檢視] 功能表中選取 [程式碼]，以切換至程式碼檢視。

將 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)).
將驗證邏輯加入資料集內資料表的 ColumnChanging 或 RowChanging 事件中。如需詳細資訊，請參閱資料驗證概觀。

請參閱

共用方式為