演练：保存相关数据表中的数据（分层更新）

更新：2007 年 11 月

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

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

先决条件

若要完成本演练，您需要：

• 能够访问 Northwind 示例数据库。有关更多信息，请参见如何：安装示例数据库。

创建基于 Windows 的应用程序

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

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

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

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

2. 将项目命名为 HierarchicalUpdateWalkthrough。

3. 选择“Windows 窗体应用程序”，然后单击“确定”。有关更多信息，请参见创建基于 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)。组件栏中将出现一个类型化的 DataSet、TableAdapter 和一个 BindingSource。

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

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

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

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

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

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

生成的保存代码还包含调用 CustomersBindingSource.EndEdit 方法的一行代码。更具体地说，它调用添加到窗体的第一个 BindingSource 的 EndEdit 方法。也就是说，此代码只是为从“数据源”窗口拖到窗体上的第一个表生成的。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 项目中实现分层更新

演练：保存相关数据表中的数据（分层更新）

其他资源

分层更新

保存数据

使用数据集 (ADO.NET)