演练：自定义实体类的插入、更新和删除行为

注意

数据集和相关类是 2000 年代初的旧 .NET Framework 技术，使应用程序能够在应用程序与数据库断开连接时处理内存中的数据。 它们对于使用户能够修改数据并持续更改回数据库的应用程序特别有用。 虽然数据集已被证明是一项非常成功的技术，但我们建议新的 .NET 应用程序使用 Entity Framework Core。 实体框架提供了一种更自然的方式来将表格数据作为对象模型，并且具有更简单的编程接口。

Visual Studio 中的 LINQ to SQL 工具提供了一个可视化设计图面，用于创建和编辑基于数据库中对象的 LINQ to SQL 类（实体类）。 借助 LINQ to SQL，可以使用 LINQ 技术访问 SQL 数据库。 有关详细信息，请参阅 LINQ（语言集成查询）。

默认情况下，由 LINQ to SQL 运行时提供用于执行更新的逻辑。 该运行时基于表的架构（列定义和主键信息）创建默认的 Insert、Update 和 Delete 语句。 当不希望使用默认行为时，可以配置更新行为并指定特定的存储过程，来执行处理数据库中数据所必需的插入、更新和删除。 在不生成默认行为时（例如，实体类映射到视图时），也可以这样做。 另外，在数据库要求通过存储过程访问表时，您可以重写默认的更新行为。 有关详细信息，请参阅通过使用存储过程自定义操作。

注意

本演练要求可以使用 Northwind 数据库的“InsertCustomer”、“UpdateCustomer”和“DeleteCustomer”存储过程。

本演练提供了一些步骤，您必须执行这些步骤来重写默认的 LINQ to SQL 运行时行为，以便使用存储过程将数据保存回数据库。

在本演练中，你将了解如何执行以下任务：

• 创建一个新的 Windows 窗体应用程序，并将一个 LINQ to SQL 文件添加到该应用程序。

• 创建一个映射到 Northwind Customers 表的实体类。

• 创建一个引用 LINQ to SQL Customer 类的对象数据源。

• 创建一个包含绑定到 Customer 类的 DataGridView 的 Windows 窗体。

• 实现该窗体的保存功能。

• 通过将存储过程添加到 O/R 设计器来创建 DataContext 方法。

• 配置 Customer 类以使用存储过程执行插入、更新和删除。

先决条件

本演练使用 SQL Server Express LocalDB 和 Northwind 示例数据库。

1. 如果尚未安装 SQL Server Express LocalDB，可以从 SQL Server Express 下载页或通过 Visual Studio 安装程序安装。 在 Visual Studio 安装程序中，可以将 SQL Server Express LocalDB 作为数据存储和处理工作负载的一部分或作为单个组件进行安装 。

2. 按照以下步骤安装 Northwind 示例数据库：

   1. 在 Visual Studio 中，打开“SQL Server 对象资源管理器”窗口。 （在 Visual Studio 安装程序中 SQL Server 对象资源管理器作为数据存储和处理工作负载的一部分安装。）展开 SQL Server 节点 。 右键单击 LocalDB 实例并选择“新建查询”。

      此时将打开查询编辑器窗口。

   2. 将 Northwind Transact-SQL 脚本复制到剪贴板。 此 T-SQL 脚本从头开始创建 Northwind 数据库并用数据填充它。

   3. 将 T-SQL 脚本粘贴到查询编辑器中，然后选择“执行”按钮。

      不久后，查询完成运行并且 Northwind 数据库创建完成。

创建应用程序并添加 LINQ to SQL 类

因为要使用 LINQ to SQL 类并在 Windows 窗体中显示数据，所以需要创建一个新的 Windows 窗体应用程序并添加一个 LINQ to SQL 类文件。

注意

本文中的某些 Visual Studio 用户界面元素在计算机上出现的名称或位置可能会不同。 你可能正在使用不同版本的 Visual Studio 或不同的环境设置。 有关详细信息，请参阅个性化设置 IDE。

新建一个包含 LINQ to SQL 类的 Windows 窗体应用程序项目

1. 在 Visual Studio 的“文件”菜单中，依次选择“新建”>“项目” 。

2. 在左侧窗格中展开“Visual C#”或“Visual Basic”，然后选择“Windows 桌面” 。

3. 在中间窗格中，选择“Windows 窗体应用”项目类型。

4. 将项目命名为“UpdatingWithSProcsWalkthrough”，然后选择“确定” 。

   将创建 UpdatingwithSProcsWalkthrough 项目并将其添加到“解决方案资源管理器”中。

5. 在 “项目” 菜单上，单击 “添加新项”。

6. 单击“LINQ to SQL 类”模板，然后在“名称”框中键入 Northwind.dbml。

7. 单击 添加。

   这会将一个空的 LINQ to SQL 类文件 (Northwind.dbml) 添加到该项目中，并且会打开 O/R 设计器 。

创建 Customer 实体类和对象数据源

通过将数据库表从“服务器资源管理器”或“数据库资源管理器”拖动到 O/R 设计器上，创建映射到这些表的 LINQ to SQL 类 。 结果将生成映射到数据库中的表的 LINQ to SQL 实体类。 在创建实体类后，可以将这些类像具有公共属性的其他类一样用作对象数据源。

创建 Customer 实体类并使用该类配置数据源

1. 在“服务器资源管理器”或“数据库资源管理器”中，查找 Northwind 示例数据库的 SQL Server 版本中的 Customer 表 。

2. 将“Customers”节点从“服务器资源管理器”或“数据库资源管理器”拖动到 O/R 设计器图面上 。

   将创建一个名为“Customer”的实体类。 该类具有与 Customers 表中的列相对应的属性。 由于该实体类表示 Customers 表中的单个客户，因此将该类命名为“Customer”（而不是“Customers”）。

   注意

   这种重命名行为称为“复数化”。 可以在“选项”对话框中启用或禁用此行为。 有关详细信息，请参阅如何：启用和禁用复数化（O/R 设计器）。

3. 在“生成”菜单上单击“生成 UpdatingwithSProcsWalkthrough”以生成该项目。

4. 若要打开“数据源”窗口，在“数据”菜单上单击“显示数据源” 。

5. 在 “数据源” 窗口中，单击 “添加新数据源”。

6. 单击“选择数据源类型”页上的“对象”，然后单击“下一步”。

7. 展开“UpdatingwithSProcsWalkthrough”节点，然后找到并选择“Customer”类。

   注意

   如果“Customer”类不可用，则退出向导，生成项目，然后重新运行向导。

8. 单击“完成”以创建数据源，并将“Customer”实体类添加到“数据源”窗口。

创建一个 DataGridView 以在 Windows 窗体中显示 Customer 数据

通过将 LINQ to SQL 数据源项从“数据源”窗口拖动到 Windows 窗体上来创建绑定到实体类的控件。

添加绑定到实体类的控件

1. 在设计视图中打开“Form1”。

2. 将“Customer”节点从“数据源”窗口拖动到“Form1”上。

   注意

   若要显示“数据源”窗口，请单击“数据”菜单上的“显示数据源”。

3. 在代码编辑器中打开 Form1。

4. 将下面的代码添加到该窗体中。这些代码对于该窗体是全局性的，位于任何特定方法之外，但位于 Form1 类内部：

   C#

   private NorthwindDataContext northwindDataContext1
       = new NorthwindDataContext();
   

   VB

   Private NorthwindDataContext1 As New NorthwindDataContext
   

5. 为 Form_Load 事件创建一个事件处理程序，并将下面的代码添加到该处理程序中：

   C#

   customerBindingSource.DataSource
       = northwindDataContext1.Customers;
   

   VB

   CustomerBindingSource.DataSource = NorthwindDataContext1.Customers
   

实现保存功能

默认情况下，没有启用保存按钮，也没有实现保存功能。 此外，在为对象数据源创建数据绑定控件时，不会自动添加用于将更改后的数据保存到数据库的代码。 本节说明如何为 LINQ to SQL 对象启用保存按钮并实现保存功能。

实现保存功能

1. 在设计视图中打开“Form1”。

2. 在“CustomerBindingNavigator”上选择保存按钮（带有软盘图标的按钮）。

3. 在“属性”窗口中，将“Enabled”属性设置为“True”。

4. 双击保存按钮以创建一个事件处理程序并切换到代码编辑器。

5. 将下面的代码添加到保存按钮事件处理程序中：

   C#

   northwindDataContext1.SubmitChanges();
   

   VB

   NorthwindDataContext1.SubmitChanges()
   

重写用于执行更新（插入、更新和删除）的默认行为

重写默认更新行为

1. 在 O/R 设计器中打开“LINQ to SQL”文件。 （在“解决方案资源管理器”中双击“Northwind.dbml”文件。）

2. 在“服务器资源管理器”或“数据库资源管理器”中，展开 Northwind 数据库的“存储过程”节点并找到“InsertCustomers”、“UpdateCustomers”和“DeleteCustomers”存储过程。

3. 将所有这三个存储过程都拖动到 O/R 设计器上。

   这些存储过程将作为 DataContext 方法添加到方法窗格中。 有关详细信息，请参阅 DataContext 方法（O/R 设计器）。

4. 在 O/R 设计器中选择“Customer”实体类 。

5. 在“属性”窗口中选择“Insert”属性。

6. 单击“使用运行时”旁的省略号 (...) 以打开“配置行为”对话框。

7. 选择“自定义”。

8. 在“自定义”列表中选择“InsertCustomers”方法。

9. 单击“应用”保存所选择的类和行为的配置。

   注意

   只要在每次更改后单击“应用”，就可以继续为每个类/行为组合配置行为。 如果在单击“应用”之前更改类或行为，则会出现一个警告对话框，以提供一个应用任何更改的机会。

10. 在“行为”列表中选择“更新”。

11. 选择“自定义”。

12. 在“自定义”列表中选择“UpdateCustomers”方法。

    检查“方法参数”和“类属性”列表，会注意到，对于表中的某些列，有两个“方法参数”和两个“类属性”。 这样可以更加轻松地跟踪更改和创建检查并发冲突的语句。

13. 将“Original_CustomerID”方法参数映射到“CustomerID (Original)”类属性。

    注意

    默认情况下，当名称匹配时，方法自变量会映射到类属性。 如果属性名称发生更改并且在表与实体类之间不再匹配，则在 O/R 设计器无法确定正确的映射时，可能必须选择等效的类属性进行映射。 此外，如果方法参数没有用于进行映射的有效类属性，则可以将“类属性”值设置为“(无)”。

14. 单击“应用”保存所选择的类和行为的配置。

15. 选择“行为”列表中的“删除”。

16. 选择“自定义”。

17. 在“自定义”列表中选择“DeleteCustomers”方法。

18. 将“Original_CustomerID”方法参数映射到“CustomerID (Original)”类属性。

19. 单击 “确定” 。

注意

在本演练中，虽然以下事实并不会产生问题，但仍然需要注意：LINQ to SQL 会在插入和更新操作期间自动为标识（自动递增）列、rowguidcol（数据库生成的全局唯一标识符 (GUID)）列以及时间戳列处理数据库生成的值。 在其他列类型中，数据库生成的值将意外导致 Null 值。 若要返回数据库生成的值，应手动将 IsDbGenerated 设置为 true 并将 AutoSync 设置为下列值之一：AutoSync.Always、AutoSync.OnInsert 或 AutoSync.OnUpdate。

测试应用程序

再次运行应用程序以验证“UpdateCustomers”存储过程是否能够正确更新数据库中的客户记录。

1. 按 F5。

2. 修改网格中的一条记录以测试更新行为。

3. 添加一条新记录以测试插入行为。

4. 单击“保存”按钮将更改保存回数据库。

5. 关闭窗体。

6. 按 F5 并验证是否保存了更新的记录和新插入的记录。

7. 删除在步骤 3 中创建的新记录以测试删除行为。

8. 单击保存按钮以提交更改并从数据库中移除已删除的记录。

9. 关闭窗体。

10. 按 F5 并验证是否从数据库中移除了已删除的记录。

    注意

    如果应用程序使用 SQL Server Express Edition，则根据数据库文件的“复制到输出目录”属性值的不同，在步骤 10 中按 F5 时可能不会显示更改。

后续步骤

根据应用程序需求的不同，可能需要在创建 LINQ to SQL 实体类后执行几个步骤。 你可以对此应用程序进行的一些增强包括：

• 在更新过程中实现并发检查。 有关详细信息，请参阅乐观并发：概述。

• 添加 LINQ 查询以筛选数据。 有关详细信息，请参阅 LINQ 查询简介 (C#)。

相关内容

• Visual Studio 中的 LINQ to SQL 工具
• DataContext 方法
• 如何：分配存储过程以便执行更新、插入和删除操作
• LINQ to SQL
• LINQ to SQL 查询