Entity Framework Code First约定-阿里云开发者社区

开发者社区> 开发与运维> 正文

Entity Framework Code First约定

简介:

Code First使你能够通过C# 或者 Visual Basic .NET来描述模型,模型的基本规则通过使用约定来进行检查,而约定就是一系列内置的规则。

Code First中基于类的定义通过一系列的规则约定自动配置概念模型,约定被定义在命名空间System.Data.Entity.ModelConfiguration.Conventions中。

你可以进一步配置你的模型通过数据注解或者fluent API。

优先通过 fluent API配置紧随其后的是数据注解约定。更多信息可以查看Data AnnotationsFluent API - RelationshipsFluent API - Types & Properties and Fluent API with VB.NET.

关于Code First的一系列约定可以参考API Documentation.这篇文章的主题主要阐述了Code First的约定

类型探索

当我们使用Code First开发的时候,通过写.NET Framework类来定义概念(领域)模型,除了定义类之外,你还需要让DbContext知道哪些类型是你想要代表的模型。因此,你需要定义一个上下文类继承自DbContext,用DbSet修饰你需要表示为模型的类型。Code First将包含这些类型并获取这个引用类型,即使引用来下被定义在不同的程序集当中。

如果你的类在继承结构体系当中,这些类在同一个程序集下面时,你将基类定义成一个DbSet属性就足够了,它将自动推断出所包含的其它相关联的类型。

复制代码
public class SchoolEntities : DbContext 
{ 
    public DbSet<Department> Departments { get; set; } 
} 
 public class Department 
{ 
    // Primary key 
    public int DepartmentID { get; set; } 
    public string Name { get; set; } 
 
    // Navigation property 
    public virtual ICollection<Course> Courses { get; set; } 
} 
 public class Course 
{ 
    // Primary key 
    public int CourseID { get; set; } 
 
    public string Title { get; set; } 
    public int Credits { get; set; } 
 
    // Foreign key 
    public int DepartmentID { get; set; } 
 
    // Navigation properties 
    public virtual Department Department { get; set; } 
} 
     public partial class OnlineCourse : Course 
{ 
    public string URL { get; set; } 
} 
 public partial class OnsiteCourse : Course 
{ 
    public string Location { get; set; } 
    public string Days { get; set; } 
    public System.DateTime Time { get; set; } 
}
复制代码

如果你不想让某一个类型作为模型类,你可以使用 NotMapped 属性或者使用 fluent API的DbModelBuilder.Ignore.

modelBuilder.Ignore<Department>();

主键约定

如果在类中存在名为"ID"(不区分大小写)的属性或者是类名+"ID",Code First将自动推断这个属性作为主键。

复制代码
public class Department 
{ 
    // Primary key 
    public int DepartmentID { get; set; }  
    . . .   
}
复制代码

关系约定

 Entity Framework中,导航属性提供两个实体类型之间的跳转,导航属性允许你从两个方向导航和管理关系,它返回一个引用对象(1个或者0个)或者一个集合(多个对象列表)。Code First 是基于导航属性来推断类型直接的关系的。

除了导航属性之外,建议你添加一个外键属性去表示对象直接的依赖关系。

遵循以下格式将表示一个外键的关系:<导航属性名称><被导航实体的主键名称>,<被导航实体的类名称><被导航实体的主键名称>,或者<被导航实体的主键名称>,如果找到了多个这样的匹配关系,将按照上面所给出的先后顺序来推断。外键检测是不区分大小写的。

当检测到一个外键属性, Code First基于可空的外键推断出关系。如果属性是可空的表示这个关系是可选的,否则这个关系将是必须注册的。

如果外键依赖的实体是不可空的, Code First 将设置级联删除的关系。如果外键依赖的实体是可空的,Code First将不设置级联删除关系,当引用的实体删除时,外键将被设置为null。更加多样的级联删除我们可以通过使用fluent API.来重新设置约定。

在如下的例子中导航属性和外键将被用于定义Department 和Course 类之间的关系。

复制代码
public class Department 
{ 
    // Primary key 
    public int DepartmentID { get; set; } 
    public string Name { get; set; } 
 
    // Navigation property 
    public virtual ICollection<Course> Courses { get; set; } 
} 
 public class Course 
{ 
    // Primary key 
    public int CourseID { get; set; } 
 
    public string Title { get; set; } 
    public int Credits { get; set; } 
 
    // Foreign key 
    public int DepartmentID { get; set; } 
 
    // Navigation properties 
    public virtual Department Department { get; set; } 
}
复制代码

注意:如果存在多个相同类型之间的关系(比如,假设你定义了Person and Book类,Person 类包含了 ReviewedBooks and AuthoredBooks这两个导航属性,同时Book类又包含了 Author and Reviewer导航属性 )你需要手动的通过Data Annotations 或者 the fluent API来配置关系。更多信息,请参考 Data Annotations - Relationships 和Fluent API - Relationships.

复制类型约定

Code First发现一个类的主键无法推测, 并且没有通过data annotations 或者fluent API来标识,那么这个类型将自动被当成一个复杂类型来处理,复杂类型要求它不存在引用其他实体类型的属性。

下面的类Details 将被当成复杂类型,因为它没有设置主键

复制代码
public partial class OnsiteCourse : Course 
{ 
    public OnsiteCourse() 
    { 
        Details = new Details(); 
    } 
 
    public Details Details { get; set; } 
} 
 
public class Details 
{ 
    public System.DateTime Time { get; set; } 
    public string Location { get; set; } 
    public string Days { get; set; } 
}
复制代码

连接字符串约定

学习更多关于 DbContext连接的约定可以查看 Connections and Models.

移除约定

在命名空间System.Data.Entity.ModelConfiguration.Conventions中,你可以移除约定,以下例子将移除PluralizingTableNameConvention.

复制代码
public class SchoolEntities : DbContext 
{ 
     . . . 
 
    protected override void OnModelCreating(DbModelBuilder modelBuilder) 
    { 
        // Configure Code First to ignore PluralizingTableName convention 
        // If you keep this convention, the generated tables  
        // will have pluralized names. 
        modelBuilder.Conventions.Remove<PluralizingTableNameConvention>(); 
    } 
}
复制代码

自定义约定

自定义约定在EF6开始支持,更多信息请查看 Custom Code First Conventions.

老外的文章真的是写得非常精彩,所以我强烈建议大家去看英文技术博客和文章,看不懂就硬着头皮看,久了自然就看得懂了,一开始即使看不懂文字说明,看看代码也好呀。

由于本人英文实在太烂,所以如果有翻译得不通顺的地方还忘见谅,大家可以参考原文,原文地址:Entity Framework Code First Conventions


本文转自邹琼俊博客园博客,原文链接:http://www.cnblogs.com/jiekzou/p/6422978.html,如需转载请自行联系原作者

版权声明:本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。

分享:
开发与运维
使用钉钉扫一扫加入圈子
+ 订阅

集结各类场景实战经验,助你开发运维畅行无忧

其他文章