表值函数（Tvf）Table-Valued Functions (TVFs)

备注

EF5 仅向前-实体框架5中引入了本页中所述的功能、api 等。 如果使用的是早期版本，则部分或全部信息不适用。

视频和分步演练演示了如何使用 Entity Framework Designer 映射表值函数（Tvf）。 它还演示了如何从 LINQ 查询调用 TVF。

Tvf 当前仅在 Database First 工作流中受支持。

实体框架版本5中引入了 TVF 支持。 请注意，若要使用表值函数、枚举和空间类型等新功能，则必须以 .NET Framework 4.5 为目标。 默认情况下，Visual Studio 2012 面向 .NET 4.5。

Tvf 非常类似于具有一个关键区别的存储过程： TVF 的结果是可组合的。 这意味着，可以在 LINQ 查询中使用 TVF 的结果，而存储过程的结果不能。

观看视频Watch the video

主讲人：Julia Kornich

WMV | MP4 | WMV (ZIP)

先决条件Pre-Requisites

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

设置项目Set up the Project

  1. 打开 Visual Studio
  2. 在 “文件“ 菜单上，指向 “新建“，然后单击 “项目“
  3. 在左窗格中，单击 “ Visual C# “，然后选择控制台模板
  4. 输入TVF作为项目名称，然后单击 “确定”

将 TVF 添加到数据库Add a TVF to the Database

  • 选择 “ > SQL Server 对象资源管理器
  • 如果 LocalDB 不在服务器列表中：右键单击SQL Server ，然后选择 “添加 SQL Server使用默认Windows 身份验证连接到 LocalDB 服务器
  • 展开 LocalDB 节点
  • 在 “数据库” 节点下，右键单击 “School” 数据库节点，然后选择 “ 新建查询 … “
  • 在 T-sql 编辑器中粘贴以下 TVF 定义
  1. CREATE FUNCTION [dbo].[GetStudentGradesForCourse]
  3. (@CourseID INT)
  5. RETURNS TABLE
  7. RETURN
  8.     SELECT [EnrollmentID],
  9.            [CourseID],
  10.            [StudentID],
  11.            [Grade]
  12.     FROM   [dbo].[StudentGrade]
  13.     WHERE  CourseID = @CourseID
  • 在 T-sql 编辑器上单击鼠标右键按钮，然后选择 “ 执行“
  • GetStudentGradesForCourse 函数将添加到 School 数据库

创建模型Create a Model

  1. 右键单击 “解决方案资源管理器中的项目名称，指向”添加“，然后单击”新建项“
  2. 从左侧菜单中选择 “数据“，然后在 “模板“ 窗格中选择 “ ADO.NET 实体数据模型
  3. 输入TVFModel作为文件名，然后单击 “添加“
  4. 在 “选择模型内容” 对话框中，选择 “ 从数据库生成“，然后单击 “ 下一步“
  5. 单击 “ 新建连接输入 （localdb）\Mssqllocaldb在” 服务器名称 “文本框中输入School 数据库名称单击 “ 确定 “
  6. 在 “选择数据库对象” 对话框中，在 “ 表 “ 节点下，选择 “ Person“、” StudentGrade“ 和 “ 课程“ 表
  7. 从 Visual Studio 2012 开始，选择 “ 存储过程” 和 “函数 “ 节点下的 GetStudentGradesForCourse函数，该函数从 Visual Studio 开始，Entity Designer 允许批处理导入存储过程和函数
  8. 单击 “ 完成“
  9. 此时会显示 Entity Designer，它提供了用于编辑模型的设计图面。 您在 “ 选择数据库对象 “ 对话框中选择的所有对象都将添加到模型中。
  10. 默认情况下，每个导入的存储过程或函数的结果形状将自动成为实体模型中的新复杂类型。 但我们想要将 GetStudentGradesForCourse 函数的结果映射到 StudentGrade 实体：右键单击设计图面，然后在 “模型浏览器” 中选择 “ 模型浏览器“，选择 “ 函数导入”，然后在 “编辑函数导入” 对话框中双击 “ GetStudentGradesForCourse “ 函数，选择 “ 实体“ 并选择 StudentGrade

保留和检索数据Persist and Retrieve Data

打开定义 Main 方法的文件。 将以下代码添加到 Main 函数中。

下面的代码演示如何生成使用表值函数的查询。 该查询将结果投影到一个匿名类型中，该类型包含相关课程标题和一个等级大于或等于3.5 的相关学生。

  1. using (var context = new SchoolEntities())
  2. {
  3.     var CourseID = 4022;
  4.     var Grade = 3.5M;
  6.     // Return all the best students in the Microeconomics class.
  7.     var students = from s in context.GetStudentGradesForCourse(CourseID)
  8.                             where s.Grade >= Grade
  9.                             select new
  10.                             {
  11.                                 s.Person,
  12.                                 s.Course.Title
  13.                             };
  15.     foreach (var result in students)
  16.     {
  17.         Console.WriteLine(
  18.             "Couse: {0}, Student: {1} {2}",
  19.             result.Title,  
  20.             result.Person.FirstName,  
  21.             result.Person.LastName);
  22.     }
  23. }

编译并运行该应用程序。 该程序生成以下输出：

  1. Couse: Microeconomics, Student: Arturo Anand
  2. Couse: Microeconomics, Student: Carson Bryant

SummarySummary

在本演练中，我们介绍了如何使用 Entity Framework Designer 映射表值函数（Tvf）。 它还演示了如何从 LINQ 查询调用 TVF。