无私分享：ASP.NET CORE 项目实战（第四章）Code First 创建数据库和数据表

<ItemGroup>
  <PackageReference Include="Microsoft.EntityFrameworkCore" Version="8.0.6" />
  <PackageReference Include="Microsoft.EntityFrameworkCore.SqlServer" Version="8.0.6" />
  <PackageReference Include="Microsoft.EntityFrameworkCore.Tools" Version="8.0.6" PrivateAssets="all" />
</ItemGroup>

using System.Collections.Generic;
using System.ComponentModel.DataAnnotations;
 
namespace MyProject.Models
{
    public class Blog
    {
        // 主键，EF Core 默认会将名为 Id 或 <类名>Id 的属性识别为主键
        public int BlogId { get; set; }
 
        // 使用 DataAnnotations 进行数据验证和映射配置
        [Required] // 非空约束
        [MaxLength(100)] // 最大长度
        public string Title { get; set; }
 
        [MaxLength(500)]
        public string Description { get; set; }
 
        // 导航属性：代表一个 Blog 拥有多个 Post
        // 这是建立一对多关系的核心
        public virtual ICollection<Post> Posts { get; set; }
 
        // 可选：添加一些审计字段
        public DateTime CreatedTime { get; set; } = DateTime.Now;
        public DateTime? UpdatedTime { get; set; } // 可空，因为创建时可能还未更新
    }
}

using System.ComponentModel.DataAnnotations;
using System.ComponentModel.DataAnnotations.Schema;
 
namespace MyProject.Models
{
    public class Post
    {
        public int PostId { get; set; }
 
        [Required]
        [MaxLength(200)]
        public string Title { get; set; }
 
        // 使用此注解可以将字段类型设置为 TEXT 或 NVARCHAR(MAX)
        // 具体类型取决于数据库提供程序
        [Column(TypeName = "ntext")]
        public string Content { get; set; }
 
        // 外键属性
        // 命名规则 <导航属性名>Id 或 <主表主键名>，EF Core 会自动识别
        public int BlogId { get; set; }
 
        // 导航属性：代表一篇文章属于一个博客
        // virtual 关键字支持延迟加载（需要安装 Microsoft.EntityFrameworkCore.Proxies 包）
        public virtual Blog Blog { get; set; }
 
        public DateTime CreatedTime { get; set; } = DateTime.Now;
    }
}

using Microsoft.EntityFrameworkCore;
using MyProject.Models;
 
namespace MyProject.Data
{
    public class ApplicationDbContext : DbContext
    {
        // 通过构造函数将配置选项（如连接字符串）传递给基类
        public ApplicationDbContext(DbContextOptions<ApplicationDbContext> options)
            : base(options)
        {
        }
 
        // 使用 DbSet<T> 属性来表示数据库中的表
        public DbSet<Blog> Blogs { get; set; }
        public DbSet<Post> Posts { get; set; }
 
        // 可选：重写此方法，可以进一步配置模型或种子数据
        protected override void OnModelCreating(ModelBuilder modelBuilder)
        {
            base.OnModelCreating(modelBuilder);
 
            // 示例：为 Blog 实体配置表名和索引
            modelBuilder.Entity<Blog>(entity =>
            {
                entity.ToTable("Blogs"); // 显式指定表名（可选）
                entity.HasIndex(e => e.Title).IsUnique(); // 为 Title 创建唯一索引
            });
 
            // 示例：配置一对多关系（通常 EF Core 可以根据导航属性自动配置，这是显式配置方式）
            modelBuilder.Entity<Post>()
                .HasOne(p => p.Blog)        // Post 有一个 Blog
                .WithMany(b => b.Posts)     // Blog 有很多 Posts
                .HasForeignKey(p => p.BlogId) // 使用 BlogId 作为外键
                .OnDelete(DeleteBehavior.Cascade); // 配置级联删除：当博客被删除时，其所有文章也被删除
        }
    }
}

{
  "ConnectionStrings": {
    "DefaultConnection": "Server=(localdb)\\mssqllocaldb;Database=MyProjectDb;Trusted_Connection=true;MultipleActiveResultSets=true;TrustServerCertificate=True;"
  },
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft.AspNetCore": "Warning"
    }
  },
  "AllowedHosts": "*"
}

using Microsoft.EntityFrameworkCore;
using MyProject.Data;
 
var builder = WebApplication.CreateBuilder(args);
 
// 从 appsettings.json 中读取连接字符串
var connectionString = builder.Configuration.GetConnectionString("DefaultConnection");
 
// 将 ApplicationDbContext 注册为服务，使用 SQL Server 提供程序
builder.Services.AddDbContext<ApplicationDbContext>(options =>
    options.UseSqlServer(connectionString));
 
// 添加其他服务（MVC 等）
builder.Services.AddControllersWithViews();
 
var app = builder.Build();
 
// ... 配置 HTTP 请求管道等

Add-Migration InitialCreate

Update-Database

// ... 上面的配置代码
 
var app = builder.Build();
 
// 创建作用域以获取 DbContext 实例
using (var scope = app.Services.CreateScope())
{
    var services = scope.ServiceProvider;
    try
    {
        var context = services.GetRequiredService<ApplicationDbContext>();
        // 这将应用所有挂起的迁移，如果数据库不存在则创建它。
        context.Database.Migrate();
        // 注意：Migrate() 在生产环境中是安全的，它只会应用新的迁移。
        // 对于初始化种子数据，可以在这里调用 SeedData.Initialize(context);
    }
    catch (Exception ex)
    {
        var logger = services.GetRequiredService<ILogger<Program>>();
        logger.LogError(ex, "An error occurred while migrating the database.");
    }
}
 
// ... 配置 HTTP 请求管道

Add-Migration AddAuthorToBlog
Update-Database

Update-Database PreviousMigrationName
# 例如： Update-Database InitialCreate

Remove-Migration

Script-Migration -From PreviousMigration -To NewMigration -Output migration.sql
# 例如，生成从空数据库到最新的脚本：
Script-Migration -From 0 -To LatestMigration -Output full_database_script.sql