共用方式為


HOW TO:執行 TableAdapter 查詢

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 的執行個體

  • 將項目從 [資料來源] 視窗拖曳至 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();
    

請參閱

工作

HOW TO:建立 TableAdapter

HOW TO:建立 TableAdapter 查詢

HOW TO:編輯 TableAdapter 查詢

HOW TO:以 TableAdapter 直接存取資料庫

逐步解說:使用 TableAdapter DBDirect 方法儲存資料

HOW TO:使用 Windows Form BindingNavigator 控制項巡覽資料

逐步解說:顯示 Windows Form 上的資料

概念

TableAdapter 概觀

將 Windows Form 控制項繫結至 Visual Studio 中的資料

DataSet 設計工具

資料來源概觀

其他資源

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

驗證資料