Entity Framework Core完全指南:从入门到精通的终极教程
Entity Framework Core(EF Core)是一个轻量级、跨平台的对象关系映射(ORM)框架,专为.NET开发者设计,简化了数据库访问和操作流程。本教程将带领你从基础入门到高级应用,掌握EF Core的核心功能与最佳实践,让数据库开发变得简单高效。
🚀 快速入门:搭建你的第一个EF Core项目
准备工作
开始使用EF Core前,确保你的开发环境满足以下要求:
- .NET 5.0或更高版本
- 兼容的IDE(如Visual Studio 2022或JetBrains Rider)
- 数据库系统(SQL Server、SQLite、PostgreSQL等)
创建新项目
首先创建一个新的.NET项目。在Visual Studio中,选择"Windows Forms App"模板,这是学习EF Core的理想起点:
图1:在Visual Studio中创建Windows Forms应用程序
安装EF Core
通过NuGet安装EF Core及其数据库提供程序。以SQLite为例,在"管理NuGet程序包"中搜索并安装Microsoft.EntityFrameworkCore.Sqlite:
图2:通过NuGet安装EF Core SQLite提供程序
核心概念:数据模型与DbContext
EF Core的核心是数据模型和DbContext。数据模型定义实体类,而DbContext管理实体与数据库的交互:
// 实体类
public class Blog
{
public int Id { get; set; }
public string Title { get; set; }
public string Content { get; set; }
public DateTime CreatedAt { get; set; } = DateTime.UtcNow;
}
// DbContext
public class AppDbContext : DbContext
{
public DbSet<Blog> Blogs { get; set; }
protected override void OnConfiguring(DbContextOptionsBuilder options)
=> options.UseSqlite("Data Source=blogging.db");
}
🔨 数据建模:定义实体关系
实体属性配置
EF Core支持多种配置方式来定义实体属性,包括数据注解和Fluent API:
数据注解方式
public class Product
{
[Key]
public int Id { get; set; }
[Required]
[MaxLength(100)]
public string Name { get; set; }
[Column(TypeName = "decimal(18,2)")]
public decimal Price { get; set; }
}
Fluent API方式
protected override void OnModelCreating(ModelBuilder modelBuilder)
{
modelBuilder.Entity<Product>(entity =>
{
entity.HasKey(p => p.Id);
entity.Property(p => p.Name)
.IsRequired()
.HasMaxLength(100);
entity.Property(p => p.Price)
.HasColumnType("decimal(18,2)");
});
}
关系配置
EF Core支持一对一、一对多和多对多关系。以下是一个典型的一对多关系配置:
public class Category
{
public int Id { get; set; }
public string Name { get; set; }
public ICollection<Product> Products { get; set; } = new List<Product>();
}
public class Product
{
public int Id { get; set; }
public string Name { get; set; }
public int CategoryId { get; set; }
public Category Category { get; set; }
}
🔍 查询数据:强大的LINQ支持
EF Core提供强大的LINQ查询能力,让你可以用C#代码编写数据库查询:
基本查询
using (var context = new AppDbContext())
{
// 获取所有产品
var allProducts = context.Products.ToList();
// 筛选产品
var cheapProducts = context.Products
.Where(p => p.Price < 50)
.OrderBy(p => p.Name)
.ToList();
}
关联数据加载
EF Core提供三种加载关联数据的方式:
- 贪婪加载:使用
Include方法
var productsWithCategories = context.Products
.Include(p => p.Category)
.ToList();
- 显式加载:先获取主实体,再加载关联数据
var product = context.Products.First();
context.Entry(product).Reference(p => p.Category).Load();
- 延迟加载:配置后自动加载关联数据(需安装
Microsoft.EntityFrameworkCore.Proxies)
💾 保存数据:添加、更新与删除
添加数据
using (var context = new AppDbContext())
{
var newProduct = new Product { Name = "EF Core Guide", Price = 29.99m };
context.Products.Add(newProduct);
context.SaveChanges();
}
更新数据
using (var context = new AppDbContext())
{
var product = context.Products.Find(1);
if (product != null)
{
product.Price = 39.99m;
context.SaveChanges();
}
}
删除数据
using (var context = new AppDbContext())
{
var product = context.Products.Find(1);
if (product != null)
{
context.Products.Remove(product);
context.SaveChanges();
}
}
🔄 数据库迁移:版本控制你的数据库
EF Core迁移功能让你可以像管理代码一样管理数据库模式变更:
创建迁移
dotnet ef migrations add InitialCreate
应用迁移
dotnet ef database update
回滚迁移
dotnet ef database update PreviousMigrationName
⚡ 性能优化:让你的EF Core应用飞起来
高效查询技巧
- 使用
AsNoTracking提高只读查询性能 - 投影查询只获取需要的字段
- 分页查询避免加载过多数据
// 高效分页查询
var products = context.Products
.OrderBy(p => p.Name)
.Skip(10)
.Take(20)
.AsNoTracking()
.ToList();
查看执行计划
分析SQL执行计划是优化查询的关键。EF Core允许你查看生成的SQL并分析其性能:
使用索引
为频繁查询的字段创建索引可以显著提高性能:
protected override void OnModelCreating(ModelBuilder modelBuilder)
{
modelBuilder.Entity<Product>()
.HasIndex(p => p.Name);
}
🆕 EF Core 9.0新特性
EF Core 9.0带来了许多令人兴奋的新功能:
主要新特性
- 增强的Cosmos DB支持:改进的分区键处理和LINQ查询能力
- 向量相似性搜索:支持向量数据类型和相似性查询
- 层次化分区键:更灵活的数据分布策略
- JSON列支持增强:更好地与JSON数据类型交互
📚 进阶学习资源
要深入学习EF Core,推荐以下资源:
- 官方文档:entity-framework/core/index.md
- 代码示例:samples/core/
- 性能调优指南:entity-framework/core/performance/index.md
- 迁移最佳实践:entity-framework/core/managing-schemas/migrations/index.md
🎯 总结
Entity Framework Core是.NET开发者的强大工具,它简化了数据库操作,提高了开发效率。通过本教程,你已经掌握了EF Core的核心概念和使用方法,从数据建模到查询优化,再到最新特性。现在,你可以开始在自己的项目中应用这些知识,构建高效、可靠的数据访问层。
记住,最好的学习方式是实践。克隆官方仓库开始你的EF Core之旅:
git clone https://gitcode.com/gh_mirrors/en/EntityFramework.Docs
祝你在EF Core的学习道路上取得成功!🚀
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考





