以下是书《Programming Entity Framework Code First》的学习整理,主要是一个整体梳理。
一、模型属性映射约定
1.通过 System.Component Model.DataAnnotations 来配置
class AnimalType { public int Id { get; set; } [Required] public string TypeName { get; set; } }
意味着TypeName在数据库中的字段为not null。第二个是EntityFramework会对这个模型进行验证。比如在Savechanges的时候,模型的这个属性不能为空,否则会抛出异常。
[Table("Species")] class AnimalType { public int Id { get; set; } [Required] public string TypeName { get; set; } }
像Table这个特性 意味着AnimalType对象在数据库映射到表Species上。
2.通过Fluent API来配置模型。
通过Dbcontext的OnModelCreating来对模型进行配置。
protected override void OnModelCreating(DbModelBuilder modelBuilder) { modelBuilder.Entity<AnimalType>().ToTable("Animal"); modelBuilder.Entity<AnimalType>().Property(p => p.TypeName).IsRequired(); }
这样得到同样的效果。开发者一般倾向于使用API的方式来约定模型,这样保持class干净,而且API支持映射更多。API在特性后面执行,同样的代码(比如API是.HasMaxLength(300),特性是 [MaxLength(200)],数据库会是300的长度),API会覆盖特性。
如果你有很多属性需要约定,可以单独出来。继承EntityTypeConfiguration。
public class DestinationConfiguration : EntityTypeConfiguration<Destination> { public DestinationConfiguration() { Property(d => d.Name).IsRequired(); Property(d => d.Description).HasMaxLength(500); Property(d => d.Photo).HasColumnType("image"); } } public class LodgingConfiguration : EntityTypeConfiguration<Lodging> { public LodgingConfiguration() { Property(l => l.Name).IsRequired().HasMaxLength(200); } }
然后再OnModelCreating中加进去,这个和modelBuilder.Entity<AnimalType>() 是同样的效果,modelBuilder.Entity<AnimalType>()会创建一个EntityTypeConfiguration。所以本质上他们是一样的代码。
protected override void OnModelCreating(DbModelBuilder modelBuilder) { modelBuilder.Configurations.Add(new DestinationConfiguration()); modelBuilder.Configurations.Add(new LodgingConfiguration()); }
最好先支持数据迁移,不然模型改变会触发异常。
public class VetContext:DbContext { public DbSet<Patient> Patients { get; set; } public DbSet<Visit> Visits { get; set; } public VetContext() : base("DefaultConnection") { Database.SetInitializer(new MigrateDatabaseToLatestVersion<VetContext, Configuration<VetContext>>()); } protected override void OnModelCreating(DbModelBuilder modelBuilder) { modelBuilder.Entity<AnimalType>().ToTable("Animal"); modelBuilder.Entity<AnimalType>().Property(p => p.TypeName).IsRequired(); } } internal sealed class Configuration<TContext> : DbMigrationsConfiguration<TContext> where TContext : DbContext { public Configuration() { AutomaticMigrationsEnabled = true; AutomaticMigrationDataLossAllowed = true; } }
什么是Fluent API?
这个概念不是EF或者Code First专有的,指的就是使用链式方法的API,每个调用的返回类型都为下一个调用定义了有效方法。
二、模型关系映射约定---在Console 中使用EF
Dbcontext的初始化功能是很强大的。我们新建一个Console工程,加入下面的模型和BreakAwayContext.cs Destination和Lodging是一对多的关系。
namespace Model { public class Destination { public int DestinationId { get; set; } public string Name { get; set; } public string Country { get; set; } public string Description { get; set; } public byte[] Photo { get; set; } public List<Lodging> Lodgings { get; set; } } } namespace Model { public class Lodging { public int LodgingId { get; set; } public string Name { get; set; } public string Owner { get; set; } public bool IsResort { get; set; } public Destination Destination { get; set; } } } namespace DataAccess { public class BreakAwayContext : DbContext { public DbSet<Destination> Destinations { get; set; } public DbSet<Lodging> Lodgings { get; set; } } }
运行主程序:
private static void InsertDestination() { var destination = new Destination { Country = "Indonesia", Description = "EcoTourism at its best in exquisite Bali", Name = "Bali" }; using (var context = new BreakAwayContext()) { context.Destinations.Add(destination); context.SaveChanges(); } } static void Main() { InsertDestination(); }
我们在SQL Server资源管理器中可以找到这个数据库(书中说,他会自动早本机SQL Server Express中创建数据库,但是我安装的是Sql Server 2008 R2,在2008中没有找到新生成的数据库)。
而这个数据库的位置是在用户文件夹下面。右键点击ConsoleEf.BreakAwayContext 选择属性。
EF会自动的在数据表中创建主外键,并根据模型的属性的不同类型创建了不同的字段。我们再可以加一些属性约定,来限制数据库中字段的大小(注意图中的nvarchar(max)...)。修改一下Destination。
public class Destination { public int DestinationId { get; set; } [Required] public string Name { get; set; } public string Country { get; set; } [MaxLength(500)] public string Description { get; set; } [Column(TypeName="image")] public byte[] Photo { get; set; } public List<Lodging> Lodgings { get; set; } }
模型改变在默认状态下回触发异常,Codefirst 有几种初始化的方法。CreateDatabaseIfNotExists ,DropCreateDatabaseIfModelchanges。我们选用模型改变时删除再重建数据库。
static void Main(string[] args) { Database.SetInitializer( new DropCreateDatabaseIfModelChanges<BreakAwayContext>()); InsertDestination(); }
再次运行,数据库已经发生改变(第一次运行出现错误,提示数据库正在使用无法删除,我在进程中删除了sqlserver.exe运行才正常),但之前的数据已经不存在了,还是数据迁移的方法最好了,EF应该把这个设置成默认功能。