能否在.NET Framework ASP.NET Web API中使用Entity Framework Core？如何使用？

核心问题解答 #

首先可以明确：EF Core 3.1是最后一个支持经典.NET Framework的EF Core正式版本，只要你的Web API项目目标框架为.NET Framework 4.6.1及以上，就可以正常使用EF Core 3.1。高于3.1版本的EF Core仅支持.NET Core/.NET 5+，无法在经典.NET Framework项目中运行。

选型建议：EF6 vs EF Core 3.1 #

根据项目实际情况选择即可：

• 优先选EF6的场景：
  • 项目.NET Framework版本低于4.6.1，无法升级到满足EF Core 3.1要求的版本
  • 重度依赖EF6独有功能：比如EDMX设计器、实体数据模型向导、高级继承映射策略、现有业务已沉淀大量EF6复用组件
  • 项目后续无迁移到.NET Core/.NET 5+的计划，且对ORM性能没有极致要求
• 优先选EF Core 3.1的场景：
  • 项目.NET Framework版本≥4.6.1
  • 后续有计划将项目整体迁移到.NET Core/.NET 5+，EF Core的代码几乎可以无缝复用在新版本框架中
  • 不需要EF6的特有功能，更看重ORM的轻量性、查询性能、灵活的自定义配置能力

EF Core 3.1 接入经典.NET Framework Web API步骤 #

1. 环境适配
   首先确认项目目标框架为.NET Framework 4.6.1及以上，若版本过低先升级项目框架，在兼容现有业务的前提下尽量升级到.NET Framework 4.8以获得最佳兼容性。
2. 安装依赖NuGet包
   可通过NuGet包管理器或者包管理控制台安装对应版本的依赖，以SQL Server数据库为例：

Install-Package Microsoft.EntityFrameworkCore -Version 3.1.32
Install-Package Microsoft.EntityFrameworkCore.SqlServer -Version 3.1.32
# 若需要使用EF迁移功能则额外安装工具包
Install-Package Microsoft.EntityFrameworkCore.Tools -Version 3.1.32

3. 实现自定义DbContext
   创建继承自DbContext的上下文类，配置连接字符串和实体映射规则，示例如下：

using Microsoft.EntityFrameworkCore;
using System.Configuration;

public class AppDbContext : DbContext
{
    // 配置对应数据表的DbSet属性
    public DbSet<YourEntity> YourEntities { get; set; }

    protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
    {
        // 从web.config读取数据库连接字符串
        string connectionString = ConfigurationManager.ConnectionStrings["YourDbConn"].ConnectionString;
        optionsBuilder.UseSqlServer(connectionString);
    }

    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
        // 在此处配置实体与数据表的映射规则、主键、关联关系等
        modelBuilder.Entity<YourEntity>(entity =>
        {
            entity.HasKey(e => e.Id);
            entity.ToTable("YourTableName");
            // 其他字段配置
        });
    }
}

4. 配置依赖注入（可选）
   如果你的Web API项目使用了依赖注入框架，可将DbContext注册到容器中，以ASP.NET Web API自带的依赖注入为例，在WebApiConfig.cs中添加配置：

public static class WebApiConfig
{
    public static void Register(HttpConfiguration config)
    {
        // 原有路由等配置保留
        config.DependencyResolver.Register(typeof(AppDbContext), () => new AppDbContext());
    }
}

若未使用依赖注入，也可直接在业务代码中手动实例化AppDbContext使用，注意使用完成后及时释放资源即可。
5. 功能验证
编写简单的增删改查测试用例，确认数据读写正常，再逐步替换原有Telerik Openaccess ORM的业务逻辑即可。

注意事项 #

• EF Core 3.1的官方长期支持已经结束，微软不再提供安全更新补丁，如果项目对安全合规要求较高，建议优先选择仍在支持周期内的EF6，或者先将项目整体迁移到.NET 6+之后使用最新版EF Core。
• EF Core与EF6、Telerik Openaccess的API存在差异，迁移业务逻辑时需要注意查询写法、跟踪行为、关联加载逻辑的适配。
• 不建议在同一个项目中同时混用EF6和EF Core，会增加维护成本，也容易出现命名空间冲突。

内容的提问来源于stack exchange，提问作者Mateen Khan