EF Core连接SQL Server是.NET应用开发中常见的需求，通过简单的配置就能实现ORM框架与数据库的交互，无需手动编写大量SQL语句即可完成数据操作。
准备工作
在开始配置之前，需要确保已经创建了.NET项目，并且安装了对应的NuGet包。EF Core连接SQL Server需要依赖特定的数据库提供程序包，不同版本的EF Core对应的包版本需要匹配。
安装必要NuGet包
打开NuGet包管理器，搜索并安装以下两个包：
- Microsoft.EntityFrameworkCore.SqlServer：SQL Server数据库提供程序
- Microsoft.EntityFrameworkCore.Tools：用于执行数据库迁移等命令
如果是控制台应用，还可以安装Microsoft.EntityFrameworkCore.Design包，方便后续迁移操作。
配置连接字符串
连接字符串是EF Core连接SQL Server的核心配置，需要指定数据库服务器地址、数据库名称、身份验证方式等信息。通常我们会将连接字符串放在appsettings.json配置文件中。
appsettings.json配置示例
{
"ConnectionStrings": {
"SqlServerConnection": "Server=localhost;Database=TestDB;User Id=sa;Password=123456;TrustServerCertificate=True"
}
}
连接字符串中各个参数的含义如下：
- Server：SQL Server服务器地址，localhost表示本地服务器
- Database：要连接的数据库名称，如果数据库不存在，后续迁移时会自动创建
- User Id和Password：SQL Server的身份验证账号和密码，如果使用Windows身份验证可以替换为Integrated Security=True
- TrustServerCertificate：是否信任服务器证书，本地开发环境可以设置为True
定义DbContext上下文
DbContext是EF Core的核心类，负责管理实体对象与数据库之间的映射和交互。我们需要创建一个继承自DbContext的自定义上下文类，并在其中配置连接字符串和实体集合。
自定义DbContext代码示例
using Microsoft.EntityFrameworkCore;
using System.Collections.Generic;
// 定义示例实体类
public class User
{
public int Id { get; set; }
public string UserName { get; set; }
public string Email { get; set; }
}
// 自定义DbContext类
public class AppDbContext : DbContext
{
// 定义实体对应的DbSet属性
public DbSet<User> Users { get; set; }
// 配置连接字符串
protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
{
// 从配置文件读取连接字符串，实际项目中可以通过依赖注入传入
string connectionString = "Server=localhost;Database=TestDB;User Id=sa;Password=123456;TrustServerCertificate=True";
optionsBuilder.UseSqlServer(connectionString);
}
// 可选：配置实体与数据库表的映射关系
protected override void OnModelCreating(ModelBuilder modelBuilder)
{
// 配置User表的主键
modelBuilder.Entity<User>().HasKey(u => u.Id);
// 配置UserName字段的最大长度
modelBuilder.Entity<User>().Property(u => u.UserName).HasMaxLength(50);
}
}
上面的代码中，UseSqlServer方法是SQL Server提供程序扩展方法，用于指定使用SQL Server数据库。如果是通过依赖注入的方式使用DbContext，可以在Program.cs中配置，不需要重写OnConfiguring方法。
依赖注入方式配置（ASP.NET Core项目）
在ASP.NET Core项目中，更推荐使用依赖注入的方式注册DbContext，这样便于管理和测试。
Program.cs配置示例
using Microsoft.EntityFrameworkCore;
var builder = WebApplication.CreateBuilder(args);
// 注册DbContext，从配置文件读取连接字符串
builder.Services.AddDbContext<AppDbContext>(options =>
options.UseSqlServer(builder.Configuration.GetConnectionString("SqlServerConnection")));
var app = builder.Build();
app.MapGet("/", () => "Hello World!");
app.Run();
执行数据库迁移
配置完成后，需要将实体类同步到SQL Server数据库中，这一步通过EF Core的迁移命令完成。
迁移命令执行步骤
打开程序包管理器控制台，依次执行以下命令：
Add-Migration InitialCreate
Update-Database
Add-Migration命令会生成一个迁移文件，记录实体类到数据库表的变更；Update-Database命令会将迁移变更应用到SQL Server数据库，自动创建对应的表和字段。
验证连接是否成功
我们可以通过简单的代码测试EF Core是否能够正常连接SQL Server并操作数据。
测试代码示例
using (var context = new AppDbContext())
{
// 添加测试数据
var user = new User
{
UserName = "测试用户",
Email = "test@ipipp.com"
};
context.Users.Add(user);
// 保存到数据库
int result = context.SaveChanges();
if (result > 0)
{
Console.WriteLine("数据插入成功");
// 查询数据
var queryUser = context.Users.FirstOrDefault(u => u.UserName == "测试用户");
if (queryUser != null)
{
Console.WriteLine($"查询到用户：{queryUser.UserName}，邮箱：{queryUser.Email}");
}
}
else
{
Console.WriteLine("数据插入失败");
}
}
如果控制台输出插入成功和查询到的用户信息，说明EF Core已经成功连接SQL Server并可以正常操作数据。
常见问题排查
- 连接失败提示无法连接到服务器：检查SQL Server服务是否启动，连接字符串中的Server地址是否正确，防火墙是否允许SQL Server端口通过
- 迁移时提示数据库不存在：检查连接字符串中的Database名称是否正确，是否有创建数据库的权限
- 实体属性与数据库字段不匹配：检查OnModelCreating方法中的配置是否正确，或者实体类的属性定义是否符合预期
EF_CoreSQL_Server数据库连接Entity_Framework修改时间：2026-07-19 14:21:27