HOW TO：執行 TableAdapter 查詢

發行項
02/28/2013

TableAdapter 查詢是指應用程式可對資料庫執行的 SQL 陳述式或預存程序，而且會公開 (Expose) 成 TableAdapter 上的具型別方法。您可以藉由呼叫關聯的方法來執行 TableAdapter 查詢，就如何對任何物件使用任何方法一樣。

TableAdapter 查詢可以填入資料表 (Fill 和 FillBy 查詢) 或是傳回已填入查詢 (GetData 和 GetDataBy 查詢) 傳回的資料之新資料表。

您可以將查詢加入到現有的 TableAdapter 中，其方式是執行 TableAdapter 查詢組態精靈

建立 TableAdapter 的執行個體

您必須先建立 TableAdapter 的執行個體，才能呼叫其任何方法。

注意事項
即使 TableAdapter 是使用 [DataSet 設計工具] 建立並編輯的，但 TableAdapter 實際上並不是資料集內的巢狀類別 (Nested Class)。TableAdapter 會位於某個命名空間 (Namespace) 內，而此命名空間是根據與 TableAdapter 關聯的資料集名稱所識別。其命名慣例為：DataSetName + "TableAdapters"。例如，所有與 NorthwindDataSet 關聯的 TableAdapter 都會位於 NorthwindDataSetTableAdapters 命名空間內。如果其中有一個 CustomersTableAdapter，則其完整名稱就會是 NorthwindDataSetTableAdapters.CustomersTableAdapter。

即使 TableAdapter 是使用 [DataSet 設計工具] 建立並編輯的，但 TableAdapter 實際上並不是資料集內的巢狀類別 (Nested Class)。TableAdapter 會位於某個命名空間 (Namespace) 內，而此命名空間是根據與 TableAdapter 關聯的資料集名稱所識別。其命名慣例為：DataSetName + "TableAdapters"。例如，所有與 NorthwindDataSet 關聯的 TableAdapter 都會位於 NorthwindDataSetTableAdapters 命名空間內。如果其中有一個 CustomersTableAdapter，則其完整名稱就會是 NorthwindDataSetTableAdapters.CustomersTableAdapter。

若要建立 TableAdapter 的執行個體

將項目從 [資料來源] 視窗拖曳至 Windows 應用程式中的表單，即可自動在表單上建立 TableAdapter 的執行個體。接著在元件匣 (表單下方框線下的一個小區域) 中檢查 TableAdapter 執行個體的名稱。

-或-
建立 TableAdapter 後，請建置專案。然後 TableAdapter 就會顯示在 [工具箱] 內。將 TableAdapter 從 [工具箱] 拖曳至表單，即可建立執行個體。接著在元件匣中檢查 TableAdapter 執行個體的名稱。

-或-

以程式設計方式建立 TableAdapter 執行個體：

Dim CustomersTableAdapter1 As NorthwindDataSetTableAdapters.CustomersTableAdapter
CustomersTableAdapter1 = New NorthwindDataSetTableAdapters.CustomersTableAdapter()

NorthwindDataSetTableAdapters.CustomersTableAdapter customersTableAdapter1;
customersTableAdapter1 = new NorthwindDataSetTableAdapters.CustomersTableAdapter();

執行可填入現有資料表的 TableAdapter 查詢 (Fill() 方法)

若要執行可填入現有資料表的 TableAdapter 查詢

請呼叫 TableAdapter 的 Fill 或 FillBy 查詢，然後傳入要填入的資料表中。例如，下列程式碼會執行 Fill 查詢，並填入 Customers 資料表：
```
CustomersTableAdapter1.Fill(NorthwindDataSet1.Customers)
```
```
customersTableAdapter1.Fill(northwindDataSet1.Customers);
```

執行可傳回新資料表的 TableAdapter 查詢 (GetData() 方法)

若要執行可傳回新資料表的 TableAdapter 查詢

請呼叫 TableAdapter 的 GetData 或 GetDataBy 查詢，即可傳回以查詢結果填入的具型別資料表。例如，下列程式碼會執行 GetData 查詢，並傳回 Customers 資料表：

Dim newCustomersTable As NorthwindDataSet.CustomersDataTable
newCustomersTable = CustomersTableAdapter1.GetData()

NorthwindDataSet.CustomersDataTable newCustomersTable;
newCustomersTable = customersTableAdapter1.GetData();

執行可傳回單一 (純量) 值的 TableAdapter 查詢

您可以直接從 [工具箱] 將查詢拖曳至 [DataSet 設計工具]，以建立獨立查詢 (不含資料表的查詢)。

若要執行可傳回單一 (純量) 值的 TableAdapter 查詢

請建立 TableAdapter 的執行個體、宣告要包含傳回值的變數，然後指派查詢結果給它。下列範例會假設 QueriesTableAdapter 上含有一個名為 CustomerCount 的查詢。

Dim scalarQueriesTableAdapter As NorthwindDataSetTableAdapters.QueriesTableAdapter
scalarQueriesTableAdapter = New NorthwindDataSetTableAdapters.QueriesTableAdapter()

Dim returnValue As Integer
returnValue = CType(scalarQueriesTableAdapter.CustomerCount(), Integer)

NorthwindDataSetTableAdapters.QueriesTableAdapter scalarQueriesTableAdapter;
scalarQueriesTableAdapter = new NorthwindDataSetTableAdapters.QueriesTableAdapter();

int returnValue;
returnValue = (int)scalarQueriesTableAdapter.CustomerCount();