9.2 翻译系列：数据注解特性之---Column【EF 6 Code First系列】

原文链接：

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开始，切记！！！