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

Entity Framework Core (EFCore) 是一个高性能的对象关系映射器 (ORM)，它允许.NET开发人员以面向对象的方式与数据库进行交互。在ASP.NET Core应用程序中，EFCore因其简化了数据库访问层的开发且与.NET Core框架紧密结合而备受欢迎。本文将详细探讨ASP.NET Core中EFCore的属性配置与DbContext的使用。

一、EFCore 属性配置

1. 数据注解（Data Annotations）

数据注解是直接在实体类的属性上方使用特性（Attributes）来配置实体与数据库表之间的映射关系。这是配置属性的一种直观且简单的方法。

public class Blog
{
    [Key]
    public int BlogId { get; set; }

    [Required]
    [MaxLength(50)]
    public string Url { get; set; }
}

• [Key]: 指定属性作为主键。

• [Column(TypeName = "nvarchar(max)")]: 指定数据库列的类型和大小。

• [Required]: 指定属性在数据库中不允许为空。

• [MaxLength(50)]: 指定字符串属性的最大长度。

• [Index]: 为属性创建索引。

2. Fluent API

Fluent API提供了更灵活和强大的配置选项，它通常在DbContext的派生类中重写OnModelCreating方法时使用。

public class BloggingContext : DbContext
{
    public DbSet<Blog> Blogs { get; set; }

    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
        modelBuilder.Entity<Blog>()
            .HasKey(b => b.BlogId)
            .Property(b => b.Url)
            .IsRequired()
            .HasMaxLength(50);
    }
}

Fluent API允许对实体类进行更详细的配置，包括复杂的关系映射和条件配置。

二、DbContext

DbContext是EFCore的核心组件，它封装了对数据库的所有操作，包括CRUD操作、查询、事务等。

1. 定义DbContext

你需要定义一个继承自DbContext的类，并在这个类中定义DbSet<TEntity>属性，每个DbSet<TEntity>属性代表数据库中的一个表。

public class BloggingContext : DbContext
{
    public DbSet<Blog> Blogs { get; set; }
    // 可以添加更多的DbSet属性代表其他表
}

2. 数据库连接字符串

在appsettings.json中配置数据库连接字符串，然后在Startup.cs的ConfigureServices方法中配置EFCore使用这个连接字符串。

{
  "ConnectionStrings": {
    "BloggingDatabase": "Server=(localdb)\\mssqllocaldb;Database=Blogging;Trusted_Connection=True;"
  }
}

public void ConfigureServices(IServiceCollection services)
{
    services.AddDbContext<BloggingContext>(options =>
        options.UseSqlServer(Configuration.GetConnectionString("BloggingDatabase")));
    // 其他服务配置...
}

3. 上下文池与生存期

DbContext的生存期从创建实例时开始，并在释放实例时结束。在ASP.NET Core应用程序中，通常使用依赖关系注入为每个请求创建一个DbContext实例，并在请求结束后释放。

DbContext不是线程安全的，不要在线程之间共享上下文。确保在继续使用上下文实例之前，等待所有异步调用完成。

4. 使用DbContext

DbContext通过构造函数注入在ASP.NET Core控制器或其他服务中使用。

public class MyController : Controller
{
    private readonly BloggingContext _context;

    public MyController(BloggingContext context)
    {
        _context = context;
    }

    public IActionResult Index()
    {
        var blogs = _context.Blogs.ToList();
        return View(blogs);
    }
}

三、高级配置

1. 配置列名和数据类型

你可以使用Fluent API配置列名和数据类型。

modelBuilder.Entity<Blog>()
    .Property(b => b.Url)
    .HasColumnName("BlogUrl")
    .HasColumnType("nvarchar(255)");

2. 配置默认值

你可以为数据库列设置默认值。

modelBuilder.Entity<Student>()
    .Property(s => s.Age)
    .HasDefaultValue(18);

3. 复杂关系映射

Fluent API还允许你配置复杂的关系映射，如一对多、多对多等。

四、总结

Entity Framework Core提供了强大的属性配置和DbContext机制，使开发者能够轻松地在ASP.NET Core应用程序中管理数据库操作。通过数据注解和Fluent API，开发者可以灵活地定义实体类与数据库表之间的映射关系。DbContext封装了所有数据库操作，简化了数据访问层的开发。在实际开发中，结合使用这些功能，可以显著提高开发效率和代码质量。