TableAdapter 概述

项目
06/09/2015

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

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

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

在 Visual Studio 的前一版本中，使用 ADO.NET 数据适配器在应用程序和数据库之间通信。尽管数据适配器仍是 .NET Framework 数据提供程序的一个主要组件，而 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.Update 来处理对于关联的数据表处于挂起状态的插入、更新和删除。

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

TableAdapter 对可以为 null 的类型的支持

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

请参见

通过