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# 编程指南）。

TableAdapter 概述相关推荐

TableAdapter和DataAdapter有何区别
在使用DataAdapter时,需要将查出的数据起一个表名放到DATASET中,一个DATASET可以存放多个表,而TableAdapter的结果就是一个表,不能在继续添加表. DataAdapter ...
Java 多线程概述
多线程技术概述 1.线程与进程进程:内存中运行的应用程序,每个进程都拥有一个独立的内存空间. 线程:是进程中的一个执行路径,共享一个内存空间,线程之间可以自由切换.并发执行,一个进程最少有一个线程, ...
【SpringMVC】概述
概述: SpringMVC:是基于spring的一个框架, 实际上就是spring的一个模块, 专门是做web开发的. 理解是servlet的一个升级 Sp ...
梯度下降优化算法概述
本文原文是 An overview of gradient descent optimization algorithms,同时作者也在 arXiv 上发了一篇同样内容的论文. 本文结合了两者来翻译 ...
Redis概述和基础
Redis 1.NoSQL NoSQL = Not Only SQL(不仅仅是SQL) 泛指非关系型数据库的,随着web2.0互联网的诞生!传统的关系型数据库很难对付web2.0时代!尤其是超大规模的 ...
OpenCL™（开放计算语言）概述
OpenCL™(开放计算语言)概述异构系统并行编程的开准 OpenCL™(开放计算语言)是一种开放的.免版税的标准,用于对超级计算机.云服务器.个人计算机.移动设备和嵌入式平台中的,各种加速器进行跨 ...
自动驾驶QNX，Linux，Autosar概述
自动驾驶QNX,Linux,Autosar概述 QNX是一个分布式.嵌入式.可规模扩展的实时操作系统.遵循POSIX.1 (程序接口)和POSIX.2 (Shell和工具).部分遵循POSIX.1b( ...
Tengine MLOps概述
Tengine MLOps概述大幅提高产业应用从云向边缘迁移的效率 MLOps Cloud Native 聚焦于提升云端的运营过程效率 MLOps Edge Native 聚焦于解决边缘应用开发及异 ...
Tengine Web服务器概述
Tengine Web服务器概述 Tengine是由淘宝网发起的Web服务器项目.在Nginx的基础上,针对大访问量网站的需求,添加了很多高级功能和特性.目的是打造一个高效.安全的Web平台. 发展 ...

TableAdapter 概述

TableAdapter 概述相关推荐

最新文章

热门文章