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開始,切記!!!