TableAdapter 概述

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 的新实例。例如：

Visual Basic  复制代码
Dim northwindDataSet As New NorthwindDataSet()
Dim customersTableAdapter As New NorthwindDataSetTableAdapters.CustomersTableAdapter()

customersTableAdapter.Fill(northwindDataSet.Customers)
 
C#  复制代码
NorthwindDataSet northwindDataSet = new NorthwindDataSet();

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

customersTableAdapter.Fill(northwindDataSet.Customers);
 
J#  复制代码
NorthwindDataSet northwindDataSet = new NorthwindDataSet();

NorthwindDataSetCustomersTableAdapter customersTableAdapter =
    new NorthwindDataSetCustomersTableAdapter();

customersTableAdapter.Fill(northwindDataSet.get_Customers());
 

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

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

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 中的可空类型的更多信息，请参见可能没有已定义值的值类型。有关 C# 中的可空类型的更多信息，请参见使用可空类型（C# 编程指南）。