這是一份非完整清單,列出 EF6 與 EF Core 之間行為的變化。 在移植應用程式時,務必注意這些問題,因為它們可能會改變應用程式的行為,但切換到 EF Core 後不會以編譯錯誤的形式出現。
這是作為轉移過程中需考量的高階檢視。 如需更詳細、逐案說明,請閱讀 詳細案例。
DbSet.Add/Attach 與資料圖行為
在 EF6 中,對某個實體呼叫 DbSet.Add() 會遞迴搜尋其導航屬性中所有被引用的實體。 任何已找到且尚未被上下文追蹤的實體,也會被標記為已新增。
DbSet.Attach() 行為相同,但所有實體都標記為未改變。
EF Core 執行類似的遞迴搜尋,但規則略有不同。
- 如果根實體已設定為產生的金鑰,但該金鑰未被設定,則會將其放入狀態
Added。 -
對於在遞迴搜尋導航屬性時發現的實體:
-
如果實體的主鍵是由儲存生成的
- 如果主鍵未設定為值,狀態會設定為加值。 若主鍵值被賦予屬性類型的 CLR 預設值(例如
0,為int、nullstring、 等),則視為「未設定」。 - 若主鍵設為值,狀態則設為不變。
- 如果主鍵未設定為值,狀態會設定為加值。 若主鍵值被賦予屬性類型的 CLR 預設值(例如
- 若主鍵非資料庫產生,該實體將與根鍵保持相同狀態。
-
如果實體的主鍵是由儲存生成的
- 這種行為改變僅適用於
Attach和Update方法群組。Add即使金鑰已設定,也會將實體置於狀態Added中。 -
Attach方法將帶有鍵設定的實體放入Unchanged狀態。 這方便「如果是新的就插入,否則就不要動它」。Update方法將帶有鍵設定的實體放入Modified狀態。 這方便「如果有新資料就插入,否則更新」。
這裡的一般理念是, Update 這是處理不連繫實體插入與更新的非常簡單方法。 它確保所有新的實體都會被插入,並且更新現有的實體。
同時,Add 仍然提供了一種強制插入實體的簡單方式。 Add 主要只在不使用儲存產生的金鑰時有用,EF 無法判斷該實體是否全新。
欲了解更多 EF Core 中這些行為的資訊,請閱讀 EF Core 中的變更追蹤。
Code First 資料庫初始化
EF6 在選擇資料庫連線和初始化資料庫時,有相當多的魔法效果。 其中一些規則包括:
- 若未進行設定,EF6 會選擇 SQL Express 或 LocalDB 上的資料庫。
- 如果應用程式
App/Web.config檔案中有與上下文名稱相同的連接字串,則會使用此連線。 - 如果資料庫不存在,則會建立它。
- 若模型中沒有任何資料表存在於資料庫中,則將目前模型的結構加入資料庫。 若啟用遷移,則用於建立資料庫。
- 如果資料庫存在且 EF6 先前已建立該架構,則會檢查該架構是否與目前模型相容。 若模型自結構建立以來有所變更,則會拋出例外。
EF Core 並不會執行這些神奇的動作。
- 資料庫連線必須在程式碼中明確設定。
- 不會進行初始化。 你必須使用
DbContext.Database.Migrate()來套用遷移(或使用DbContext.Database.EnsureCreated()和EnsureDeleted()在不使用遷移的情況下建立或刪除資料庫)。
Code First 表格命名慣例
EF6 會將實體類別名稱透過複數化處理服務來計算該實體所映射的預設表名稱。
EF Core 使用實體在衍生上下文中暴露的屬性名稱 DbSet。 若實體沒有屬性 DbSet ,則使用類別名稱。
欲了解更多資訊,請閱讀《 管理資料庫結構》。