要更改EF中的默认配置有两个方法,一个是用Data Annotations(在命名空间System.ComponentModel.DataAnnotations;),直接作用于类的属性上面;还有一个就是Fluent API,通过新增相应的配置类来覆盖默认配置。现在我们用这两个来对比了解EF中的约定配置。
主键:KEY
Data Annotations:通过Key关键字来标识一个主键
[Key]public int DestinationId { get; set; }
Fluent API:
public class BreakAwayContext : DbContext { public DbSetDestinations { get; set; } public DbSet Lodgings { get; set; } protected override void OnModelCreating(DbModelBuilder modelBuilder) { //Fluent API modelBuilder.Entity ().HasKey(d => d.DestinationId); base.OnModelCreating(modelBuilder); } }
外键
Data Annotations:
public int DestinationId { get; set; } [ForeignKey("DestinationId")] public Destination Destination { get; set; }
注意,指定列名存在,如上面的DestinationId,则类中必须存在名称为DestinationId的属性。
Fluent API:
modelBuilder.Entity().HasRequired(p => p.Destination).WithMany(p=>p.Lodgings).HasForeignKey(p => p.DestinationId);
长度
Data Annotations:通过StringLength(长度),MinLength(最小长度),MaxLength(最大长度)来设置数据库中字段的长度。
[MinLength(10),MaxLength(30)] public string Name { get; set; } [StringLength(30)] public string Country { get; set; }
Fluent API:没有设置最小长度这个方法。
modelBuilder.Entity().Property(p => p.Name).HasMaxLength(30); modelBuilder.Entity ().Property(p => p.Country).HasMaxLength(30);
非空
Data Annotations:用Required来标识,还可以设置是否可允许空字符串,显示错误消息等。
[Required] public string Country { get; set; } [Required(ErrorMessage="请输入描述")] public string Description { get; set; }
Fluent API:
modelBuilder.Entity().Property(p => p.Country).IsRequired();
数据类型
Data Annotations:TypeName
//将string映射成ntext,默认为nvarchar(max) [Column(TypeName = "ntext")] public string Owner { get; set; }
Fluent API:
modelBuilder.Entity().Property(p => p.Owner).HasColumnType("ntext");
表名
Data Annotations:Table
[Table("MyLodging")] public class Lodging { public int LodgingId { get; set; } public string Name { get; set; } public string Owner { get; set; } public decimal Price { get; set; } public bool IsResort { get; set; } public Destination Destination { get; set; } }
Fluent API:
modelBuilder.Entity().ToTable("MyLodging");
列名
Data Annotations:Column
[Column("MyName")]public string Name { get; set; }
Fluent API:
modelBuilder.Entity().Property(p => p.Name).HasColumnName("MyName");
自增长
如果主键是int类型,EF为默认设置为增长。但如果是GUID类型,则要显示的设置自增长。
Data Annotations:DatabaseGenerated
public class Person { [Key, DatabaseGenerated(DatabaseGeneratedOption.Identity)] public Guid SocialId { get; set; } public string FirstName { get; set; } public string LastName { get; set; } }
看看创建数据的脚本,会加一句
ALTER TABLE [dbo].[People] ADD DEFAULT (newid()) FOR [SocialId]
Fluent API:
modelBuilder.Entity().Property(p => p.SocialId).HasDatabaseGeneratedOption(DatabaseGeneratedOption.Identity);
忽略列映射
类中有些属性,特别是一些通过计算或合并列得出的结果,我们并不需要其记录到数据库中,就可以通过配置不让它生成在数据库中。
Data Annotations:NotMapped
[NotMapped] public string Name { get { return FirstName + " " + LastName; } }
Fluent API:NotMapped
modelBuilder.Entity().Ignore(p => p.Name);
忽略表映射
对于不需要映射到数据库中的表,我们也可以取消其映射。
Data Annotations:
[NotMapped] public class Person { [Key] public Guid SocialId { get; set; } public string FirstName { get; set; } public string LastName { get; set; } }
Fluent API:
modelBuilder.Ignore();
时间戳
时间戳只对数据类型为byte[]的属性有效,并且一个类中只能有一个设置为时间戳的属性。
Data Annotations:Timestamp
[Timestamp] public Byte[] TimeStamp { get; set; }
Fluent API:
modelBuilder.Entity().Property(p => p.TimeStamp).IsRowVersion();
复杂类型
Data Annotations:ComplexType
[ComplexType] public class Address { public string Country { get; set; } public string City { get; set; } }
Fluent API:
modelBuilder.ComplexType();
关于什么是复杂类型,可以参见: