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

时间 2019-11-06

标签 9.2 翻译系列数据注解特性 column code 繁體版

原文原文链接

原文连接：http://www.entityframeworktutorial.net/code-first/column-dataannotations-attribute-in-code-first.aspxhtml

EF 6 Code-First系列文章目录：数据库

Column特性，能够应用于实体的一个或者多个属性上面，用来配置数据库中数据表中列的列名、列的数据类型以及列的前后顺序。Column特性重写了默认的约定。按照EF 6和EF Core中的默认约定，将会建立和属性相同的列名称，而且数据表，列的顺序和实体中属性的顺序一致。app

Column Attribute: [Column (string name, Properties:[Order = int],[TypeName = string])ide

name:表的数据列的名称测试

Order：列的顺序，从索引0开始【可选的】ui

TypeName:列的类型名称【可选的】spa

下面的例子，改变了一个列的名称：.net

在上面的例子中，咱们在StudentName属性上应用Column特性，因此EF将会重写默认约定，为咱们建立一个名称为Name的数据列，而不是StudentName数据列：翻译

列的数据类型3d

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