设计器 CUD 存储过程Designer CUD Stored Procedures

此分步演练演示如何使用 Entity Framework Designer （EF 设计器）将实体类型的 create\插入、更新和删除（CUD）操作映射到存储过程。 默认情况下，实体框架会自动为 CUD 操作生成 SQL 语句，但也可以将存储过程映射到这些操作。

请注意，Code First 不支持映射到存储过程或函数。 但是，可以使用 DbSet. SqlQuery 方法调用存储过程或函数。 例如：

  1. var query = context.Products.SqlQuery("EXECUTE [dbo].[GetAllProducts]");

将 CUD 操作映射到存储过程时的注意事项Considerations when Mapping the CUD Operations to Stored Procedures

将 CUD 操作映射到存储过程时，请注意以下事项：

  • 如果要将其中一个 CUD 操作映射到存储过程，请映射所有这些操作。 如果未映射所有这三个映射，则未映射的操作将失败（如果执行）并引发 UpdateException 。
  • 必须将存储过程的每个参数映射到实体属性。
  • 如果服务器为插入的行生成主键值，则必须将此值映射回实体的键属性。 在下面的示例中， InsertPerson 存储过程返回新创建的主键作为存储过程的结果集的一部分。 使用>EF 设计器 功能 <添加结果绑定，将主键映射到实体键（PersonID）。
  • 存储过程调用映射到概念模型中的实体1:1。 例如，如果在概念模型中实现了继承层次结构，然后映射父级（base）和子（派生）实体的 CUD 存储过程，则保存子更改将仅调用子对象的存储过程，而不会触发父级的存储过程调用。

先决条件Prerequisites

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

设置项目Set up the Project

  • 打开 Visual Studio 2012。
  • 选择 “文件->”> 项目
  • 在左窗格中，单击 “ Visual C# “，然后选择 “控制台“ 模板。
  • 输入 “ CUDSProcsSample “ 作为名称。
  • 选择“确定”。 ****

创建模型Create a Model

  • 右键单击 “解决方案资源管理器中的项目名称，然后选择”添加-> 新项“。

  • 从左侧菜单中选择 “数据“，然后在 “模板” 窗格中选择 “ ADO.NET 实体数据模型。

  • 输入CUDSProcs作为文件名，然后单击 “添加“。

  • 在 “选择模型内容” 对话框中，选择 “ 从数据库生成“，然后单击 “ 下一步“。

  • 单击 “ 新建连接“。 在 “连接属性” 对话框中，输入服务器名称（例如， （localdb）\mssqllocaldb），选择身份验证方法，为数据库名称键入 School ，然后单击 “确定” 。 “选择您的数据连接” 对话框将通过数据库连接设置进行更新。

  • 在 “选择数据库对象” 对话框中的 “ 表 “ 节点下，选择 Person表。

  • 另外，在 “存储过程和函数“ 节点下选择以下存储过程： DeletePerson、 InsertPerson和UpdatePerson。

  • 从 Visual Studio 2012 开始，EF 设计器支持存储过程的大容量导入。 默认情况下，将选中 “将选定的存储过程和函数导入实体模型“。 由于在此示例中，我们已存储了用于插入、更新和删除实体类型的存储过程，因此我们不想将它们导入，并将取消选中此复选框。

    导入过程

  • 单击 “ 完成“。 显示了 EF 设计器（提供编辑模型的设计图面）。

将 Person 实体映射到存储过程Map the Person Entity to Stored Procedures

  • 右键单击 “ 人员“ 实体类型，然后选择 “ 存储过程映射“。

  • 存储过程映射显示在 “ 映射详细信息“ “窗口中。

  • 单击 <选择 “插入函数”> 。 该字段变成一个下拉列表，该列表中包含存储模型中可以映射到概念模型中的实体类型的存储过程。 从下拉列表中选择 “ InsertPerson “。

  • 此时将显示存储过程参数和实体属性之间的默认映射。 请注意，箭头指示映射方向：向存储过程参数提供属性值。

  • 单击 <添加结果绑定> 。

  • 键入 NewPersonID， InsertPerson 存储过程返回的参数的名称。 请确保不要键入前导空格或尾随空格。

  • 按 enter。

  • 默认情况下， NewPersonID 映射到实体键 PersonID。 请注意，箭头指示映射的方向：向属性提供结果列的值。

    映射详细信息

  • 单击 “ <> 选择” 更新函数“，然后从生成的下拉列表中选择” UpdatePerson “。

  • 此时将显示存储过程参数和实体属性之间的默认映射。

  • 单击 “ <> 选择” 删除函数“，然后从生成的下拉列表中选择” DeletePerson “。

  • 此时将显示存储过程参数和实体属性之间的默认映射。

用户 实体类型的插入、更新和删除操作现已映射到存储过程。

如果要在使用存储过程更新或删除实体时启用并发检查，请使用下列选项之一：

  • 使用OUTPUT参数从存储过程中返回受影响的行数，并选中参数名称旁的 “受影响的行” 参数 复选框。 如果调用操作时返回的值为零，则将引发 OptimisticConcurrencyException 。
  • 选中要用于并发检查的属性旁边的 “使用原始值“ 复选框。 尝试更新时，在将数据写回数据库时，将使用最初从数据库读取的属性的值。 如果值与数据库中的值不匹配，则将引发OptimisticConcurrencyException 。

使用模型Use the Model

打开Program.cs文件，其中定义了Main方法。 将以下代码添加到 Main 函数中。

此代码创建一个新的Person对象，然后更新该对象，最后删除该对象。

  1.     using (var context = new SchoolEntities())
  2.     {
  3.         var newInstructor = new Person
  4.         {
  5.             FirstName = "Robyn",
  6.             LastName = "Martin",
  7.             HireDate = DateTime.Now,
  8.             Discriminator = "Instructor"
  9.         }
  11.         // Add the new object to the context.
  12.         context.People.Add(newInstructor);
  14.         Console.WriteLine("Added {0} {1} to the context.",
  15.             newInstructor.FirstName, newInstructor.LastName);
  17.         Console.WriteLine("Before SaveChanges, the PersonID is: {0}",
  18.             newInstructor.PersonID);
  20.         // SaveChanges will call the InsertPerson sproc.  
  21.         // The PersonID property will be assigned the value
  22.         // returned by the sproc.
  23.         context.SaveChanges();
  25.         Console.WriteLine("After SaveChanges, the PersonID is: {0}",
  26.             newInstructor.PersonID);
  28.         // Modify the object and call SaveChanges.
  29.         // This time, the UpdatePerson will be called.
  30.         newInstructor.FirstName = "Rachel";
  31.         context.SaveChanges();
  33.         // Remove the object from the context and call SaveChanges.
  34.         // The DeletePerson sproc will be called.
  35.         context.People.Remove(newInstructor);
  36.         context.SaveChanges();
  38.         Person deletedInstructor = context.People.
  39.             Where(p => p.PersonID == newInstructor.PersonID).
  40.             FirstOrDefault();
  42.         if (deletedInstructor == null)
  43.             Console.WriteLine("A person with PersonID {0} was deleted.",
  44.                 newInstructor.PersonID);
  45.     }
  • 编译并运行该应用程序。 该程序生成以下输出 *

备注

PersonID 是由服务器自动生成的，因此很可能会看到不同的数字 *

  1. Added Robyn Martin to the context.
  2. Before SaveChanges, the PersonID is: 0
  3. After SaveChanges, the PersonID is: 51
  4. A person with PersonID 51 was deleted.

如果使用的是 Visual Studio 的旗舰版，则可以将 Intellitrace 与调试器结合使用，以查看执行的 SQL 语句。

Intellitrace