迁移注意事项（实体框架）

现有的应用程序可以从多方面受益于 ADO.NET 实体框架。 其中最重要的益处之一在于能够使用概念模型将应用程序使用的数据结构与数据源中的架构分离。 这样，日后便可轻松地对存储模型或数据源本身进行更改，而无需对应用程序进行补偿更改。 有关使用实体框架 的益处的更多信息，请参见实体框架概述和Entity Data Model。

为了利用实体框架 的益处，您可以将现有应用程序迁移到实体框架 。 某些任务对于所有迁移的应用程序是通用的。 这些通用任务包括升级应用程序以使用 .NET Framework 版本 3.5 Service Pack 1 (SP1) 或更高版本、定义模型和映射以及配置实体框架。 在将应用程序迁移至实体框架 时，还需要考虑其他一些注意事项。 相关注意事项取决于要迁移的应用程序的类型及具体功能。 本主题提供的信息可帮助您为现有应用程序选择最佳的升级途径。

有关迁移的一般注意事项

在将任何应用程序迁移到实体框架 时，需要考虑以下注意事项：

• 使用 .NET Framework 版本 3.5 SP1 或更高版本的任何应用程序都可以迁移至实体框架，只要该应用程序使用的数据源的数据提供程序支持实体框架即可。

• 即使某个数据源提供程序支持实体框架，实体框架也可能不支持该提供程序的所有功能。

• 对于大型或复杂的应用程序，不需要一次性地将整个应用程序迁移到实体框架。 但是，在数据源发生更改时，仍然需要更改应用程序中不使用实体框架的任何部分。

• 应用程序的其他部分可以共享实体框架所用的数据提供程序连接，因为实体框架 使用 ADO.NET 数据提供程序访问数据源。 例如，实体框架使用 SqlClient 提供程序访问 SQL Server 数据库。 有关更多信息，请参见用于实体框架的 EntityClient 提供程序。

通用迁移任务

将现有应用程序迁移到实体框架 的途径取决于应用程序的类型以及现有的数据访问策略。 但是，在将现有应用程序迁移到实体框架 时，总是要执行以下任务。

注意：
当您使用实体数据模型工具（从 开始）时，将自动执行所有这些任务。有关更多信息，请参见如何：使用实体数据模型向导（实体框架）。

1. 升级应用程序。

   使用早期版本 Visual Studio 和 .NET Framework 创建的项目必须升级为使用 SP1 和 .NET Framework 版本 3.5 SP1 或更高版本。

2. 定义模型和映射。

   模型和映射文件定义概念模型中的实体、数据源中的结构（如表、存储过程和视图）以及实体与数据源结构之间的映射。 有关更多信息，请参见如何：手动定义模型和映射文件（实体框架）。

   在存储模型中定义的类型必须与数据源中对象的名称相匹配。 如果现有应用程序将数据作为对象公开，则必须确保在概念模型中定义的实体和属性与这些现有数据类和属性的名称相匹配。 有关更多信息，请参见如何：自定义建模和映射文件以使用自定义对象（实体框架）。

   注意：
   可以使用实体数据模型设计器重命名概念模型中的实体以匹配现有对象。有关更多信息，请参见 ADO.NET Entity Data Model Designer。

3. 定义连接字符串。

   实体框架 在对概念模型执行查询时使用特殊格式的连接字符串。 此连接字符串包装有关模型和映射文件和到数据源的连接的信息。 有关更多信息，请参见如何：定义连接字符串（实体框架）。

4. 配置 Visual Studio 项目。

   必须将对实体框架 程序集以及模型和映射文件的引用添加到 Visual Studio 项目。 可以将这些映射文件添加到项目中，以确保这些文件随应用程序一起部署在连接字符串中所指示的位置。 有关更多信息，请参见如何：手动配置实体框架项目。

有关包含现有对象的应用程序的注意事项

从 .NET Framework 4 开始，实体框架 就支持“纯旧式”CLR 对象 (POCO)，也称为持久性未知对象。 大多数情况下，通过进行少量修改，现有对象可以使用实体框架 。 有关更多信息，请参见使用 POCO 实体（实体框架）。 还可以将应用程序迁移到实体框架 并使用实体框架工具生成的数据类。 有关更多信息，请参见如何：使用实体数据模型向导（实体框架）。

有关使用 ADO.NET 提供程序的应用程序的注意事项

使用 ADO.NET 提供程序（如 SqlClient）可以查询数据源以返回表格格式数据。 还可以将数据加载到 ADO.NET 数据集中。 下表介绍在升级使用现有 ADO.NET 提供程序的应用程序时的注意事项：

• 使用数据读取器显示表格格式数据。
  可以考虑使用 EntityClient 提供程序执行 Entity SQL 查询，并对返回的 EntityDataReader 对象进行枚举。 仅当应用程序使用数据读取器显示表格格式数据，且不需要由实体框架 提供用于将数据具体化为对象、跟踪更改和进行更新的功能时，才应这样做。 可以继续使用对数据源进行更新的现有数据访问代码，但可以使用从 EntityConnection 的 StoreConnection 属性访问的现有连接。 有关更多信息，请参见 用于实体框架的 EntityClient 提供程序。

• 使用数据集。
  实体框架 提供的许多功能与数据集提供的功能相同，例如内存中持久性、更改跟踪、数据绑定以及将对象序列化为 XML 数据。 有关更多信息，请参见使用对象（实体框架）。

  如果实体框架 未提供应用程序所需的数据集功能，仍然可以通过使用 LINQ to DataSet 来利用 LINQ 查询的优点。 有关更多信息，请参见 LINQ to DataSet。

有关将数据绑定到控件的应用程序的注意事项

.NET Framework 使您可以包装数据源（如数据集或 ASP.NET 数据源控件）中的数据，然后将用户界面元素绑定到这些数据控件。 下表介绍将控件绑定到实体框架数据时的注意事项。

• 将数据绑定到控件。
  在查询概念模型时，实体框架 以作为实体类型实例的对象的形式返回数据。 这些对象可以直接绑定到控件，此绑定支持更新。 这意味着对控件中的数据（如 DataGridView 中的行）所做的更改会在调用 SaveChanges 方法时自动保存到数据库。

  如果应用程序对查询结果进行枚举，以在 DataGridView 或支持数据绑定的其他类型的控件中显示数据，则可以修改应用程序以将该控件绑定到 ObjectQuery 的结果。

  有关更多信息，请参见将对象绑定到控件（实体框架）。

• ASP.NET 数据源控件。
  实体框架 包含一个数据源控件，该控件旨在简化 ASP.NET Web 应用程序中的数据绑定。 有关更多信息，请参见实体框架数据源控件。

其他注意事项

以下是在将特定类型的应用程序迁移到实体框架时可能需要考虑的一些注意事项。

• 公开数据服务的应用程序。
  基于 Windows Communication Foundation (WCF) 的 Web 服务和应用程序使用 XML 请求/响应消息格式公开基础数据源中的数据。 实体框架 使用二进制、XML 或 WCF 数据约定序列化支持实体对象的序列化。 二进制和 WCF 序列化都支持对象图的整体序列化。 有关更多信息，请参见 生成 N 层应用程序（实体框架）。

• 使用 XML 数据的应用程序。
  通过对象序列化可以创建实体框架 数据服务。 这些服务为使用 XML 数据的应用程序（如基于 AJAX 的 Internet 应用程序）提供数据。 在这类情况下，请考虑使用 ADO.NET 数据服务。 这些数据服务基于实体数据模型，并使用标准具象状态传输 (REST) HTTP 操作（如 GET、PUT 和 POST）提供对实体数据的动态访问。 有关更多信息，请参见 ADO.NET Data Services。

  实体框架 不支持本机 XML 数据类型。 这意味着在将实体映射到包含 XML 列的表时，该 XML 列的等效实体属性是一个字符串。 对象可以断开连接，并序列化为 XML。 有关更多信息，请参见序列化对象（实体框架）。

  如果应用程序需要查询 XML 数据，则仍然可以通过使用 LINQ to XML 来利用 LINQ 查询的优点。 有关更多信息，请参见 LINQ to XML。

• 维护状态的应用程序。
  ASP.NET Web 应用程序需要经常维护网页或用户会话的状态。 可以在客户端视图状态或服务器上的会话状态中存储 ObjectContext 实例中的对象，并在以后检索这些对象并将其重新附加到新的对象上下文。 有关更多信息，请参见附加和分离对象（实体框架）。

另请参见

概念

部署注意事项（实体框架）
实体框架术语