空间 Code FirstSpatial - Code First

备注

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

视频和分步演练演示了如何使用实体框架 Code First 映射空间类型。 它还演示了如何使用 LINQ 查询查找两个位置之间的距离。

本演练将使用 Code First 创建新数据库，但也可以使用Code First 到现有数据库。

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

若要使用空间数据类型，还必须使用具有空间支持的实体框架提供程序。 有关详细信息，请参阅提供程序对空间类型的支持。

主要的空间数据类型有两种：地理和几何。 Geography 数据类型存储椭圆体的数据（例如 GPS 纬度和经度坐标）。 Geometry 数据类型表示欧氏（平面）坐标系。

观看视频Watch the video

此视频演示如何实体框架 Code First 映射空间类型。 它还演示了如何使用 LINQ 查询查找两个位置之间的距离。

主讲人：Julia Kornich

视频：WMV | MP4 | WMV (ZIP)

先决条件Pre-Requisites

你将需要安装 Visual Studio 2012、旗舰版、高级版、专业版或 Web Express edition 才能完成此演练。

设置项目Set up the Project

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

使用 Code First 定义新模型Define a New Model using Code First

使用 Code First 开发时，通常首先编写定义概念（域）模型 .NET Framework 类。 下面的代码定义了大学类。

该大学具有 DbGeography 类型的 Location 属性。 若要使用 DbGeography 类型，必须添加对 System.web 程序集的引用，并使用语句添加 node.js。

打开 Program.cs 文件，并将以下 using 语句粘贴到文件顶部：

  1. using System.Data.Spatial;

将以下大学类定义添加到 Program.cs 文件。

  1. public class University  
  2. {
  3.     public int UniversityID { get; set; }
  4.     public string Name { get; set; }
  5.     public DbGeography Location { get; set; }
  6. }

定义 DbContext 派生类型Define the DbContext Derived Type

除了定义实体外，还需要定义派生自 DbContext 的类，并公开 DbSet 属性。 DbSet 属性使上下文知道要包括在模型中的类型。

DbContext 派生类型的实例在运行时管理实体对象，这包括使用数据库中的数据填充对象、更改跟踪以及将数据保存到数据库。

DbContext 和 DbSet 类型是在 EntityFramework 程序集中定义的。 我们将使用 EntityFramework NuGet 包添加对此 DLL 的引用。

  1. 在解决方案资源管理器中，右键单击项目名称。
  2. 选择 “管理 NuGet 包 … “
  3. 在 “管理 NuGet 包” 对话框中，选择 “联机“ 选项卡，然后选择 “ EntityFramework “ 包。
  4. 单击“安装”

请注意，除 EntityFramework 程序集之外，还添加了对 System.componentmodel. DataAnnotations 程序集的引用。

在 Program.cs 文件的顶部，添加以下 using 语句：

  1. using System.Data.Entity;

在 Program.cs 中，添加上下文定义。 

  1. public partial class UniversityContext : DbContext
  2. {
  3.     public DbSet<University> Universities { get; set; }
  4. }

保留和检索数据Persist and Retrieve Data

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

该代码将两个新的大学对象添加到上下文中。 空间属性使用 DbGeography. FromText 方法进行初始化。 将 WellKnownText 表示的地理点传递给方法。 然后，该代码将保存数据。 然后，将构造并执行 LINQ 查询，该查询返回其位置与指定位置最接近的大学对象。

  1. using (var context = new UniversityContext ())
  2. {
  3.     context.Universities.Add(new University()
  4.         {
  5.             Name = "Graphic Design Institute",
  6.             Location = DbGeography.FromText("POINT(-122.336106 47.605049)"),
  7.         });
  9.     context. Universities.Add(new University()
  10.         {
  11.             Name = "School of Fine Art",
  12.             Location = DbGeography.FromText("POINT(-122.335197 47.646711)"),
  13.         });
  15.     context.SaveChanges();
  17.     var myLocation = DbGeography.FromText("POINT(-122.296623 47.640405)");
  19.     var university = (from u in context.Universities
  20.                         orderby u.Location.Distance(myLocation)
  21.                         select u).FirstOrDefault();
  23.     Console.WriteLine(
  24.         "The closest University to you is: {0}.",
  25.         university.Name);
  26. }

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

  1. The closest University to you is: School of Fine Art.

查看生成的数据库View the Generated Database

首次运行应用程序时，实体框架会为您创建一个数据库。 由于我们安装了 Visual Studio 2012，因此将在 LocalDB 实例上创建数据库。 默认情况下，实体框架在派生上下文的完全限定名称（在此示例中为SpatialCodeFirst. UniversityContext）之后对数据库进行命名。 随后将使用现有数据库的时间。

请注意，如果在创建数据库后对模型进行了任何更改，则应使用 Code First 迁移来更新数据库架构。 有关使用迁移的示例，请参阅Code First 到新的数据库。

若要查看数据库和数据，请执行以下操作：

  1. 在 Visual Studio 2012 主菜单中，选择 “查看 -> SQL Server 对象资源管理器“。
  2. 如果 LocalDB 不在服务器列表中，请在SQL Server上单击鼠标右键按钮，然后选择 “添加 SQL Server使用默认Windows 身份验证连接到 LocalDB 实例
  3. 展开 LocalDB 节点
  4. 展开 “数据库“ 文件夹，以查看新数据库并浏览到大学表
  5. 若要查看数据，请右键单击该表，然后选择 “查看数据“

SummarySummary

在本演练中，我们介绍了如何在实体框架 Code First 中使用空间类型。