在使用单个数据表且不需要考虑任何外键约束的情况下,将应用程序中的数据存回到数据库中非常简单。 但当您需要保存包含两个或更多相关数据表的数据集中的数据时,为了避免违反约束,必须将对数据表的更改以特定顺序发送到数据库。 在相关表中更新修改过的数据时,可以提供编程逻辑来从每个数据表中提取特定的数据子集,并以正确的顺序将更新发送到数据库,也可以使用 TableAdapterManager 组件。

本演练演示如何使用 TableAdapterManager 组件保存相关数据。 有关手动编写相关数据表更新的代码的信息,请参见演练:将数据保存到数据库(多个表)

系统必备

若要完成本演练,您需要:

创建基于 Windows 的应用程序

本演练的第一步是创建新的基于 Windows 的应用程序。

创建新的基于 Windows 的应用程序

  1. 从**“文件”**菜单创建一个新的项目。

    备注

    由于 Visual Basic 项目和 C# 项目都支持分层更新,所以可以使用这两种语言中的任意一种来创建新项目。

  2. 将项目命名为 HierarchicalUpdateWalkthrough。

  3. 选择**“Windows 窗体应用程序”,然后单击“确定”**。 有关更多信息,请参见 开发客户端应用程序

    **“HierarchicalUpdateWalkthrough”项目即被创建并添加到“解决方案资源管理器”**中。

创建数据集

由于您需要相关表来演示分层更新,因此下一步要从 Northwind 数据库创建包含 Customers 和 Orders 表的数据集。 使用**“数据源配置向导”**来创建数据集。 必须具有访问 Northwind 示例数据库的权限才能创建连接。 有关如何设置 Northwind 示例数据库的信息,请参见如何:安装示例数据库

创建数据集

  1. 在**“数据”菜单上,单击“显示数据源”**。

  2. 在**“数据源”窗口中,单击“添加新数据源”启动“数据源配置向导”**。

  3. 在**“选择数据源类型”页上,单击“数据库”,然后单击“下一步”**。

  4. 在**“选择您的数据连接”**页上执行下列操作之一:

    • 如果下拉列表框中包含与 Northwind 示例数据库的数据连接,请单击该连接。

      - 或 -

    • 单击**“新建连接”,打开“添加/修改连接”**对话框。 有关更多信息,请参见“添加/修改连接”对话框(通用)

  5. 如果数据库需要密码,请选择该选项以包括敏感数据,再单击**“下一步”**。

  6. 在**“将连接字符串保存到应用程序配置文件中”页上单击“下一步”**。

  7. 在**“选择数据库对象”页面上展开“表”**节点。

  8. 单击**“Customers”“Orders”表的复选框,然后单击“完成”**。

    **“NorthwindDataSet”将被创建并添加到您的项目中,并在“数据源”**窗口中显示这些表。

更改要创建的默认数据绑定控件

填充**“数据源”窗口后,可以选择将项拖到 Windows 窗体时要创建的控件。 对于本演练,Customers 表中的数据将在单独的控件(“Details”)中显示。 Orders 表中的数据将在 DataGridView 控件(“DataGridView”**)中显示。

为“数据源”窗口中的项设置控件

  1. 在**“数据源”窗口中展开“Customers”**节点。

  2. 在**“Customers”节点的控件列表中单击“Details”,将要为“Customers”**表创建的控件更改为单独的控件。 有关更多信息,请参见如何:设置从“数据源”窗口中拖动时要创建的控件

    备注

    “Orders”表将使用默认控件“DataGridView”

创建数据绑定窗体

在**“数据源”**窗口中选择控件后,可以通过将某些项拖到窗体上来创建数据绑定控件。

为 Customers 和 Orders 数据创建数据绑定控件

  1. 将主**“Customers”节点从“数据源”窗口拖到“Form1”**上。

    带有描述性标签的数据绑定控件会出现在窗体上,同时还显示一个**“TableAdapterManager”**组件和一个用于在记录间进行导航的工具栏 (BindingNavigator)。 组件栏中将出现一个类型化的 DataSetTableAdapter 和一个 BindingSource

  2. 将相关的**“Orders”节点从“数据源”窗口拖动到“Form1”**上。

    备注

    相关的“Orders”节点是“Customers”节点的子节点,位于 customers 表的“Fax”节点下。与“Customers”节点同级的“Orders”节点表示表中的所有订单。作为“Customers”节点的子节点的“Orders”节点表示相关订单。

    一个 DataGridView 控件和一个用于在记录间进行导航的工具栏 (BindingNavigator) 出现在窗体上。 TableAdapterBindingSource 出现在组件栏中。

修改生成的保存代码以执行分层更新

通过调用 TableAdapterManager.UpdateAll 方法并传入包含相关表的数据集的名称,可将数据集中相关数据表的更改保存到数据库。 例如,运行 TableAdapterManager.UpdateAll(NorthwindDataset) 方法将 NorthwindDataset 中所有表的更新发送到后端数据库。

从**“数据源”窗口拖放项后,代码会自动添加到 Form_Load 事件以填充每个表(TableAdapter.Fill 方法)。 系统还会向 BindingNavigator“保存”**按钮单击事件添加代码,将数据集中的数据存回数据库中(TableAdapterManager.UpdateAll 方法)。

生成的保存代码还包含调用 CustomersBindingSource.EndEdit 方法的一行代码。 更具体地说,它调用添加到窗体的第一个 BindingSourceEndEdit 方法。 也就是说,此代码只是为从**“数据源”窗口拖到窗体上的第一个表生成的。 EndEdit 调用将提交当前正在编辑的任何数据绑定控件中的所有更改。 因此,如果焦点仍在数据绑定控件上并且您单击了“保存”**按钮,则会先提交该控件中所有挂起的编辑,再执行真正的保存(TableAdapterManager.UpdateAll 方法)。

备注

设计器只为拖放到窗体上的第一个表添加 BindingSource.EndEdit 代码。因此,必须对窗体上的每个相关表添加一行调用 BindingSource.EndEdit 方法的代码。对于本演练,这意味着您必须添加一个对 OrdersBindingSource.EndEdit 方法的调用。

更新代码以在保存前提交对相关表的更改

  1. 双击 BindingNavigator 上的**“保存”按钮以在代码编辑器中打开“Form1”**。

  2. 在调用 CustomersBindingSource.EndEdit 方法的代码行后添加一行调用 OrdersBindingSource.EndEdit 方法的代码。 **“保存”**按钮单击事件中的代码应如下所示:

    Me.Validate()
    Me.CustomersBindingSource.EndEdit()
    Me.OrdersBindingSource.EndEdit()
    Me.TableAdapterManager.UpdateAll(Me.NorthwindDataSet)
    
    this.Validate();
    this.customersBindingSource.EndEdit();
    this.ordersBindingSource.EndEdit();
    this.tableAdapterManager.UpdateAll(this.northwindDataSet);
    

除了在将数据保存到数据库之前提交对相关子表的更改外,您可能还需要在向数据集添加新子记录之前先提交新创建的父记录。 也就是说,您可能需要先向数据集添加新父记录 (Customer),然后外键约束才允许将新子记录 (Orders) 添加到数据集中。 为实现这一点,可以使用子 BindingSource.AddingNew 事件。

备注

提交新父记录不是必需的;具体取决于用于绑定到数据源的控件的类型。在本演练中,您使用单独的控件绑定到父表;这需要额外的代码来提交新的父记录。如果父记录在类似于 DataGridView 的复杂绑定控件中显示,则对该父记录的额外 EndEdit 调用不是必需的。这是因为这类控件的基础数据绑定功能可以提交新记录。

添加代码以在添加新子记录之前在数据集中提交父记录

  1. 为 OrdersBindingSource.AddingNew 事件创建一个事件处理程序。

    • 在设计视图中打开**“Form1”,在组件栏中单击“OrdersBindingSource”,在“属性”窗口中选择“事件”,然后双击“AddingNew”**事件。
  2. 向事件处理程序添加调用 CustomersBindingSource.EndEdit 方法的一行代码。 OrdersBindingSource_AddingNew 事件处理程序中的代码应如下所示:

    Me.CustomersBindingSource.EndEdit()
    
    this.customersBindingSource.EndEdit();
    

验证分层更新已启用

通过设置数据集的**“分层更新”属性可打开或关闭分层更新。 默认情况下启用分层更新,因此对于本演练,不需要更改“分层更新”**属性的值。

验证分层更新已启用

  1. 在**“解决方案资源管理器”中双击“NorthwindDataSet.xsd”文件,以在“数据集设计器”**中打开该数据集。

  2. 选择设计图面上的空白区域。

  3. “属性”窗口中找到**“分层更新”属性,然后检查它是否设置为“True”**。

    备注

    “分层更新”属性设置用于控制生成的代码是否带有 TableAdapterManager 和执行分层更新所需的逻辑。将“HierarchicalUpdate”设置为“True”将生成 TableAdapterManager;将“HierarchicalUpdate”设置为“False”则不生成 TableAdapterManager。

测试应用程序

测试应用程序

  1. 按 F5。

  2. 对每个表中的一条或多条记录的数据执行一些更改。

  3. 添加新客户,然后添加该客户的新订单。

  4. 单击**“保存”**按钮。 TableAdapterManager 将处理所有相关更新所需的逻辑。

  5. 检查数据库中的值以验证更改已保存到每个表中。

后续步骤

根据应用程序的要求,在基于 Windows 的应用程序中保存相关数据后,可能还要执行一些步骤。 您可以对此应用程序进行的增强包括:

  • 添加第三个表,例如 OrderDetails 表,体验一下三个表的层次结构。

  • 添加验证代码以验证数据满足应用程序的要求和数据库约束。 有关更多信息,请参见验证数据

请参见

任务

如何:配置数据集中的外键约束

如何:设置分层更新的执行顺序

如何:在保存数据前提交数据绑定控件中正在进行的编辑

如何:在现有 Visual Studio 项目中实现分层更新

演练:保存相关数据表中的数据(分层更新)

概念

保存数据

其他资源

分层更新

DataSets in ADO.NET