如何：执行 TableAdapter 查询

更新：2007 年 11 月

TableAdapter 查询是您的应用程序可对数据库执行的 SQL 语句或存储过程，它在 TableAdapter 上公开为类型化方法。您可以通过调用关联的方法执行 TableAdapter 查询，就像对对象应用任意方法一样。

TableAdapter 查询可以填充数据表（Fill 和 FillBy 查询）或返回以通过查询返回的数据填充的新数据表（GetData 和 GetDataBy 查询）。

通过运行 TableAdapter 查询配置向导，您可以将查询添加到现有的 TableAdapter。

创建 TableAdapter 的实例

您必须先创建 TableAdapter 的实例，才能调用它的任何方法。

说明：
即使使用“数据集设计器”创建并编辑 TableAdapter，但实际上 TableAdapter 并非数据集中的嵌套类。TableAdapter 位于某个命名空间内，该命名空间是根据与 TableAdapter 关联的数据集名称所标识的。命名约定为：DataSetName +“TableAdapter”。例如，所有与 NorthwindDataSet 关联的 TableAdapter 都将位于 NorthwindDataSetTableAdapter 命名空间内。如果存在 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 查询

您可以直接将查询从“工具箱”中拖到“数据集设计器”上，以创建独立的查询（不带数据表的查询）。

执行返回单（标量）值的 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();
  

请参见

任务

如何：创建 TableAdapter

如何：创建 TableAdapter 查询

如何：编辑 TableAdapter 查询

如何：使用 TableAdapter 直接访问数据库

演练：用 TableAdapter DBDirect 方法保存数据

如何：使用 Windows 窗体 BindingNavigator 控件定位数据

演练：在 Windows 应用程序中的窗体上显示数据

概念

TableAdapter 概述

“显示数据”概述

数据集设计器

数据源概述

其他资源

将数据获取到应用程序

验证数据