ASP.NET Core 项目中的数据访问实践指南

ASP.NET Core 项目中的数据访问实践指南

docs This repository contains .NET Documentation. 项目地址: https://gitcode.com/gh_mirrors/docs2/docs

前言

在现代Web应用开发中，数据访问层是连接业务逻辑与持久化存储的关键桥梁。ASP.NET Core 提供了灵活的数据访问方案选择，其中 Entity Framework Core (EF Core) 作为官方推荐的ORM框架，能够显著提升开发效率。本文将深入探讨如何在ASP.NET Core项目中优雅地实现数据访问。

一、EF Core 基础配置

1.1 安装与初始化

EF Core 作为轻量级ORM，需要通过NuGet包引入项目。对于SQL Server数据库，安装基础包：

dotnet add package Microsoft.EntityFrameworkCore.SqlServer

开发阶段可使用内存数据库进行测试：

dotnet add package Microsoft.EntityFrameworkCore.InMemory

1.2 DbContext 核心组件

DbContext是EF Core的核心类，代表与数据库的会话。典型实现如下：

public class CatalogContext : DbContext
{
    public CatalogContext(DbContextOptions<CatalogContext> options) 
        : base(options) { }

    public DbSet<CatalogItem> CatalogItems { get; set; }
    public DbSet<CatalogBrand> CatalogBrands { get; set; }
}

关键要点：

• 必须包含接收DbContextOptions的构造函数
• 每个DbSet属性对应数据库中的一张表

1.3 服务注册

在Program.cs中进行配置：

builder.Services.AddDbContext<CatalogContext>(options =>
    options.UseSqlServer(builder.Configuration.GetConnectionString("DefaultConnection")));

二、数据操作最佳实践

2.1 查询数据

使用LINQ进行数据查询时，注意立即执行与延迟执行的区分：

// 正确做法：立即执行
var brands = await _context.CatalogBrands
    .Where(b => b.Enabled)
    .OrderBy(b => b.Name)
    .ToListAsync();

// 风险做法：延迟执行
IQueryable<CatalogBrand> query = _context.CatalogBrands;
// 后续操作可能导致运行时错误

2.2 数据修改

EF Core通过变更跟踪实现数据持久化：

// 新增
var newItem = new CatalogItem { Name = "New Item" };
_context.Add(newItem);
await _context.SaveChangesAsync();

// 更新
var item = await _context.CatalogItems.FindAsync(1);
item.Name = "Updated Name";
await _context.SaveChangesAsync();

// 删除
var itemToDelete = await _context.FindAsync<CatalogItem>(2);
_context.Remove(itemToDelete);
await _context.SaveChangesAsync();

三、高级关系处理

3.1 加载关联数据

EF Core提供三种加载关联数据的方式：

1. 贪婪加载(Eager Loading) - 推荐用于Web应用

var products = await _context.Products
    .Include(p => p.Category)
    .ToListAsync();

2. 显式加载(Explicit Loading) - 需额外查询

var product = await _context.Products.FirstAsync();
await _context.Entry(product).Collection(p => p.Tags).LoadAsync();

3. 延迟加载(Lazy Loading) - Web应用不推荐

// 需安装Microsoft.EntityFrameworkCore.Proxies
// 并启用UseLazyLoadingProxies

3.2 避免性能陷阱

• N+1查询问题：贪婪加载不当导致的多次查询
• 笛卡尔积爆炸：关联过多表导致的性能问题
• 解决方案：使用AsSplitQuery()分割查询

四、领域模型设计技巧

4.1 封装集合属性

避免直接暴露可写集合：

public class Order
{
    private readonly List<OrderItem> _items = new();
    public IReadOnlyCollection<OrderItem> Items => _items.AsReadOnly();

    public void AddItem(Product product, int quantity)
    {
        // 业务逻辑校验
        _items.Add(new OrderItem(product, quantity));
    }
}

4.2 值对象支持

EF Core支持将值对象映射到所有者实体：

modelBuilder.Entity<Order>().OwnsOne(o => o.ShippingAddress);

五、连接稳定性保障

5.1 重试策略配置

针对云环境的间歇性故障：

services.AddDbContext<AppDbContext>(options =>
    options.UseSqlServer(connectionString, sqlOptions =>
    {
        sqlOptions.EnableRetryOnFailure(
            maxRetryCount: 5,
            maxRetryDelay: TimeSpan.FromSeconds(30));
    }));

5.2 事务处理

跨多个DbContext的事务需特殊处理：

var strategy = dbContext.Database.CreateExecutionStrategy();
await strategy.ExecuteAsync(async () =>
{
    using var transaction = await dbContext.Database.BeginTransactionAsync();
    try
    {
        // 跨上下文操作
        await transaction.CommitAsync();
    }
    catch
    {
        await transaction.RollbackAsync();
        throw;
    }
});

结语

在ASP.NET Core项目中，合理使用EF Core可以极大提升开发效率，但同时需要注意性能优化和正确的使用模式。通过封装数据访问细节、合理设计领域模型、实施适当的连接策略，可以构建出既高效又稳定的数据访问层。记住，Web应用的数据访问应当以最小化数据库往返次数为目标，谨慎处理关联数据的加载方式，这样才能确保应用的响应速度和扩展性。

docs This repository contains .NET Documentation. 项目地址: https://gitcode.com/gh_mirrors/docs2/docs