精進不休 .NET 4.0 (9)：ADO.NET Entity Framework 4.1 Code First 實戰

簡介

EF 4.1 引入 Code First 開發模式：先定義 POCO 實體類別，再由框架依慣例或配置映射至資料庫，支援資料庫初始化策略（如模型變更時重建）。

完整範例程式碼

Web.config 連線字串

<connectionStrings>
  <add name="MyConnection"
       providerName="System.Data.SqlClient"
       connectionString="server=.;database=MyDB;uid=sa;pwd=111111;Persist Security Info=True" />
</connectionStrings>

Persist Security Info=True 確保初始化時能連接 master 資料庫判斷結構差異。

Global.asax.cs 設定初始化策略

Database.SetInitializer<MyContext>(new DropCreateDatabaseIfModelChanges<MyContext>());
// 或 Database.SetInitializer<MyContext>(null); // 手動管理

實體類別

Category.cs

public class Category
{
    public string CategoryId { get; set; }
    public string Name { get; set; }
    public string Comment { get; set; }
    public virtual ICollection<Product> Products { get; set; }
}

Product.cs（Data Annotations 配置）

[Table("CategoryProduct")]
public class Product
{
    [Key]
    [DatabaseGenerated(DatabaseGeneratedOption.Identity)]
    public int ProductId { get; set; }

    [Required]
    [MaxLength(128)]
    [Column("ProductName")]
    public string Name { get; set; }

    [NotMapped]
    public string Comment { get; set; }

    public DateTime CreateTime { get; set; }
    public Price Price { get; set; }

    [ConcurrencyCheck]
    [Timestamp]
    public byte[] TimeStamp { get; set; }

    public string CategoryId { get; set; }
    [ForeignKey("CategoryId")]
    [InverseProperty("Products")]
    public virtual Category Category { get; set; }
}

Price.cs（Complex Type）

[ComplexType]
public class Price
{
    public Price() { Dollar = null; RMB = null; }
    public decimal? Dollar { get; set; }
    public decimal? RMB { get; set; }
}

MyContext.cs（Fluent API 配置）

public class MyContext : DbContext
{
    public MyContext(string connString) : base(connString)
    {
        Configuration.LazyLoadingEnabled = true;
        Configuration.AutoDetectChangesEnabled = true;
    }

    public DbSet<Category> Categories { get; set; }
    public DbSet<Product> Products { get; set; }

    protected override void OnModelCreating(DbModelBuilder modelBuilder)
    {
        modelBuilder.Entity<Category>()
            .Property(c => c.Name)
            .IsUnicode(false)   // varchar
            .IsRequired()
            .HasMaxLength(64);
    }
}

Demo.aspx.cs：CRUD 操作示範

using (var db = new MyContext("MyConnection"))
{
    var category = new Category { CategoryId = Guid.NewGuid().ToString(), Name = "software " + rnd.Next() };
    db.Categories.Add(category);

    var product = new Product { Name = "windows " + rnd.Next(), Category = category, CreateTime = DateTime.Now, Price = new Price() };
    var product2 = new Product { Name = "windows " + rnd.Next(), Category = category, CreateTime = DateTime.Now, Price = new Price() };
    db.Products.Add(product);
    db.Products.Add(product2);

    int rows = db.SaveChanges();
    Response.Write("影響行數：" + rows);
}

關鍵 API 速查

• db.Categories.Find(id)：主鍵查詢。
• db.Entry(entity).State = EntityState.Modified：標記修改。
• db.Categories.AsNoTracking()：唯讀查詢，提升效能。
• db.Entry(p).Property(x => x.Name).CurrentValue：取得屬性當前值。
• db.Categories.Include(c => c.Products)：Eager Loading。
• db.Database.SqlQuery<T>(...) / ExecuteSqlCommand：原生 SQL。

總結

Code First 讓開發者專注於領域模型，透過 Data Annotations 或 Fluent API 精確控制映射，配合資料庫初始化策略，極大提升開發效率與可維護性。