Column特性,可以应用于实体的一个或者多个属性上面,用来配置数据库中数据表中列的列名、列的数据类型以及列的先后顺序。Column特性重写了默认的约定。按照EF 6和EF Core中的默认约定,将会创建和属性相同的列名称,并且数据表,列的顺序和实体中属性的顺序一致。
Column Attribute: [Column (string name, Properties:[Order = int],[TypeName = string])
name:表的数据列的名称
Order:列的顺序,从索引0开始【可选的】
TypeName:列的类型名称【可选的】
下面的例子,改变了一个列的名称:
在上面的例子中,我们在StudentName属性上应用Column特性,所以EF将会重写默认约定,为我们创建一个名称为Name的数据列,而不是StudentName数据列:
列的数据类型
可以使用Column特性中的TypeName参数,来指定列的数据类型,如下:
在上面的例子中,我们在DataOfBirth属性上,设置了TypeName参数值为DataTime2,然后就会为我们生成类型为DataTime2的列,而不是DateTime类型的列。
列的先后顺序
使用从索引0开始的Order参数,来设置数据库中列的顺序。按照默认约定,主键列会是第一个,然后其他的列的顺序,就是基于属性在实体中的先后顺序了。
注意:Order参数必须要应用在实体的所有属性上面,并且索引数不能有一样的,索引从0开始。
上面的例子,将会在数据库中,生成这样的顺序的列:
好了,理论介绍完了,我们何不动手实践一下?
1.创建一个名称为EFAnnotationColumn的控制台应用程序。
2.安装EF【Install-Package EntityFramework -Version 6.2.0】
3.创建一个Book类:
public class Book
{
public int BookID { get; set; }
public string BookName { get; set; }
public string AuthorName { get; set; }
public DateTime PublishedDate { get; set; }
public decimal Price { get; set; }
}
4.创建一个上下文类:BookContext
public class BookContext:DbContext
{
public BookContext():base("name=Constr")
{
Database.SetInitializer<BookContext>(new DropCreateDatabaseAlways<BookContext>());
}
public DbSet<Book> Books { get; set; }
}
5.SQL连接字符串:
<connectionStrings>
<add name="Constr" connectionString="Server=.;Database=EFAnnotationColumnDB;uid=sa;pwd=Password_1" providerName="System.Data.SqlClient"/>
</connectionStrings>
6.测试代码:
class Program
{
static void Main(string[] args)
{
using (var db = new BookContext())
{
Book bookModel = new Book()
{
BookName = "西游记",
AuthorName = "吴承恩",
PublishedDate = DateTime.Now.AddYears(-200),
Price=109.99M
};
db.Entry(bookModel).State = System.Data.Entity.EntityState.Added;
db.SaveChanges();
}
Console.WriteLine("添加数据成功");
Console.ReadKey();
}
}
运行代码:
我们看看数据库:
可以看到默认约定,为我们生成了数据库以及数据表Books,列的顺序就和实体中属性先后顺序一样。
我们来修改一下Book实体:
然后运行项目:可以看到BookName字段名称,经过配置,生成了名称为BookTitle列。
我们再修改一下Book实体:
接着运行程序;看到PublishedDate列的数据类型成了我们配置的Date。
再修改一下Book实体:
public class Book
{
[Column(Order =3)]
public int BookID { get; set; }
[Column("BookTitle",Order =4)]
public string BookName { get; set; }
[Column(Order =1)]
public string AuthorName { get; set; }
[Column(TypeName ="Date",Order =0)]
public DateTime PublishedDate { get; set; }
[Column(Order =2)]
public decimal Price { get; set; }
}
我们使用数据注解,配置列的顺序是:PublishedDate -->AuthorName-->Price-->BookID-->BookName.那么实际上是不是这样呢,我们运行项目:
可以看到,列的顺序就是按照我们配置的这样。
有个疑问,上面说到,配置列的顺序的时候,必须对所有的列,都应用于Column的Order参数。我们来看看一个反例:
修改Book实体:
public class Book
{
[Column(Order =3)]
public int BookID { get; set; }
public string BookName { get; set; }
[Column(Order =1)]
public string AuthorName { get; set; }
[Column(TypeName ="Date",Order =0)]
public DateTime PublishedDate { get; set; }
public decimal Price { get; set; }
}
上面我们移除了BookName属性和Price属性的Column特性,没有设置Order。我们运行看看:
可以看到,EF是按照有设置Order参数的顺序来的,第一个是索引为0 的PublishedDate,第二个是索引为1的AuthorName,第三个就是索引为3的BookID了,然后后面两个就是按照他们在实体中的顺序来的了。
我们再改一下,只对一个属性设置Order,看看:
public int BookID { get; set; }
public string BookName { get; set; }
public string AuthorName { get; set; }
public DateTime PublishedDate { get; set; }
[Column(Order = 3)]
public decimal Price { get; set; }
上面代码,只对Price属性设置了Order,索引为3,我们运行看看:【可以看到Price成为了第一个列,排在最前面,然后后面的列的顺序,就是按照属性在实体中的先后顺序了。】
好了,这篇文章就介绍完了,主要讲解了数据注解特性之---Column,值得注意的是,当配置列的顺序的时候,必须对所有的列都应用于Column特性中的Order参数标记,索引从0开始,切记!!!