TableAdapter 概述

更新:2007 年 11 月

TableAdapter 提供应用程序和数据库之间的通信。更具体地说,TableAdapter 连接到数据库,执行查询或存储过程,并返回用返回数据填充的新数据表或是用返回数据填充现有 DataTable。TableAdapter 还用于将更新数据从应用程序发送回数据库。

早期版本的 Visual Studio 的用户可以将 TableAdapter 视为具有内置连接对象并能够包含多个查询的 DataAdapter。每个添加到 TableAdapter 的查询都公开为公共方法,该公共方法就如同对象上的任何其他方法或函数那样进行调用。

除了 DataAdapter 的标准功能外,TableAdapter 还提供其他的类型化方法,这些方法对与关联的类型化 DataTable 共享公共架构的查询进行封装。换句话说,可以在 TableAdapter 上根据需要拥有任意多的查询,只要这些查询返回符合同一架构的数据即可。

在 Visual Studio 的前一版本中,使用 ADO.NET 数据适配器在应用程序和数据库之间通信。数据适配器仍然是 .NET Framework 数据提供程序 (ADO.NET) 的一个主要组件,而 TableAdapter 则是设计器生成的组件,它对 DataAdapter 的功能进行了改进。TableAdapter 通常包含 Fill 和 Update 方法,用于获取和更新数据库中的数据。

TableAdapter 是使用“数据集设计器”在强类型数据集中创建的。可以在使用 数据源配置向导 创建新数据集期间创建 TableAdapter。还可以使用 TableAdapter 配置向导 或通过将数据库对象从“服务器资源管理器”拖动到“数据集设计器”上,在现有数据集中创建 TableAdapter。有关更多信息,请参见如何:创建 TableAdapter

TableAdapter 是使用“数据集设计器”设计的,但生成的 TableAdapter 类并不是作为 DataSet 的嵌套类生成的。它们位于特定于每个数据集的独立命名空间中。例如,如果您有一个名为 NorthwindDataSet 的数据集,与 NorthwindDataSet 中的 DataTable 关联的 TableAdapter 将位于 NorthwindDataSetTableAdapters 命名空间中。要通过编程方法访问特定的 TableAdapter,必须声明 TableAdapter 的新实例。例如:

Dim northwindDataSet As New NorthwindDataSet()
Dim customersTableAdapter As New NorthwindDataSetTableAdapters.CustomersTableAdapter()

customersTableAdapter.Fill(northwindDataSet.Customers)
NorthwindDataSet northwindDataSet = new NorthwindDataSet();

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

customersTableAdapter.Fill(northwindDataSet.Customers);

关联的数据表架构

创建 TableAdapter 时,将使用初始查询或存储过程定义 TableAdapter 的关联 DataTable 的架构。通过调用 TableAdapter 的主 Fill 方法(此方法对 TableAdapter 的关联 DataTable 进行填充),可以执行此初始查询或存储过程。任何对 TableAdapter 的主查询的更改都会反映在关联数据表的架构中。例如,如果将一列从主查询中移除,该列也将从关联的数据表中移除。如果 TableAdapter 的任何附加查询使用的 SQL 语句将返回主查询中没有的列,设计器将尝试同步主查询和附加查询之间的列更改情况。有关更多信息,请参见如何:编辑 TableAdapter

TableAdapter 更新命令

TableAdapter 的更新功能依赖于有多少信息可用(基于 TableAdapter 向导中提供的主查询)。例如,配置为从多个表(联接)、标量值、视图或聚合函数的结果中获取值的 TableAdapter 最初创建时不具有将更新发送回基础数据库的能力。不过,可以在“属性”窗口中手动配置 INSERT、UPDATE 及 DELETE 命令。

TableAdapter 查询

带有多个查询的 TableAdapter

与标准数据适配器不同,TableAdapter 可以包含多个查询,以填充其关联数据表。只要每个查询所返回数据的架构与其关联数据表的架构相同,您就可以根据应用程序的需要定义任意多个 TableAdapter 查询。这样就能加载满足不同条件的数据。例如,如果应用程序包含一个 customers 表,您可以创建一个查询,使用名字以某个特定字母开头的所有客户填充表,而另一个查询则使用来自同一个州/省的所有客户填充该表。若要用处于给定州/省的客户填充 Customers 表,可以创建一个 FillByState 查询,该查询采用一个针对该州/省值的参数:SELECT * FROM Customers WHERE State = @State。可以通过调用 FillByState 方法并按照以下格式传递参数值来执行该查询:CustomerTableAdapter.FillByState("WA")。有关更多信息,请参见如何:创建 TableAdapter 查询

除了那些能返回与 TableAdapter 的数据表具有相同架构的数据的查询外,还可添加返回标量值(单值)的查询。例如,即使返回的数据并不符合表的架构,用来返回客户计数的查询 (SELECT Count(*) From Customers) 对 CustomersTableAdapter 也是有效的。

ClearBeforeFill 属性

TableAdapter 添加了一个 DataAdapter 基类所没有的属性。默认情况下,每次执行一个用来填充 TableAdapter 的数据表的查询时,数据会被清除,只将该查询的结果加载到表中。如果要将查询返回的数据添加或合并到数据表的现有数据中,请将 TableAdapter 的 ClearBeforeFill 属性设置为 false。无论是否清除数据,如果需要,都有必要显式地将更新发送回数据库。所以,在执行另一个填充表的查询前,请记住保存任何对表中数据所做的更改。有关更多信息,请参见如何:使用 TableAdapter 更新数据

TableAdapter 继承

TableAdapter 通过封装经过配置的 DataAdapter,扩展了标准数据适配器的功能。默认情况下,TableAdapter 从 Component 继承,无法强制转换为 DataAdapter 类。将 TableAdapter 强制转换为 DataAdapter 将导致 InvalidCastException。若要更改 TableAdapter 的基类,可以在“数据集设计器”中的 TableAdapter 的 Base Class 属性中键入从 Component 派生的类。

TableAdapter 的方法与属性

TableAdapter 类不是 .NET Framework 的一部分,因此,不能在文档或“对象浏览器”中查找它。它是在设计时使用前面提到的向导之一创建的。创建 TableAdapter 时为其分配的名称基于正在使用的表的名称。例如,基于数据库中名为 Orders 的表创建 TableAdapter 时,此 TableAdapter 会被命名为 OrdersTableAdapter。可以在“数据集设计器”中使用 Name 属性更改 TableAdapter 的类名称。

以下是常用的 TableAdapter 方法和属性:

成员

说明

TableAdapter.Fill

用 TableAdapter 的 SELECT 命令的结果填充 TableAdapter 的关联数据表。有关更多信息,请参见如何:使用数据填充数据集

TableAdapter.Update

将更改发送回数据库并返回一个整数,该整数表示更新所影响的行数。有关更多信息,请参见如何:使用 TableAdapter 更新数据

TableAdapter.GetData

返回一个用数据填充了的新 DataTable

TableAdapter.Insert

在数据表中创建新行。有关更多信息,请参见如何:向数据表中添加行

TableAdapter.ClearBeforeFill

确定数据表在您调用一个 Fill 方法之前是否被清空。

TableAdapter 的更新方法

TableAdapter 使用数据命令读取和写入数据库。TableAdapter 的初始 Fill(主)查询是创建关联数据表的架构的基础,也是与 TableAdapter.Update 方法关联的 InsertCommand、UpdateCommand 和 DeleteCommand 命令的基础。这意味着调用 TableAdapter 的 Update 方法将执行最初配置 TableAdapter 时创建的语句,而不是使用“TableAdapter 查询配置向导”添加的某个附加查询。

当使用 TableAdapter 时,它实际执行与您通常要执行的命令相同的操作。例如,当调用适配器的 Fill 方法时,适配器将执行其 SelectCommand 属性中的数据命令并使用数据读取器(例如,SqlDataReader)将结果集加载到数据表中。与此类似,调用适配器的 Update 方法时,它为数据表中每条更改过的记录执行相应的命令(在 UpdateCommand、InsertCommand 和 DeleteCommand 属性中)。

说明:

如果主查询中有足够的信息,生成 TableAdapter 时将默认创建 InsertCommand、UpdateCommand 和 DeleteCommand 命令。如果 TableAdapter 的主查询不只是一个表的 SELECT 语句,设计器可能无法生成 InsertCommand、UpdateCommand 和 DeleteCommand。如果没有生成这些命令,执行 TableAdapter.Update 方法时可能会收到一个错误。

TableAdapter GenerateDbDirectMethods

除了 InsertCommand、UpdateCommand 和 DeleteCommand 之外,创建 TableAdapter 时还生成了一些可以直接在数据库上执行的方法。可以直接调用这些方法(TableAdapter.Insert、TableAdapter.Update 和 TableAdapter.Delete)对数据库中的数据进行操作。

如果不想创建这些直接方法,可将 TableAdapter 的“GenerateDbDirectMethods”属性设置为 false(在“属性”窗口中)。添加到 TableAdapter 的附加查询是独立的查询 -- 它们不生成这些方法。

TableAdapter 对可空类型的支持

TableAdapter 支持可为空的类型 Nullable(Of T) 和 T?。有关 Visual Basic 中的可空类型的更多信息,请参见 可以为 Null 的值类型。有关 C# 中的可空类型的更多信息,请参见 使用可空类型(C# 编程指南)

请参见

任务

如何:连接到数据库中的数据

演练:连接到数据库中的数据

概念

数据中的新增功能

其他资源

数据演练

准备应用程序以接收数据

将数据获取到应用程序

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

在应用程序中编辑数据

验证数据

保存数据