如何：执行 TableAdapter 查询

项目
02/21/2013

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();