C# Entity Framework Core怎么用 C# EF Core Code First入门教程

来源:这里教程网 时间:2026-02-21 17:30:00 作者:

Entity Framework Core(简称 EF Core)是微软推出的轻量级、跨平台版 ORM 框架,支持 Code First 开发模式。使用 Code First,你可以先定义 C# 类,然后由 EF Core 自动创建数据库结构。下面是一个简单明了的入门教程,带你快速上手 EF Core Code First。

1. 创建项目并安装 EF Core 包

打开 Visual Studio 或 .NET CLI,创建一个 .NET 6 或更高版本的控制台应用或 ASP.NET Core 项目。

通过 NuGet 安装 EF Core 的核心包和数据库提供程序,比如 SQL Server:

dotnet add package Microsoft.EntityFrameworkCore.SqlServer dotnet add package Microsoft.EntityFrameworkCore.Tools

如果你用的是其他数据库(如 SQLite、MySQL),替换为对应包即可。

2. 定义实体类(Model)

创建一个简单的类来表示数据库中的表。例如,我们创建一个 Product 类:

public class Product
{
    public int Id { get; set; }
    public string Name { get; set; }
    public decimal Price { get; set; }
}

EF Core 会根据命名约定将这个类映射到名为 Products 的表,并把 Id 当作主键。

3. 创建 DbContext 类

DbContext 是 EF Core 的核心类,用于管理数据库连接和数据操作。

新建一个类继承 DbContext

using Microsoft.EntityFrameworkCore;
<p>public class AppDbContext : DbContext
{
public DbSet<product> Products { get; set; }</product></p><pre class="brush:php;toolbar:false;">protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
{
    optionsBuilder.UseSqlServer("Server=(localdb)\mssqllocaldb;Database=ShopDb;Trusted_Connection=true;");
}

}

上面代码中:

DbSet 表示要操作的实体集合。 OnConfiguring 设置数据库连接字符串,这里使用 LocalDB 创建本地数据库。

4. 使用迁移(Migration)创建数据库

EF Core 使用迁移功能将模型变更同步到数据库。

在 Package Manager Console(或 .NET CLI)中运行以下命令:

Add-Migration InitialCreate

这条命令会生成一个迁移文件,包含创建 Products 表的代码。

接着运行:

Update-Database

EF Core 会自动创建数据库和表结构。

5. 增删改查操作示例

现在可以使用 AppDbContext 进行数据操作了:

using var context = new AppDbContext();
<p>// 添加数据
var product = new Product { Name = "笔记本电脑", Price = 5999.99M };
context.Products.Add(product);
context.SaveChanges();</p><p>// 查询数据
var allProducts = context.Products.ToList();
foreach (var p in allProducts)
{
Console.WriteLine($"{p.Id}: {p.Name} - {p.Price}");
}</p><p>// 修改数据
product.Price = 5499.99M;
context.SaveChanges();</p><p>// 删除数据
context.Products.Remove(product);
context.SaveChanges();
</p>

6. 小贴士与常见问题

确保连接字符串正确,可换成实际 SQL Server 地址。 每次修改模型后,都要执行 Add-MigrationUpdate-Database 更新数据库。 可在 OnModelCreating 中使用 Fluent API 配置更复杂的映射关系。 避免在 OnConfiguring 中硬编码连接字符串,推荐通过 appsettings.json 注入。

基本上就这些。EF Core Code First 让你专注业务模型设计,数据库自动跟上代码变化。不复杂但容易忽略细节,建议动手实践几次加深理解。

相关推荐