ASP.NET Core EFCore 属性配置与DbContext 详解

红色猎鹰 發表於 2025-5-17 08:21:00

ASP.NET Core EFCore 属性配置与DbContext 详解

本文将深入探讨 ASP.NET Core 中 EFCore 的实体属性配置方法及 <code>DbContext</code> 的核心用法，帮助开发者高效管理数据模型与数据库交互。
<hr>
<h4>一、属性配置</h4>
实体属性配置是定义模型与数据库映射的核心，EFCore 提供两种方式：数据注解和 Fluent API。
<h5>1. 数据注解（Data Annotations）</h5>
通过特性（Attributes）直接在实体类上声明配置，适合简单场景。
<div class="cnblogs_code">
<pre>public class Product{ // 主键 public int Id { get; set; }
// 非空且最大长度100 public string Name { get; set; }
// 外键 public int CategoryId { get; set; } public Category Category { get; set; }}</pre>
</div>
常用注解：
<ul class="list-paddingleft-1">
<li>
<code></code>：主键
</li>
<li>
<code></code>：非空约束
</li>
<li>
<code></code>：最大长度
</li>
<li>
<code></code>：外键关系
</li>
<li>
<code></code>：自定义表名
</li>
</ul>
<h5>2. Fluent API</h5>
在 <code>DbContext</code> 的 <code>OnModelCreating</code> 方法中配置，提供更灵活的方式。
<div class="cnblogs_code">
<pre>protected override void OnModelCreating(ModelBuilder modelBuilder){ modelBuilder.Entity<Product>(entity => { entity.HasKey(p => p.Id); // 主键 entity.Property(p => p.Name) .IsRequired() .HasMaxLength(100);
 entity.HasOne(p => p.Category) // 一对一/多关系 .WithMany(c => c.Products) .HasForeignKey(p => p.CategoryId); });}</pre>
</div>
常用配置方法：
<ul class="list-paddingleft-1">
<li>
<code>HasKey()</code>：定义主键
</li>
<li>
<code>Property().IsRequired()</code>：非空约束
</li>
<li>
<code>HasIndex()</code>：创建索引
</li>
<li>
<code>HasOne().WithMany()</code>：配置导航关系
</li>
</ul>
优势：
<ul class="list-paddingleft-1">
<li>
集中管理配置，避免污染实体类。
</li>
<li>
支持复杂配置（如复合主键、继承映射）。
</li>
</ul>
<hr>
<h4>二、DbContext 详解</h4>
<code>DbContext</code> 是 EFCore 的核心，负责数据库连接、查询、事务管理等。
<h5>1. 定义 DbContext</h5>
派生类需继承 <code>DbContext</code>，并暴露 <code>DbSet<T></code> 属性。
<div class="cnblogs_code">
<pre>public class AppDbContext : DbContext{ public DbSet<Product> Products { get; set; } public DbSet<Category> Categories { get; set; }
protected override void OnConfiguring(DbContextOptionsBuilder options) => options.UseSqlServer("Your_Connection_String");
protected override void OnModelCreating(ModelBuilder modelBuilder) 　　{ 　　// Fluent API 配置 　　} }</pre>
</div>
<h5>2. 生命周期与依赖注入</h5>
在 ASP.NET Core 中，通过依赖注入管理上下文生命周期：
<div class="cnblogs_code">
<pre>// Startup.cs services.AddDbContext<AppDbContext>(options => options.UseSqlServer(Configuration.GetConnectionString("Default")));</pre>
</div>
<ul class="list-paddingleft-1">
<li>
作用域（Scoped）：默认选项，每个请求一个实例，确保线程安全。
</li>
<li>
避免长时间持有 <code>DbContext</code>，以防内存泄漏。
</li>
</ul>
<h5>3. 数据操作</h5>
<ul class="list-paddingleft-1">
<li>
查询：
</li>
</ul>
<div class="cnblogs_code">
<pre>var products = await _context.Products.Where(p => p.Price > 50).ToListAsync();</pre>
</div>
<ul class="list-paddingleft-1">
<li>
保存变更：
</li>
</ul>
<div class="cnblogs_code">
<pre>_context.Products.Add(newProduct); await _context.SaveChangesAsync();</pre>
</div>
关键方法：
<ul class="list-paddingleft-1">
<li>
<code>Add()</code>, <code>Remove()</code>：跟踪实体状态
</li>
<li>
<code>SaveChangesAsync()</code>：提交事务
</li>
</ul>
<h5>4. 性能优化</h5>
<ul class="list-paddingleft-1">
<li>
AsNoTracking()：禁用变更跟踪，提升查询速度。
</li>
<li>
DbContext 池：复用上下文实例，减少开销。
</li>
</ul>
<div class="cnblogs_code">
<pre>services.AddDbContextPool<AppDbContext>(...);</pre>
</div>
<hr>
<h4>三、高级配置</h4>
<h5>1. 多对多关系</h5>
使用 Fluent API 配置中间表：
<div class="cnblogs_code">
<pre>modelBuilder.Entity<Post>() .HasMany(p => p.Tags) .WithMany(t => t.Posts) .UsingEntity(j => j.ToTable("PostTags"));</pre>
</div>
<h5>2. 继承映射</h5>
TPH（Table-Per-Hierarchy）模式：
<div class="cnblogs_code">
<pre>modelBuilder.Entity<Blog>() .HasDiscriminator<string>("BlogType") .HasValue<Blog>("Standard") .HasValue<RssBlog>("RSS");</pre>
</div>
<h5>3. 全局过滤器</h5>
自动应用查询条件（如软删除）：
<div class="cnblogs_code">
<pre>modelBuilder.Entity<Post>().HasQueryFilter(p => !p.IsDeleted);</pre>
</div>
<hr>
<h4>四、最佳实践与常见问题</h4>
<ol class="list-paddingleft-1">
<li>
选择数据注解还是 Fluent API？
</li>
<ul class="list-paddingleft-1">
<li>
简单配置用数据注解，复杂需求用 Fluent API。
</li>
</ul>
<li>
DbContext 线程安全
</li>
<ul class="list-paddingleft-1">
<li>
确保每个请求使用独立实例，避免并发问题。
</li>
</ul>
<li>
迁移（Migrations）
</li>
<ul class="list-paddingleft-1">
<li>
通过 <code>dotnet ef migrations add</code> 生成数据库架构变更。
</li>
</ul>
<li>
性能陷阱
</li>
<ul class="list-paddingleft-1">
<li>
避免在循环中频繁调用 <code>SaveChanges()</code>。
</li>
<li>
使用 <code>Include()</code> 预加载关联数据，减少 N+1 查询。
</li>
</ul>
</ol><hr>
<h4>结语</h4>
掌握 EFCore 的属性配置与 <code>DbContext</code> 管理，能够显著提升数据层开发效率。合理选择配置方式，结合依赖注入和性能优化技巧，可构建高效稳健的 ASP.NET Core 应用。 
来源：https://www.cnblogs.com/shenchuanchao/p/18879792

頁: [1]

琼殿技术论坛's Archiver

ASP.NET Core EFCore 属性配置与DbContext 详解