实业框架核心,全自动员搬迁移数据库的实现

By admin in 4858.com on 2019年4月6日

在开发涉及到数据库的顺序时,常会遇上1初始筹划的构造不能够满意须求要求再添加新字段或新表的景况,那时就供给展开数据库迁移。
金玉锦绣数据库迁移有很各种艺术,从手动管理种种版本的ddl脚本,到落实协调的migrator,或是使用Entity
Framework提供的Code First迁移功效。
Entity
Framework提供的迁徙效能可以知足大多数人的要求,但仍会存在难以分项目管理迁移代码和简单出现”context
has changed”错误的题材。

在付出涉及到数据库的先后时,常会遇上1起首筹划的构造不可能满意须要须求再添加新字段或新表的状态,这时就须求开始展览数据库迁移。
落到实处数据库迁移有很五种情势,从手动管理种种版本的ddl脚本,到达成和谐的migrator,或是使用Entity
Framework提供的Code First迁移功用。
Entity
Framework提供的迁移功效可以满意大多数人的必要,但仍会设有难以分门类管理迁移代码和易于并发”context
has changed”错误的标题。

**译文,私家原创,转发请评释出处(C# 陆 与 .NET Core 壹.0 高级编制程序 – 3八 章 实体框架宗旨(上)),不对的地方欢迎建议与调换。** 

章节出自《Professional
C# 6 and .NET Core
一.0》。水平有限,各位阅读时精心甄别,唯望莫误人子弟。

附英文版原来的作品:Professional C# 6 and .NET Core 1.0 – 38 Entity
Framework
Core

本章节译文分为上下篇,下篇见: C# 陆 与 .NET Core 一.0 高级编程 – 38 章
实体框架大旨(下)


本章内容

  • Entity
    Framework Core 1.0简介
  • 选拔信赖注入实体框架
  • 创办关系模型
  • 使用.NET
    CLI工具和MSBuild举办搬迁
  • 目的跟踪
  • 履新目的和目的树
  • 争辩处理与更新
  • 动用工作

Wrox.Com关于本章的源代码下载

本章的wrox.com代码下载位于
www.wrox.com/go/professionalcsharp六下载代码选项卡。本章的代码主要有以下示例:

  • Books
    Sample
  • Books
    Sample with DI
  • Menus
    Sample
  • Menus
    with Data Annotations
  • Conflict
    Handling Sample
  • Transactions
    Sample 

**译文,私家原创,转载请申明出处(C# 陆 与 .NET Core 一.0 高级编制程序 – 3八 章 实体框架大旨(上)),不对的地点欢迎提出与交换。** 

章节出自《Professional
C# 六 and .NET Core
一.0》。水平有限,各位阅读时精心鉴定分别,唯望莫误人子弟。

附英文版原版的书文:Professional C# 6 and .NET Core 1.0 – 38 Entity
Framework
Core

本章节译文分为上下篇,下篇见: C# 6 与 .NET Core 1.0 高级编制程序 – 3八 章
实体框架大旨(下)


本章内容

  • Entity
    Framework Core 1.0简介
  • 接纳信赖注入实体框架
  • 开创关系模型
  • 使用.NET
    CLI工具和MSBuild实行搬迁
  • 对象跟踪
  • 更新目的和对象树
  • 争论处理与更新
  • 行使工作

Wrox.Com关于本章的源代码下载

本章的wrox.com代码下载位于
www.wrox.com/go/professionalcsharp6下载代码选项卡。本章的代码主要有以下示例:

  • Books
    Sample
  • Books
    Sample with DI
  • Menus
    Sample
  • Menus
    with Data Annotations
  • Conflict
    Handling Sample
  • Transactions
    Sample 

此处作者将介绍ZKWeb网页框架在Fluent
NHibernate和Entity Framework Core上采纳的方法。
能够做到添加实体字段后,只需刷新网页就能够把改变应用到数据库。

此间自身将介绍ZKWeb网页框架在Fluent
NHibernate和Entity Framework Core上利用的不二秘籍。
能够完结添加实体字段后,只需刷新网页就足以把改变应用到数据库。

实业框架的历史

实业框架是提供实体到事关的照耀的框架。通过那种措施,能够成立映射到多少库表的档次,使用LINQ创制数据库查询,创立和创新指标,并将它们写入数据库。 

透过多年对Entity
Framework的微量修改,最新的本子是3个一心的重写。1起来探望Entity
Framework的历史,以及重写的缘由。

  • Entity
    Framework 1
    —Entity Framework的率先个版本没有安不忘忧好与.NET
    3.5金童玉女,但它高效就足以与.NET 三.5 SP一包容。另二个产品LINQ to
    SQL提供了有的好像的作用,且早已可用于.NET 叁.伍。 LINQ to SQL和Entity
    Framework在极大程度上提供了接近的功能。LINQ to
    SQL更便于使用,但不得不用来访问SQL
    Server。实体框架是依照提供程序的,并提供了对两样关周到据库的拜会。它蕴涵越来越多的功效,例如多对多映射而不须要映射对象,n对n映射是唯恐的。
    Entity
    Framework的四个败笔是它的模型类型需求由EntityObject基类派生。将对象映射到事关选择含有XML的EDMX文件实现的。包罗的XML由八个方式组成:概念形式定义(CSD)定义具有其品质和涉嫌的靶子类型;存款和储蓄形式定义(SSD)定义数据库表、列和事关;以及映射格局语言(MSL)定义CSD和SSD如何互相映射。

  • Entity
    Framework 4
    —Entity Framework 4 在.NET
    4中非常,并且赢得了严重性改革,在那之中许多起点LINQ到SQL的想法。由于变化较大,版本二和叁已被跳过。这些本子里扩充了推迟加载以获得访问属性的涉嫌。在选用SQL数据定义语言(DDL)设计模型之后,能够创设数据库。今后应用Entity
    Framework的多个模型是Database First或Model
    First。或然最关键的性状是帮助简单对象类(POCO),因此不再供给从基类EntityObject派生。

乘势更新(例如Entity
Framework 4.一,4.2),NuGet包扩大了附加的功用,由此能更加快地加上效果。
Entity Framework 四.壹提供了Code
First模型,当中用于定义映射的EDMX文件不再动用。相反,全数的照耀都选用C#代码定义

  • 采用品质或Fluent API来定义的映射。

Entity Framework
肆.二十日增了对搬迁的支撑。有了那点,就能够使用C#代码定义数据库结构的变更。使用数据库从应用程序自动应用数据库更新。

  • Entity
    Framework 5
    —Entity Framework ⑤的NuGet包协理.NET 四.5和.NET
    四应用程序。不过,Entity Framework 5的广大效果都可用于.NET 四.五。
    Entity Framework照旧基于.NET
    肆.5在系统上安装的品类。此版本的新增效益是性质创新以及协助新的SQL
    Server功用,例如空间数据类型。

  • Entity
    Framework 6
    —Entity Framework 6消除了Entity Framework
    5的部分标题,当中有个别是安装在系统上的框架的1有的,一部分经过NuGet扩大提供。近日Entity
    Framework的全套代码已移至NuGet包。为了不造成争辨,使用了三个新的命名空间。将应用程序移植到新本羊时,必须变更命名空间。

本书切磋Entity
Framework的风靡版本,Entity Framework Core
1.0。此版本是3个剔除旧的一言一行周详重写,不再帮助CSDL,SSDL和MSL的XML文件映射,只帮助Code
First – 使用Entity Framework 肆.1增加的模型。Code First
并不意味着数据库不可能先存在。您可以先创制数据库,或许仅从代码中定义数据库,以上三种选择都以实惠的。

注意 Code First
那几个称呼有个别程度上令人误解。Code First
先创立代码或先数据库都以实用的。最初Code First的测试版本名称是Code
Only。因为任何模型选项在称呼和浩特中学有First,所以“Code
Only”的名称也被转移。

Entity
Framework 的一揽子重写不仅支持关周详据库,还辅助NoSql数据库 –
只要求2个提供程序。在写作本文时,提供程序补助有限,但相信会随时间而充实。 

新本子的Entity
Framework基于.NET
Core,由此在Linux和Mac系统上也足以动用此框架。 

Entity
Framework Core 壹.0不完全帮忙Entity Framework
陆提供的兼具机能。随着时间的推迟,Entity
Framework的新本子将提供越多效益,留意所利用的Entity
Framework的版本。就算采纳Entity Framework 陆很多强劲的说辞,但在非Windows平台上选取ASP.NET Core 一.0、Entity
Framework和通用Windows平台(UWP),以及非关周到据存款和储蓄,都亟需选拔Entity
Framework Core 1.0。 

本章介绍Entity
Framework Core 壹.0。从3个不难的模子读取和SQL
Server中写入音讯初阶,稍后会介绍添加关系,在写入数据库时将介绍更改跟踪器和争辨处理。利用搬迁成立和修改数据库结构是本章的另一个首要片段。 

注意 本章使用Books数据库,此数据库包罗在示范代码的下载包中 www.wrox.com/go/professionalcsharp6. 

实体框架的历史

实业框架是提供实体到关系的照射的框架。通过那种方法,能够创设映射到数码库表的档次,使用LINQ创设数据库查询,创设和换代目的,并将它们写入数据库。 

透过多年对Entity
Framework的微量改动,最新的本子是八个全然的重写。一起来探望Entity
Framework的历史,以及重写的原由。

  • Entity
    Framework 1
    —Entity Framework的首先个版本未有居安思危好与.NET
    三.5男才女貌,但它高效就能够与.NET 三.5 SP一包容。另3个成品LINQ to
    SQL提供了部分类似的效果,且早已可用于.NET 三.5。 LINQ to SQL和Entity
    Framework在相当的大程度上提供了类似的效应。LINQ to
    SQL更便于使用,但不得不用于访问SQL
    Server。实体框架是根据提供程序的,并提供了对两样关全面据库的走访。它包涵越多的法力,例如多对多映射而不必要映射对象,n对n映射是唯恐的。
    Entity
    Framework的三个缺点是它的模型类型供给由EntityObject基类派生。将指标映射到事关选拔含有XML的EDMX文件完毕的。包蕴的XML由四个方式组成:概念形式定义(CSD)定义具有其质量和关联的靶子类型;存款和储蓄情势定义(SSD)定义数据库表、列和关系;以及映射形式语言(MSL)定义CSD和SSD怎么着相互映射。

  • Entity
    Framework 4
    —Entity Framework 4 在.NET
    4中卓绝,并且赢得了至关心重视要立异,在那之中许多来源于LINQ到SQL的想法。由于变化较大,版本2和3已被跳过。这一个版本里扩充了延期加载以得到访问属性的涉嫌。在选用SQL数据定义语言(DDL)设计模型之后,能够创制数据库。未来选拔Entity
    Framework的多个模型是Database First或Model
    First。恐怕最关键的风味是永葆不难对象类(POCO),由此不再须求从基类EntityObject派生。

乘机更新(例如Entity
Framework 四.一,四.二),NuGet包增添了额外的法力,因而能越来越快地抬高效果。
Entity Framework 4.一提供了Code
First模型,当中用于定义映射的EDMX文件不再使用。相反,全数的投射都应用C#代码定义

  • 运用性质或Fluent API来定义的照耀。

Entity Framework
四.三充实了对搬迁的协理。有了这点,就可以应用C#代码定义数据库结构的变更。使用数据库从应用程序自动应用数据库更新。

  • Entity
    Framework 5
    —Entity Framework 5的NuGet包帮忙.NET 4.伍和.NET
    四应用程序。可是,Entity Framework 五的广大功能都可用于.NET 4.五。
    Entity Framework依然基于.NET
    四.伍在系统上设置的品类。此版本的新增效益是性质立异以及帮忙新的SQL
    Server功效,例如空间数据类型。

  • Entity
    Framework 6
    —Entity Framework 陆消除了Entity Framework
    五的部分题材,当中壹些是设置在系统上的框架的1部分,一部分透过NuGet增添提供。近期Entity
    Framework的总体代码已移至NuGet包。为了不造成争执,使用了1个新的命名空间。将应用程序移植到新本申时,必须变更命名空间。

本书研讨Entity
Framework的最新版本,Entity Framework Core
一.0。此版本是二个剔除旧的作为周详重写,不再辅助CSDL,SSDL和MSL的XML文件映射,只协理Code
First – 使用Entity Framework 四.壹抬高的模子。Code First
并不意味着数据库无法先存在。您能够先创设数据库,也许仅从代码中定义数据库,以上二种选取都以有效的。

注意 Code First
那个名号某个程度上让人误解。Code First
先创造代码或先数据库都是实用的。最初Code First的测试版本名称是Code
Only。因为其余模型选项在名称中有First,所以“Code
Only”的称号也被改变。

Entity
Framework 的1揽子重写不仅帮衬关周全据库,还支持NoSql数据库 –
只须要一个提供程序。在写作本文时,提供程序援助有限,但相信会随时间而扩张。 

新本子的Entity
Framework基于.NET
Core,由此在Linux和Mac系统上也足以动用此框架。 

Entity
Framework Core 一.0不完全支持Entity Framework
陆提供的有所成效。随着时间的延迟,Entity
Framework的新本子将提供越来越多职能,留意所采纳的Entity
Framework的版本。就算选取Entity Framework 6很多强硬的说辞,但在非Windows平台上利用ASP.NET Core 一.0、Entity
Framework和通用Windows平台(UWP),以及非关周到据存款和储蓄,都亟需利用Entity
Framework Core 1.0。 

本章介绍Entity
Framework Core 一.0。从八个简易的模型读取和SQL
Server中写入新闻早先,稍后会介绍添加关系,在写入数据库时将介绍更改跟踪器和争执处理。利用搬迁成立和改动数据库结构是本章的另3个重中之重部分。 

注意 本章使用Books数据库,此数据库包罗在演示代码的下载包中 www.wrox.com/go/professionalcsharp6. 

落到实处机关迁移的笔触

数据库迁移需求钦定变更的片段,例如添加表和添加字段。
而达成全自动员搬迁移要求自动生成这么些改变的部分,具体来说供给

  • 获得数据库现有的组织
  • 赢得代码中现有的结构
  • 相比较之下结构之间的差别并扭转迁移

那多亏Entity Framework的Add-Migration(或dotnet ef migrations
add)命令所做的工作,
接下去大家将看哪样不应用那类的授命,在NHibernate, Entity
Framework和Entity Framework Core中贯彻活动的拍卖。

兑现自动员搬迁移的思绪

数据库迁移须求钦定变更的有的,例如添加表和丰裕字段。
而落到实处机关迁移需求自动生成这一个改变的1对,具体来说需求

  • 取得数据库现有的结构
  • 获得代码中幸存的组织
  • 绝对而言结构之间的差异并生成迁移

那便是Entity Framework的Add-Migration(或dotnet ef migrations
add)命令所做的业务,
接下去我们将看怎么不选取那类的吩咐,在NHibernate, Entity
Framework和Entity Framework Core中实现自动的处理。

实体框架简介

率先个示范使用单个Book类型,并将此类型映射到SQL
Server数据库中的Books表。能够将记录写入数据库,然后读取,更新和删除它们。 

在第3个示范中,首先成立数据库。能够使用Visual
Studio 二零一六中的SQL
Server对象能源管理器执行此操作。选拔数据库实例(与Visual
Studio一起安装的(localdb)\
MSSQLLocalDB),单击树视图中的数据库节点,然后选取“添加新数据库”。示例数据库唯有一个名称叫Books的表。 

挑选Books数据库中的表节点,然后采用”添加新表”来创造表Books。使用图38.第11中学所示的设计器,只怕通过在T-SQL编辑器中输入SQL
DDL语句,都足以创设表Books。以下代码段展现了用来成立表的T-SQL代码。单击“更新”按钮能够将转移提交到数据库。

CREATE TABLE [dbo].[Books]
(
  [BookId] INT NOT NULL PRIMARY KEY IDENTITY,
  [Title] NVARCHAR(50) NOT NULL,
  [Publisher] NVARCHAR(25) NOT NULL
)

实业框架简介

第1个示范使用单个Book类型,并将此类型映射到SQL
Server数据库中的Books表。能够将记录写入数据库,然后读取,更新和删除它们。 

在首先个示范中,首先创设数据库。能够运用Visual
Studio 贰零14中的SQL
Server对象能源管理器执行此操作。选取数据库实例(与Visual
Studio一起安装的(localdb)\
MSSQLLocalDB),单击树视图中的数据库节点,然后选择“添加新数据库”。示例数据库唯有二个名称叫Books的表。 

慎选Books数据库中的表节点,然后接纳”添加新表”来创造表Books。使用图3八.第11中学所示的设计器,只怕通过在T-SQL编辑器中输入SQL
DDL语句,都得以创制表Books。以下代码段呈现了用来创制表的T-SQL代码。单击“更新”按钮能够将改成提交到数据库。

CREATE TABLE [dbo].[Books]
(
  [BookId] INT NOT NULL PRIMARY KEY IDENTITY,
  [Title] NVARCHAR(50) NOT NULL,
  [Publisher] NVARCHAR(25) NOT NULL
)

Fluent NHibernate的自发性迁移

ZKWeb框架使用的总体代码能够翻看那里

首先Fluent
NHibernate必要添加全数实体的照射类型,以下是浮动配置和丰富实业映射类型的例子。
配置类的构造得以翻开那里

var db = MsSqlConfiguration.MsSql2008.ConnectionString("连接字符串");
var configuration = Fluently.Configure();
configuration.Database(db);
configuration.Mappings(m => {
    m.FluentMappings.Add(typeof(FooEntityMap));
    m.FluentMappings.Add(typeof(BarEntityMap));
    ...
});

接下去是把具有实体的构造充足或更新到数据库。
NHibernate提供了SchemaUpdate,这一个类能够自动物检疫验数据库中是还是不是已经有表或字段,未有时自动抬高。
选择办法非凡不难,以下是利用的例证

configuration.ExposeConfiguration(c => {
    // 第一个参数 false: 不把语句输出到控制台
    // 第二个参数 true: 实际在数据库中执行语句
    new SchemaUpdate(c).Execute(false, true);
});

到这一步就曾经落到实处了自行迁移,但大家还有革新的后路。
因为SchemaUpdate不保留景况,每趟都要检查测试数据库中的整个结构,所以实行起来EF的迁移要舒缓很多,
ZKWeb框架为了削减每一次运营网站的光阴,在履行更新从前还会检验是还是不是必要创新。

var scriptBuilder = new StringBuilder();
scriptBuilder.AppendLine("/* this file is for database migration checking, don't execute it */");
new SchemaExport(c).Create(s => scriptBuilder.AppendLine(s), false);
var script = scriptBuilder.ToString();
if (!File.Exists(ddlPath) || script != File.ReadAllText(ddlPath)) {
    new SchemaUpdate(c).Execute(false, true);
    onBuildFactorySuccess = () => File.WriteAllText(ddlPath, script);
}

那段代码应用了SchemaExport来扭转全部表的DDL脚本,生成后和上次的转变结果比较,不均等时才调用SchemaUpdate更新。

NHibernate提供的机动员搬迁移有以下的特色,使用时应该注意

  • 实业框架核心,全自动员搬迁移数据库的实现。字段只会助长,不会去除,假若您重命名了字段原来的字段也会保留在数据库中
  • 字段类型倘若改动,数据库不会随着变动
  • 波及的外键尽管改变,迁移时有希望会出错

小结NHibernate的自发性迁移只会添加表和字段,基本不会修改原有的结构,有一定的范围只是正如安全。

Fluent NHibernate的机关迁移

ZKWeb框架使用的完全代码可以翻看那里

首先Fluent
NHibernate需求添加全部实体的照射类型,以下是浮动配置和拉长实业映射类型的例子。
配置类的构造得以翻开这里

var db = MsSqlConfiguration.MsSql2008.ConnectionString("连接字符串");
var configuration = Fluently.Configure();
configuration.Database(db);
configuration.Mappings(m => {
    m.FluentMappings.Add(typeof(FooEntityMap));
    m.FluentMappings.Add(typeof(BarEntityMap));
    ...
});

接下去是把持有实体的构造丰裕或更新到数据库。
NHibernate提供了SchemaUpdate,这么些类能够自动检查测试数据库中是或不是已经有表或字段,未有时自动抬高。
选用办法极度简单,以下是行使的例证

configuration.ExposeConfiguration(c => {
    // 第一个参数 false: 不把语句输出到控制台
    // 第二个参数 true: 实际在数据库中执行语句
    new SchemaUpdate(c).Execute(false, true);
});

到这一步就曾经完毕了电动员搬迁移,但大家还有革新的退路。
因为SchemaUpdate不保留景况,每趟都要检查实验数据库中的整个结构,所以举办起来EF的迁移要舒缓很多,
ZKWeb框架为了削减每趟运维网址的岁月,在履行更新从前还会检查实验是还是不是要求立异。

var scriptBuilder = new StringBuilder();
scriptBuilder.AppendLine("/* this file is for database migration checking, don't execute it */");
new SchemaExport(c).Create(s => scriptBuilder.AppendLine(s), false);
var script = scriptBuilder.ToString();
if (!File.Exists(ddlPath) || script != File.ReadAllText(ddlPath)) {
    new SchemaUpdate(c).Execute(false, true);
    onBuildFactorySuccess = () => File.WriteAllText(ddlPath, script);
}

那段代码应用了SchemaExport来扭转全部表的DDL脚本,生成后和上次的转移结果相比,不同时才调用SchemaUpdate更新。

NHibernate提供的自行迁移有以下的性状,使用时应该注意

  • 字段只会增进,不会去除,倘使您重命名了字段原来的字段也会保留在数据库中
  • 字段类型要是改变,数据库不会随着变动
  • 论及的外键若是改变,迁移时有一点都不小大概会出错

总结NHibernate的电动员搬迁移只会添加表和字段,基本不会修改原有的结构,有肯定的限定只是比较安全。

创造模型 

用来访问Books数据库的以身作则应用程序BookSample是一个控制台应用程序(Package)。此示例使用以下重视项和命名空间:

  依赖项

NETStandard.Library
Microsoft.EntityFrameworkCore
Microsoft.EntityFrameworkCore.SqlServer

   取名空间

Microsoft.EntityFrameworkCore
System.ComponentModel.DataAnnotations.Schema
System
System.Linq
System.Threading.Tasks
static System.Console

 4858.com 1


38.1
  

Book类是二个简便的实体类型,它定义了五个属性。
BookId属性映射到表的主键,Title属性指向标题列,Publisher属性指向Publisher列。Table属性应用于类型将品种映射到Books表(代码文件BooksSample
/ Book.cs):

[Table("Books")]
public class Book
{
  public int BookId { get; set; }
  public string Title { get; set; }
  public string Publisher { get; set; }
}

创办模型 

用来访问Books数据库的示范应用程序Book萨姆ple是八个控制台应用程序(Package)。此示例使用以下重视项和命名空间:

  依赖项

NETStandard.Library
Microsoft.EntityFrameworkCore
Microsoft.EntityFrameworkCore.SqlServer

   命名空间

Microsoft.EntityFrameworkCore
System.ComponentModel.DataAnnotations.Schema
System
System.Linq
System.Threading.Tasks
static System.Console

 4858.com 2


38.1
  

Book类是三个不难易行的实业类型,它定义了八个性格。
BookId属性映射到表的主键,Title属性指向题目列,Publisher属性指向Publisher列。Table属性应用于类型将品种映射到Books表(代码文件Books萨姆ple
/ Book.cs):

[Table("Books")]
public class Book
{
  public int BookId { get; set; }
  public string Title { get; set; }
  public string Publisher { get; set; }
}

Entity Framework的活动员搬迁移

ZKWeb框架未有协理Entity Framework 六,但贯彻比较简单笔者就平昔上代码了。
例子

// 调用静态函数,放到程序启动时即可
// Database是System.Data.Entity.Database
Database.SetInitializer(new MigrateDatabaseToLatestVersion<MyContext, MyConfiguration>());

public class MyConfiguration : DbMigrationsConfiguration<MyContext> {
    public MyConfiguration() {
        AutomaticMigrationsEnabled = true; // 启用自动迁移功能
        AutomaticMigrationDataLossAllowed = true; // 允许自动删字段,危险但是不加这个不能重命名字段
    }
}

Entity Framework提供的电动迁移有以下的风味,使用时应有专注

  • 若果字段重命名,旧的字段会被删去掉,推荐做好数据的备份和尽量防止重命名字段
  • 外键关联和字段类型都会自动生成,变化时有希望会造成原有的多寡丢失
  • 机关迁移的记录和动用工具迁移1样,都会保存在__MigrationHistory表中,切勿混用不然代码将无法用到新的数据库中

总括Entity
Framework的迁徙能够确认保证实体和数据库之间很强的1致性,但是使用不当会促成原本数据的散失,请务必做好数据库的定时备份。

Entity Framework的机动员搬迁移

ZKWeb框架未有辅助Entity Framework 六,但达成相比简单作者就径直上代码了。
例子

// 调用静态函数,放到程序启动时即可
// Database是System.Data.Entity.Database
Database.SetInitializer(new MigrateDatabaseToLatestVersion<MyContext, MyConfiguration>());

public class MyConfiguration : DbMigrationsConfiguration<MyContext> {
    public MyConfiguration() {
        AutomaticMigrationsEnabled = true; // 启用自动迁移功能
        AutomaticMigrationDataLossAllowed = true; // 允许自动删字段,危险但是不加这个不能重命名字段
    }
}

Entity Framework提供的自发性迁移有以下的表征,使用时应当小心

  • 要是字段重命名,旧的字段会被删去掉,推荐做好数据的备份和尽量制止重命名字段
  • 外键关联和字段类型都会自行生成,变化时有一点都不小可能率会导致原本的数据丢失
  • 电动员搬迁移的笔录和接纳工具迁移一样,都会保存在__MigrationHistory表中,切勿混用不然代码将无法用到新的数据库中

4858.com,小结Entity
Framework的搬迁能够保险实体和数据库之间很强的一致性,不过使用不当会造成原有数据的散失,请务必做好数据库的定时备份。

始建上下文 

创办的BooksContext类完毕Book表与数据库的涉嫌。这一个类派生自基类DbContext,BooksContext类定义Books属性类型为DbSet
<Book>。此类型允许创立查询并添加Book实例以将其储存在数据库中。要定义连接字符串,能够重写DbContext的OnConfiguring方法。UseSqlServer扩张方法将左右文映射到SQL
Server数据库(代码文件BooksSample / BooksContext.cs):

public class BooksContext: DbContext
{
  private const string ConnectionString =  @"server= (localdb)\MSSQLLocalDb;database=Books;trusted_connection=true";
  public DbSet<Book> Books { get; set; }
  protected override void OnConfiguring(DbContextOptionsBuilder  optionsBuilder)
  {
    base.OnConfiguring(optionsBuilder);
    optionsBuilder.UseSqlServer(ConnectionString);
  }
}

概念连接字符串的另三个摘取是选择信赖注入,将在本章前边介绍。 

开创上下文 

创建的BooksContext类完毕Book表与数据库的涉嫌。那一个类派生自基类DbContext,BooksContext类定义Books属性类型为DbSet
<Book>。此类型允许成立查询并添加Book实例以将其储存在数据库中。要定义连接字符串,能够重写DbContext的OnConfiguring方法。UseSqlServer扩充方法将左右文映射到SQL
Server数据库(代码文件Books萨姆ple / BooksContext.cs):

public class BooksContext: DbContext
{
  private const string ConnectionString =  @"server= (localdb)\MSSQLLocalDb;database=Books;trusted_connection=true";
  public DbSet<Book> Books { get; set; }
  protected override void OnConfiguring(DbContextOptionsBuilder  optionsBuilder)
  {
    base.OnConfiguring(optionsBuilder);
    optionsBuilder.UseSqlServer(ConnectionString);
  }
}

概念连接字符串的另三个抉择是应用正视注入,将在本章前边介绍。 

Entity Framework Core的全自动员搬迁移

Entity Framework
Core去掉了SetInitializer挑选,取而代之的是DatabaseFacade.MigrateDatabaseFacade.EnsureCreated
DatabaseFacade.Migrate能够利用使用ef命令生成的动员搬迁代码,制止在生育条件中履行ef命令。
DatabaseFacade.EnsureCreated则开首创立全体数据表和字段,但不得不成立不能够立异,不会添加纪录到__MigrationHistory
那七个函数都无法促成全自动员搬迁移,ZKWeb框架使用了EF内部提供的函数,完整代码能够翻开那里

Entity Framework Core的自动员搬迁移完毕相比较复杂,大家须求分两步走。

  • 先是步
    制造迁移记录__ZKWeb_MigrationHistory表,那些表和EF自带的组织同样,但这么些表是给协调用的不是给ef命令用的
  • 其次部
    查找最后一条迁移记录,和当前的布局举行相比,找出差异并立异数据库

率先步的代码应用了EnsureCreated开创数据库和迁移记录表,在那之中EFCoreDatabaseContextBase唯有迁移记录1个表。
创建完未来还要把带迁移记录的结构保留下来,用作前边的对照,即便那里不保留会促成迁移记录的双重成立错误。

using (var context = new EFCoreDatabaseContextBase(Database, ConnectionString)) {
    // We may need create a new database and migration history table
    // It's done here
    context.Database.EnsureCreated();
    initialModel = context.Model;
}

在实践第1步事先,还要求先判断连接的数据库是或不是关周到据库,
因为Entity Framework Core未来还会支撑redis
mongodb等非关系型数据库,自动员搬迁移只应该用在关全面据库中。

using (var context = new EFCoreDatabaseContext(Database, ConnectionString)) {
    var serviceProvider = ((IInfrastructure<IServiceProvider>)context).Instance;
    var databaseCreator = serviceProvider.GetService<IDatabaseCreator>();
    if (databaseCreator is IRelationalDatabaseCreator) {
        // It's a relational database, create and apply the migration
        MigrateRelationalDatabase(context, initialModel);
    } else {
        // It maybe an in-memory database or no-sql database, do nothing
    }
}

其次步要求摸索最终一条迁移记录,和日前的组织进行自己检查自纠,找出差异并革新数据库。

先看迁移记录表的内容,迁移记录表中有八个字段

  • Revision 每一次迁移都会+一
  • Model 当前的组织,格式是c#代码
  • ProductVersion 迁移时Entity Framework Core的版本号

Model存放的代码例子如下,这段代码记录了全体表的享有字段的定义,是自动生成的。
末端作者将会讲课怎么样生成那段代码。

using System;
using Microsoft.EntityFrameworkCore;
using Microsoft.EntityFrameworkCore.Infrastructure;
using Microsoft.EntityFrameworkCore.Metadata;
using Microsoft.EntityFrameworkCore.Migrations;
using ZKWeb.ORM.EFCore;

namespace ZKWeb.ORM.EFCore.Migrations
{
    [DbContext(typeof(EFCoreDatabaseContext))]
    partial class Migration_636089159513819123 : ModelSnapshot
    {
        protected override void BuildModel(ModelBuilder modelBuilder)
        {
            modelBuilder
                .HasAnnotation("ProductVersion", "1.0.0-rtm-21431")
                .HasAnnotation("SqlServer:ValueGenerationStrategy", SqlServerValueGenerationStrategy.IdentityColumn);

            modelBuilder.Entity("Example.Entities.Foo", b =>
                {
                    b.Property<Guid>("Id")
                        .ValueGeneratedOnAdd();

                    b.Property<string>("Name")
                        .IsRequired();
                });
            }
        }
    }
}

接下去查找最后一条迁移记录:

var lastModel = initialModel;
var histories = context.Set<EFCoreMigrationHistory>();
var lastMigration = histories.OrderByDescending(h => h.Revision).FirstOrDefault();

留存时,编译Model中的代码并且取得ModelSnapshot.Model的值,那一个值正是上三回迁移时的全部结构。
不设有时,将动用initialModel的结构。
编译使用的是其余三个零部件,你也足以用Roslyn CSharpScripting包提供的接口编写翻译。

if (lastMigration != null) {
    // Remove old snapshot code and assembly
    var tempPath = Path.GetTempPath();
    foreach (var file in Directory.EnumerateFiles(
        tempPath, ModelSnapshotFilePrefix + "*").ToList()) {
        try { File.Delete(file); } catch { }
    }
    // Write snapshot code to temp directory and compile it to assembly
    var assemblyName = ModelSnapshotFilePrefix + DateTime.UtcNow.Ticks;
    var codePath = Path.Combine(tempPath, assemblyName + ".cs");
    var assemblyPath = Path.Combine(tempPath, assemblyName + ".dll");
    var compileService = Application.Ioc.Resolve<ICompilerService>();
    var assemblyLoader = Application.Ioc.Resolve<IAssemblyLoader>();
    File.WriteAllText(codePath, lastMigration.Model);
    compileService.Compile(new[] { codePath }, assemblyName, assemblyPath);
    // Load assembly and create the snapshot instance
    var assembly = assemblyLoader.LoadFile(assemblyPath);
    var snapshot = (ModelSnapshot)Activator.CreateInstance(
        assembly.GetTypes().First(t =>
        typeof(ModelSnapshot).GetTypeInfo().IsAssignableFrom(t)));
    lastModel = snapshot.Model;
}

和当下的布局举办自查自纠:

// Compare with the newest model
var modelDiffer = serviceProvider.GetService<IMigrationsModelDiffer>();
var sqlGenerator = serviceProvider.GetService<IMigrationsSqlGenerator>();
var commandExecutor = serviceProvider.GetService<IMigrationCommandExecutor>();
var operations = modelDiffer.GetDifferences(lastModel, context.Model);
if (operations.Count <= 0) {
    // There no difference
    return;
}

万一有反差,生成迁移命令(commands)和当前全体结构的快速照相(modelSnapshot)。
地点Model中的代码由那里的CSharpMigrationsGenerator生成,modelSnapshot的门类是string

// There some difference, we need perform the migration
var commands = sqlGenerator.Generate(operations, context.Model);
var connection = serviceProvider.GetService<IRelationalConnection>();
// Take a snapshot to the newest model
var codeHelper = new CSharpHelper();
var generator = new CSharpMigrationsGenerator(
    codeHelper,
    new CSharpMigrationOperationGenerator(codeHelper),
    new CSharpSnapshotGenerator(codeHelper));
var modelSnapshot = generator.GenerateSnapshot(
    ModelSnapshotNamespace, context.GetType(),
    ModelSnapshotClassPrefix + DateTime.UtcNow.Ticks, context.Model);

插入迁移记录并执行迁移命令:

// Insert the history first, if migration failed, delete it
var history = new EFCoreMigrationHistory(modelSnapshot);
histories.Add(history);
context.SaveChanges();
try {
    // Execute migration commands
    commandExecutor.ExecuteNonQuery(commands, connection);
} catch {
    histories.Remove(history);
    context.SaveChanges();
    throw;
}

到此处就做到了Entity Framework
Core的自动迁移,未来每一回有创新都会比较最终二遍迁移时的构造并履行更新。
Entity Framework Core的迁徙特点和Entity
Framework一样,能够确定保证很强的一致性但要求小心预防数据的不见。

Entity Framework Core的机动员搬迁移

Entity Framework
Core去掉了SetInitializer慎选,取而代之的是DatabaseFacade.MigrateDatabaseFacade.EnsureCreated
DatabaseFacade.Migrate能够行使使用ef命令生成的迁徙代码,制止在生养环境中执行ef命令。
DatabaseFacade.EnsureCreated则始于创造全部数据表和字段,但不得不创立无法更新,不会添加纪录到__MigrationHistory
那八个函数都无法兑现机关迁移,ZKWeb框架使用了EF内部提供的函数,完整代码能够查阅那里

Entity Framework Core的电动迁移完毕相比复杂,大家须求分两步走。

  • 率先步
    创设迁移记录__ZKWeb_MigrationHistory表,那几个表和EF自带的结构同样,但那几个表是给本身用的不是给ef命令用的
  • 第贰部
    查找最后一条迁移记录,和脚下的构造举办对照,找出差别并更新数据库

先是步的代码应用了EnsureCreated创办数据库和迁移记录表,其中EFCoreDatabaseContextBase只有迁移记录3个表。
创立完之后还要把带迁移记录的布局保留下来,用作前边的争辩统一,假如那里不保留会导致迁移记录的再一次创制错误。

using (var context = new EFCoreDatabaseContextBase(Database, ConnectionString)) {
    // We may need create a new database and migration history table
    // It's done here
    context.Database.EnsureCreated();
    initialModel = context.Model;
}

在实施第2步事先,还索要先判断连接的数据库是还是不是关周全据库,
因为Entity Framework Core未来还会协理redis
mongodb等非关系型数据库,自动员搬迁移只应该用在关周详据库中。

using (var context = new EFCoreDatabaseContext(Database, ConnectionString)) {
    var serviceProvider = ((IInfrastructure<IServiceProvider>)context).Instance;
    var databaseCreator = serviceProvider.GetService<IDatabaseCreator>();
    if (databaseCreator is IRelationalDatabaseCreator) {
        // It's a relational database, create and apply the migration
        MigrateRelationalDatabase(context, initialModel);
    } else {
        // It maybe an in-memory database or no-sql database, do nothing
    }
}

其次步须求寻找最终一条迁移记录,和当前的构造举行对照,找出差别并创新数据库。

先看迁移记录表的剧情,迁移记录表中有八个字段

  • Revision 每便迁移都会+壹
  • Model 当前的结构,格式是c#代码
  • ProductVersion 迁移时Entity Framework Core的版本号

Model存放的代码例子如下,那段代码记录了全部表的全部字段的定义,是自动生成的。
后边我将会讲课怎样生成那段代码。

using System;
using Microsoft.EntityFrameworkCore;
using Microsoft.EntityFrameworkCore.Infrastructure;
using Microsoft.EntityFrameworkCore.Metadata;
using Microsoft.EntityFrameworkCore.Migrations;
using ZKWeb.ORM.EFCore;

namespace ZKWeb.ORM.EFCore.Migrations
{
    [DbContext(typeof(EFCoreDatabaseContext))]
    partial class Migration_636089159513819123 : ModelSnapshot
    {
        protected override void BuildModel(ModelBuilder modelBuilder)
        {
            modelBuilder
                .HasAnnotation("ProductVersion", "1.0.0-rtm-21431")
                .HasAnnotation("SqlServer:ValueGenerationStrategy", SqlServerValueGenerationStrategy.IdentityColumn);

            modelBuilder.Entity("Example.Entities.Foo", b =>
                {
                    b.Property<Guid>("Id")
                        .ValueGeneratedOnAdd();

                    b.Property<string>("Name")
                        .IsRequired();
                });
            }
        }
    }
}

接下去查找最终一条迁移记录:

var lastModel = initialModel;
var histories = context.Set<EFCoreMigrationHistory>();
var lastMigration = histories.OrderByDescending(h => h.Revision).FirstOrDefault();

留存时,编写翻译Model中的代码并且获得ModelSnapshot.Model的值,这么些值正是上二遍迁移时的总体结构。
不设有时,将选拔initialModel的结构。
编译使用的是别的3个零件,你也能够用Roslyn CSharpScripting包提供的接口编写翻译。

if (lastMigration != null) {
    // Remove old snapshot code and assembly
    var tempPath = Path.GetTempPath();
    foreach (var file in Directory.EnumerateFiles(
        tempPath, ModelSnapshotFilePrefix + "*").ToList()) {
        try { File.Delete(file); } catch { }
    }
    // Write snapshot code to temp directory and compile it to assembly
    var assemblyName = ModelSnapshotFilePrefix + DateTime.UtcNow.Ticks;
    var codePath = Path.Combine(tempPath, assemblyName + ".cs");
    var assemblyPath = Path.Combine(tempPath, assemblyName + ".dll");
    var compileService = Application.Ioc.Resolve<ICompilerService>();
    var assemblyLoader = Application.Ioc.Resolve<IAssemblyLoader>();
    File.WriteAllText(codePath, lastMigration.Model);
    compileService.Compile(new[] { codePath }, assemblyName, assemblyPath);
    // Load assembly and create the snapshot instance
    var assembly = assemblyLoader.LoadFile(assemblyPath);
    var snapshot = (ModelSnapshot)Activator.CreateInstance(
        assembly.GetTypes().First(t =>
        typeof(ModelSnapshot).GetTypeInfo().IsAssignableFrom(t)));
    lastModel = snapshot.Model;
}

和近日的构造实行相比:

// Compare with the newest model
var modelDiffer = serviceProvider.GetService<IMigrationsModelDiffer>();
var sqlGenerator = serviceProvider.GetService<IMigrationsSqlGenerator>();
var commandExecutor = serviceProvider.GetService<IMigrationCommandExecutor>();
var operations = modelDiffer.GetDifferences(lastModel, context.Model);
if (operations.Count <= 0) {
    // There no difference
    return;
}

只要有出入,生成迁移命令(commands)和当下一体化结构的快速照相(modelSnapshot)。
地点Model中的代码由那里的CSharpMigrationsGenerator生成,modelSnapshot的品类是string

// There some difference, we need perform the migration
var commands = sqlGenerator.Generate(operations, context.Model);
var connection = serviceProvider.GetService<IRelationalConnection>();
// Take a snapshot to the newest model
var codeHelper = new CSharpHelper();
var generator = new CSharpMigrationsGenerator(
    codeHelper,
    new CSharpMigrationOperationGenerator(codeHelper),
    new CSharpSnapshotGenerator(codeHelper));
var modelSnapshot = generator.GenerateSnapshot(
    ModelSnapshotNamespace, context.GetType(),
    ModelSnapshotClassPrefix + DateTime.UtcNow.Ticks, context.Model);

插入迁移记录并推行迁移命令:

// Insert the history first, if migration failed, delete it
var history = new EFCoreMigrationHistory(modelSnapshot);
histories.Add(history);
context.SaveChanges();
try {
    // Execute migration commands
    commandExecutor.ExecuteNonQuery(commands, connection);
} catch {
    histories.Remove(history);
    context.SaveChanges();
    throw;
}

到此地就完事了Entity Framework
Core的电动员搬迁移,今后每一回有革新都会相比末了三遍迁移时的结构并进行更新。
Entity Framework Core的动迁特点和Entity
Framework壹样,能够保证很强的1致性但需求注意制止数据的丢失。

写入数据库

当今已开立了有Books表的数据库,也定义了模型和内外文类,然后能够用多少填充表。创立AddBookAsync方法将Book对象添加到数据库。首先,BooksContext对象被实例化,那里运用using语句确认保证数据库连接关闭。使用Add方法将对象添加到上下文之后,实体被写入调用SaveChangesAsync的数据库(代码文件BooksSample
/ Program.cs):

private async Task AddBookAsync(string title, string publisher)
{
  using (var context = new BooksContext())
  {
    var book = new Book
    {
      Title = title,
      Publisher = publisher
    };
    context.Add(book);
    int records = await context.SaveChangesAsync();

    WriteLine($"{records} record added");
  }
  WriteLine();
} 

要添加书籍列表,能够应用AddRange方法(代码文件Books萨姆ple
/ Program.cs):

private async Task AddBooksAsync()
{
  using (var context = new BooksContext())
  {
    var b1 = new Book
    {
      Title ="Professional C# 5 and .NET 4.5.1",
      Publisher ="Wrox Press"
    };
    var b2 = new Book
    {
      Title ="Professional C# 2012 and .NET 4.5",
      Publisher ="Wrox Press"
    };
    var b3 = new Book
    {
      Title ="JavaScript for Kids",
      Publisher ="Wrox Press"
    };
    var b4 = new Book
    {
      Title ="Web Design with HTML and CSS",
      Publisher ="For Dummies"
    };
    context.AddRange(b1, b2, b3, b4);
    int records = await context.SaveChangesAsync();
    WriteLine($"{records} records added");
  }
  WriteLine();
} 

 运转应用程序并调用那几个主意后,可以行使SQL
Server对象能源管理器查看写入到数据库的多少。

写入数据库

后天已创立了有Books表的数据库,也定义了模型和上下文类,然后能够用多少填充表。创设AddBookAsync方法将Book对象添加到数据库。首先,BooksContext对象被实例化,这里运用using语句确定保证数据库连接关闭。使用Add方法将对象添加到上下文之后,实体被写入调用SaveChangesAsync的数据库(代码文件Books山姆ple
/ Program.cs):

private async Task AddBookAsync(string title, string publisher)
{
  using (var context = new BooksContext())
  {
    var book = new Book
    {
      Title = title,
      Publisher = publisher
    };
    context.Add(book);
    int records = await context.SaveChangesAsync();

    WriteLine($"{records} record added");
  }
  WriteLine();
} 

要添加书籍列表,能够动用AddRange方法(代码文件BooksSample
/ Program.cs):

private async Task AddBooksAsync()
{
  using (var context = new BooksContext())
  {
    var b1 = new Book
    {
      Title ="Professional C# 5 and .NET 4.5.1",
      Publisher ="Wrox Press"
    };
    var b2 = new Book
    {
      Title ="Professional C# 2012 and .NET 4.5",
      Publisher ="Wrox Press"
    };
    var b3 = new Book
    {
      Title ="JavaScript for Kids",
      Publisher ="Wrox Press"
    };
    var b4 = new Book
    {
      Title ="Web Design with HTML and CSS",
      Publisher ="For Dummies"
    };
    context.AddRange(b1, b2, b3, b4);
    int records = await context.SaveChangesAsync();
    WriteLine($"{records} records added");
  }
  WriteLine();
} 

 运营应用程序并调用这么些主意后,能够利用SQL
Server对象财富管理器查看写入到数据库的多少。

写在最后

机关迁移数据库假设没有错运用,能够升高项目中相继模块的独立性,减少开销和安插的工作量。
而是因为不可能手动控制搬迁内容,有肯定的受制和惊险,需求明白好应用的O大切诺基M迁移的脾性。

写在最终

机关迁移数据库如若没有错行使,能够增长项目中相继模块的独立性,减弱开支和安插的工作量。
然则因为无法手动控制搬迁内容,有早晚的受制和产品险,要求掌握好应用的O奥德赛M迁移的性状。

从数据库读取

从C#代码读取数据只必要调用BooksContext并走访Books属性。访问此属性会成立3个SQL语句从数据库中追寻全部图书(代码文件BooksSample
/ Program.cs):

private void ReadBooks()
{
  using (var context = new BooksContext())
  {
    var books = context.Books;
    foreach (var b in books)
    {
      WriteLine($"{b.Title} {b.Publisher}");
    }
  }
  WriteLine();
}

在调节时期打开
英特尔liTrace Events窗口,能够看到发送到数据库的SQL语句(须求Visual
Studio 集团版):

SELECT [b].[BookId], [b].[Publisher], [b].[Title]
FROM [Books] AS [b]

Framework提供了八个LINQ提供程序,可以创设LINQ查询访问数据库。能够利用如下所示语法的措施:

private void QueryBooks()
{
  using (var context = new BooksContext())
  {
    var wroxBooks = context.Books.Where(b => b.Publisher =="Wrox Press");
    foreach (var b in wroxBooks)
    {
      WriteLine($"{b.Title} {b.Publisher}");
    }
  }
  WriteLine();
}

或行使LINQ查询语法:

var wroxBooks = from b in context.Books
                where b.Publisher =="Wrox Press"
                select b;

动用那三种差异的语法,都将发送上边包车型大巴SQL语句到数据库:

SELECT [b].[BookId], [b].[Publisher], [b].[Title]
FROM [Books] AS [b]
WHERE [b].[Publisher] = 'Wrox Press'

*注意 在第叁三章“语言集成查询”中详细谈论了LINQ。
*

从数据库读取

从C#代码读取数据只供给调用BooksContext并访问Books属性。访问此属性会创制多少个SQL语句从数据库中找寻全数图书(代码文件BooksSample
/ Program.cs):

private void ReadBooks()
{
  using (var context = new BooksContext())
  {
    var books = context.Books;
    foreach (var b in books)
    {
      WriteLine($"{b.Title} {b.Publisher}");
    }
  }
  WriteLine();
}

在调节和测试时期打开
英特尔liTrace 伊夫nts窗口,能够见见发送到数据库的SQL语句(必要Visual
Studio 集团版):

SELECT [b].[BookId], [b].[Publisher], [b].[Title]
FROM [Books] AS [b]

Framework提供了八个LINQ提供程序,能够创制LINQ查询访问数据库。能够利用如下所示语法的方式:

private void QueryBooks()
{
  using (var context = new BooksContext())
  {
    var wroxBooks = context.Books.Where(b => b.Publisher =="Wrox Press");
    foreach (var b in wroxBooks)
    {
      WriteLine($"{b.Title} {b.Publisher}");
    }
  }
  WriteLine();
}

或采纳LINQ查询语法:

var wroxBooks = from b in context.Books
                where b.Publisher =="Wrox Press"
                select b;

采用那三种分歧的语法,都将发送上边包车型地铁SQL语句到数据库:

SELECT [b].[BookId], [b].[Publisher], [b].[Title]
FROM [Books] AS [b]
WHERE [b].[Publisher] = 'Wrox Press'

*注意 在第三三章“语言集成查询”中详尽谈论了LINQ。
*

写在最后的广告

ZKWeb网页框架一度在事实上项目中应用了那项技艺,近来来看迁移部分仍然比较稳定的。
那项技术最初是为着插件商城而付出的,在下载安装插件今后不须要再行编写翻译主程序,不供给执行另外迁移命令就能动用。
方今即使未有实现插件商城,也收缩了过多见惯不惊支付的干活。

若果您有趣味,欢迎参加ZKWeb调换群522083886壹起探索。

写在最后的广告

ZKWeb网页框架壹度在实际上项目中动用了那项技术,方今来看迁移部分依然相比稳定的。
那项技能最初是为了插件商城而开发的,在下载安装插件未来不须要再行编写翻译主程序,不须求实施其它迁移命令就能选择。
近日纵然从未兑现插件商城,也缩减了累累普普通通费用的行事。

假使你有趣味,欢迎到场ZKWeb交换群5220838八陆壹并研商。

立异记录

只需变更已加载上下文的指标并调用SaveChangesAsync即可轻松完成创新记录(代码文件BooksSample
/ Program.cs):

private async Task UpdateBookAsync()
{
  using (var context = new BooksContext())
  {
    int records = 0;
    var book = context.Books.Where(b => b.Title =="Professional C# 6")
      .FirstOrDefault();
    if (book != null)
    {
      book.Title ="Professional C# 6 and .NET Core 5";
      records = await context.SaveChangesAsync();
    }
    WriteLine($"{records} record updated");
  }
  WriteLine();
}

创新记录

只需改变已加载上下文的目标并调用SaveChangesAsync即可轻松达成革新记录(代码文件BooksSample
/ Program.cs):

private async Task UpdateBookAsync()
{
  using (var context = new BooksContext())
  {
    int records = 0;
    var book = context.Books.Where(b => b.Title =="Professional C# 6")
      .FirstOrDefault();
    if (book != null)
    {
      book.Title ="Professional C# 6 and .NET Core 5";
      records = await context.SaveChangesAsync();
    }
    WriteLine($"{records} record updated");
  }
  WriteLine();
}

删除记录

最后,让我们清理数据库并删除全部记录。能够通过搜索全部记录并调用Remove或RemoveRange方法来安装上下文中要删减的靶子的状态。然后调用SaveChangesAsync方法即可从数据库中除去记录,DbContext会为种种要刨除的目的调用SQL
Delete语句(代码文件BooksSample / Program.cs):

private async Task DeleteBooksAsync()
{
  using (var context = new BooksContext())
  {
    var books = context.Books;
    context.Books.RemoveRange(books);
    int records = await context.SaveChangesAsync();
    WriteLine($"{records} records deleted");
  }
  WriteLine();
}

*注意 指标关系映射工具(如Entity
Framework)在毫不在全部方案中都可用。使用示例代码不能够有效地删除全体指标。您能够运用一个SQL语句删除全数而不是逐条删除笔录。在第三柒章“ADO.NET”中解释了怎么形成那一点。*

刺探了什么添加、查询、更新和删除记录,本章将介绍幕后的功用,并动用Entity
Framework进入高档场景。

删去记录

终极,让我们清理数据库并剔除全数记录。能够经过搜寻全数记录并调用Remove或RemoveRange方法来设置上下文中要刨除的指标的意况。然后调用SaveChangesAsync方法即可从数据库中去除记录,DbContext会为每一种要去除的对象调用SQL
Delete语句(代码文件BooksSample / Program.cs):

private async Task DeleteBooksAsync()
{
  using (var context = new BooksContext())
  {
    var books = context.Books;
    context.Books.RemoveRange(books);
    int records = await context.SaveChangesAsync();
    WriteLine($"{records} records deleted");
  }
  WriteLine();
}

*注意 对象关联映射工具(如Entity
Framework)在并非在享有方案中都可用。使用示例代码无法有效地删除全体目的。您能够应用八个SQL语句删除全部而不是逐条删除记录。在第一柒章“ADO.NET”中表明了哪些形成那或多或少。*

打探了怎么着添加、查询、更新和删除记录,本章将介绍幕后的功用,并选拔Entity
Framework进入高档场景。

行使注重注入  

Entity
Framework Core 一.0放置了对借助注入的支撑。连接和SQL
Server选拔能够透过利用信赖注入框架注入,而非定义和接下来选拔DbContext派生类的SQL
Server连接。 

要翻开此操作,BooksSampleWithDI示例项目对上三个代码示例项目展开了改动。 

此示例使用以下依赖项和命名空间:

  依赖项

NETStandard.Library
Microsoft.EntityFrameworkCore
Microsoft.EntityFrameworkCore.SqlServer
Microsoft.Framework.DependencyInjection 

  命名空间

Microsoft.EntityFrameworkCore
System.Linq
System.Threading.Tasks
static System.Console

BooksContext类将来看起来很简短,只需定义Books属性(代码文件Books萨姆pleWithDI
/ BooksContext.cs):

public class BooksContext: DbContext
{
  public DbSet<Book> Books { get; set; }
}

BooksService是应用BooksContext的新类。BooksContext通过注入构造函数注入。方法AddBooksAsync和ReadBooks与上二个示范中的这么些主意十一分相似,但她们选拔Books瑟维斯类的上下文成员,而不是创办2个新的(代码文件Books萨姆pleWithDI
/ BooksService.cs):

public class BooksService
{
  private readonly BooksContext _booksContext;
  public BooksService(BooksContext context)
  {
    _booksContext = context;
  }

  public async Task AddBooksAsync()
  {
    var b1 = new Book
    {
      Title ="Professional C# 5 and .NET 4.5.1",
      Publisher ="Wrox Press"
    };
    var b2 = new Book
    {
      Title ="Professional C# 2012 and .NET 4.5",
      Publisher ="Wrox Press"
    };
    var b3 = new Book
    {
      Title ="JavaScript for Kids",
      Publisher ="Wrox Press"
    };
    var b4 = new Book
    {
      Title ="Web Design with HTML and CSS",
      Publisher ="For Dummies"
    };
    _booksContext.AddRange(b1, b2, b3, b4);
    int records = await _booksContext.SaveChangesAsync();

    WriteLine($"{records} records added");
  }

  public void ReadBooks()
  {
    var books = _booksContext.Books;
    foreach (var b in books)
    {
      WriteLine($"{b.Title} {b.Publisher}");
    }
    WriteLine();
  }
} 

依傍注入框架的器皿在
InitializeServices
方法中伊始化。成立贰个ServiceCollection实例,将Books瑟维斯类添加到此聚众中,并拓展临时生命周期管理。那样,每一趟请求该服务时都会实例化
ServiceCollection。对于注册Entity Framework和SQL
Server,能够用扩大方法AddEntityFramework,AddSqlServer和AddDbContext。
AddDbContext方法需求1个Action委托作为参数,个中接收到二个DbContextOptionsBuilder参数。有了该选项参数,能够运用UseSqlServer扩张方法配置上下文。那里用Entity
Framework注册SQL
Server与上一个演示是看似的意义(代码文件BooksSampleWithDI /
Program.cs):

private void InitializeServices()
{
  const string ConnectionString =@"server= (localdb)\MSSQLLocalDb;database=Books;trusted_connection=true";
  var services = new ServiceCollection();
  services.AddTransient<BooksService>();
  services.AddEntityFramework()
    .AddSqlServer()
    .AddDbContext<BooksContext>(options =>
      options.UseSqlServer(ConnectionString));
  Container = services.BuildServiceProvider();
}

public IServiceProvider Container { get; private set; }

劳动的开始化以及BooksService的接纳是从Main方法成功的。通过调用I瑟维斯Provider的GetService方法来寻找BooksService(代码文件BooksSampleWithDI
/ Program.cs):

static void Main()
{
  var p = new Program();
  p.InitializeServices();

  var service = p.Container.GetService<BooksService>();
  service.AddBooksAsync().Wait();
  service.ReadBooks();
}

运作应用程序能够看到记录已添加到图书数据库中然后从中读取记录。

*注意
在第二1章“XAML应用程序的形式”中读书有关依赖注入和Microsoft.Framework.DependencyInjection包的更加多新闻,还是能够瞻仰第五0章“ASP.NET
Core”和第六一章“ ASP.NET MVC“。*

应用重视注入  

Entity
Framework Core 一.0放手了对重视注入的支撑。连接和SQL
Server采用能够经过动用注重注入框架注入,而非定义和接下来选取DbContext派生类的SQL
Server连接。 

要翻开此操作,Books萨姆pleWithDI示例项目对上八个代码示例项目展开了改动。 

此示例使用以下依赖项和命名空间:

  依赖项

NETStandard.Library
Microsoft.EntityFrameworkCore
Microsoft.EntityFrameworkCore.SqlServer
Microsoft.Framework.DependencyInjection 

  命名空间

Microsoft.EntityFrameworkCore
System.Linq
System.Threading.Tasks
static System.Console

BooksContext类现在看起来很简短,只需定义Books属性(代码文件BooksSampleWithDI
/ BooksContext.cs):

public class BooksContext: DbContext
{
  public DbSet<Book> Books { get; set; }
}

BooksService是选用BooksContext的新类。BooksContext通过注入构造函数注入。方法AddBooksAsync和ReadBooks与上二个示范中的这几个办法足够相像,但她们采取BooksService类的上下文成员,而不是创办1个新的(代码文件Books萨姆pleWithDI
/ BooksService.cs):

public class BooksService
{
  private readonly BooksContext _booksContext;
  public BooksService(BooksContext context)
  {
    _booksContext = context;
  }

  public async Task AddBooksAsync()
  {
    var b1 = new Book
    {
      Title ="Professional C# 5 and .NET 4.5.1",
      Publisher ="Wrox Press"
    };
    var b2 = new Book
    {
      Title ="Professional C# 2012 and .NET 4.5",
      Publisher ="Wrox Press"
    };
    var b3 = new Book
    {
      Title ="JavaScript for Kids",
      Publisher ="Wrox Press"
    };
    var b4 = new Book
    {
      Title ="Web Design with HTML and CSS",
      Publisher ="For Dummies"
    };
    _booksContext.AddRange(b1, b2, b3, b4);
    int records = await _booksContext.SaveChangesAsync();

    WriteLine($"{records} records added");
  }

  public void ReadBooks()
  {
    var books = _booksContext.Books;
    foreach (var b in books)
    {
      WriteLine($"{b.Title} {b.Publisher}");
    }
    WriteLine();
  }
} 

依傍注入框架的器皿在
InitializeServices
方法中初步化。创制四个ServiceCollection实例,将BooksService类添加到此聚众中,并拓展一时半刻生命周期管理。那样,每一次请求该服务时都会实例化
ServiceCollection。对于注册Entity Framework和SQL
Server,能够用扩大方法AddEntityFramework,AddSqlServer和AddDbContext。
AddDbContext方法需求一个Action委托作为参数,在那之中接收到三个DbContextOptionsBuilder参数。有了该选项参数,能够使用UseSqlServer扩展方法配置上下文。那里用Entity
Framework注册SQL
Server与上3个演示是接近的功用(代码文件Books萨姆pleWithDI /
Program.cs):

private void InitializeServices()
{
  const string ConnectionString =@"server= (localdb)\MSSQLLocalDb;database=Books;trusted_connection=true";
  var services = new ServiceCollection();
  services.AddTransient<BooksService>();
  services.AddEntityFramework()
    .AddSqlServer()
    .AddDbContext<BooksContext>(options =>
      options.UseSqlServer(ConnectionString));
  Container = services.BuildServiceProvider();
}

public IServiceProvider Container { get; private set; }

劳动的伊始化以及BooksService的采用是从Main方法成功的。通过调用IServiceProvider的GetService方法来寻觅BooksService(代码文件BooksSampleWithDI
/ Program.cs):

static void Main()
{
  var p = new Program();
  p.InitializeServices();

  var service = p.Container.GetService<BooksService>();
  service.AddBooksAsync().Wait();
  service.ReadBooks();
}

运作应用程序能够观察记录已添加到图书数据库中然后从中读取记录。

*注意
在第壹一章“XAML应用程序的方式”中读书有关注重注入和Microsoft.Framework.DependencyInjection包的更加多消息,仍是可以够瞻仰第伍0章“ASP.NET
Core”和第陆一章“ ASP.NET MVC“。*

创办模型  

本章的首先个示例映射单个表。第四个例证展现了创造表之间的关系。在本节中利用C#代码创设数据库而并未有选取SQL
DDL语句(或透过选拔设计器)创设数据库。 

演示应用程序MenusSample使用以下正视项和命名空间:

  依赖项

NETStandard.Library
Microsoft.EntityFrameworkCore
Microsoft.EntityFrameworkCore.SqlServer

  命名空间

Microsoft.EntityFrameworkCore
Microsoft.EntityFrameworkCore.ChangeTracking
System
System.Collections.Generic
System.ComponentModel.DataAnnotations
System.ComponentModel.DataAnnotations.Schema
System.Linq
System.Threading
System.Threading.Tasks
static System.Console

开创模型  

本章的首先个示例映射单个表。第叁个例证展现了创设表之间的关系。在本节中动用C#代码成立数据库而从不选取SQL
DDL语句(或透过选取设计器)创设数据库。 

演示应用程序MenusSample使用以下注重项和命名空间:

  依赖项

NETStandard.Library
Microsoft.EntityFrameworkCore
Microsoft.EntityFrameworkCore.SqlServer

  命名空间

Microsoft.EntityFrameworkCore
Microsoft.EntityFrameworkCore.ChangeTracking
System
System.Collections.Generic
System.ComponentModel.DataAnnotations
System.ComponentModel.DataAnnotations.Schema
System.Linq
System.Threading
System.Threading.Tasks
static System.Console

始建关系

让大家开端创设叁个模子。示例项目采纳MenuCard和Menu类型定义1对多涉及。MenuCard包括Menu对象的列表。那种关系由List
<Menu>类型的Menu属性简单定义(代码文件MenusSample /
MenuCard.cs):

public class MenuCard
{
  public int MenuCardId { get; set; }
  public string Title { get; set; }
  public List<Menu> Menus { get; } = new List<Menu>();

  public override string ToString() => Title;
}

该关系也得以从另二个角度访问,菜单能够应用MenuCard属性访问Menu卡德。钦定MenuCardId 属性去定义外键关系(代码文件MenusSample / Menu.cs):

public class Menu
{
  public int MenuId { get; set; }
  public string Text { get; set; }
  public decimal Price { get; set; }

  public int MenuCardId { get; set; }
  public MenuCard MenuCard { get; set; }

  public override string ToString() => Text;
}

到数据库的照耀由MenusContext类完结。这些类定义为与上贰个内外文类型类似的连串,它只包涵几个天性来映射多少个目的类型:属性Menus和MenuCards(代码文件MenusSamples
/ MenusContext.cs):

public class MenusContext: DbContext
{
  private const string ConnectionString = @"server=(localdb)\MSSQLLocalDb;" +     "Database=MenuCards;Trusted_Connection=True";
  public DbSet<Menu> Menus { get; set; }
  public DbSet<MenuCard> MenuCards { get; set; }

  protected override void OnConfiguring(DbContextOptionsBuilder  optionsBuilder)
  {
    base.OnConfiguring(optionsBuilder);
    optionsBuilder.UseSqlServer(ConnectionString);
  }
}

成立关系

让大家开首创设一个模子。示例项目应用MenuCard和Menu类型定义1对多关系。MenuCard包罗Menu对象的列表。那种关涉由List
<Menu>类型的Menu属性简单定义(代码文件MenusSample /
MenuCard.cs):

public class MenuCard
{
  public int MenuCardId { get; set; }
  public string Title { get; set; }
  public List<Menu> Menus { get; } = new List<Menu>();

  public override string ToString() => Title;
}

该关系也足以从另2个角度访问,菜单可以选用MenuCard属性访问MenuCard。钦命MenuCardId 属性去定义外键关系(代码文件Menus萨姆ple / Menu.cs):

public class Menu
{
  public int MenuId { get; set; }
  public string Text { get; set; }
  public decimal Price { get; set; }

  public int MenuCardId { get; set; }
  public MenuCard MenuCard { get; set; }

  public override string ToString() => Text;
}

到数据库的映射由MenusContext类达成。那个类定义为与上三个左右文类型类似的门类,它只包涵两天个性来映射四个目的类型:属性Menus和MenuCards(代码文件MenusSamples
/ MenusContext.cs):

public class MenusContext: DbContext
{
  private const string ConnectionString = @"server=(localdb)\MSSQLLocalDb;" +     "Database=MenuCards;Trusted_Connection=True";
  public DbSet<Menu> Menus { get; set; }
  public DbSet<MenuCard> MenuCards { get; set; }

  protected override void OnConfiguring(DbContextOptionsBuilder  optionsBuilder)
  {
    base.OnConfiguring(optionsBuilder);
    optionsBuilder.UseSqlServer(ConnectionString);
  }
}

使用.NET CLI举行搬迁

要使用C#代码自动创造数据库,能够采纳enet工具使用package
dotnet-ef增添.NET
CLI工具。此软件手包含用于为搬迁创制C#代码的下令。通过设置dotnet-ef
NuGet包能够职务令可用。您能够透过从体系配置文件(代码文件Menus萨姆ple /
project.json)中的工具部分引用此软件包来安装它:

"tools": {
  "dotnet-ef":"1.0.0-*"
 }

ef命令提供以下命令:数据库、dbcontext和迁移。数据库命令用于将数据库升级到一定的迁移情形。
dbcontext命令列出项目中的全数DbContext派生类型(dbcontext
list),并从数据库(dbcontext scaffold)创造上下文和实体。
migrations命令则开创和删除迁移,以及开创SQL脚本去成立包罗全体迁移的数据库。假设生产数据库只可以从SQL管理员使用SQL代码创立和改动,能够将扭转的台本移交给SQL管理员。 

为了创造起来迁移以从代码制造数据库,能够从开发职员命令提醒符调用以下命令,该命令制造名字为InitMenuCards的迁移:

>dotnet ef migrations add InitMenuCards

命令migrations
add使用反射以及相反的引用模型访问DbContext派生类。此音信创立多少个类来创立和创新数据库。使用Menu,MenuCard和MenusContext类成立五个类,MenusContextModelSnapshot和InitMenuCards。命令成功后得以在Migrations文件夹中找到这两体系型。

MenusContextModelSnapshot类包括营造数据库的模型的当前情景:

[DbContext(typeof(MenusContext))]
partial class MenusContextModelSnapshot: ModelSnapshot
{
  protected override void BuildModel(ModelBuilder modelBuilder)
  {
    modelBuilder
     .HasAnnotation("ProductVersion","7.0.0-rc1-16348")
     .HasAnnotation("SqlServer:ValueGenerationStrategy",
       SqlServerValueGenerationStrategy.IdentityColumn);

     modelBuilder.Entity("MenusSample.Menu", b =>
     {
       b.Property<int>("MenuId")
        .ValueGeneratedOnAdd();
       b.Property<int>("MenuCardId");
       b.Property<decimal>("Price");
       b.Property<string>("Text");
       b.HasKey("MenuId");
     });

     modelBuilder.Entity("MenusSample.MenuCard", b =>
     {
       b.Property<int>("MenuCardId")
        .ValueGeneratedOnAdd();

       b.Property<string>("Title");
       b.HasKey("MenuCardId");
     });
     modelBuilder.Entity("MenusSample.Menu", b =>
     {
       b.HasOne("MenusSample.MenuCard")
        .WithMany()
        .HasForeignKey("MenuCardId");
     });
  }
}

InitMenuCards类定义了Up和Down方法。
Up方法列出了创造MenuCard和菜单表所需的保有操作,包涵主键、列和事关。
Down方法删除五个表:

public partial class InitMenuCards: Migration
{
  protected override void Up(MigrationBuilder migrationBuilder)
  {
    migrationBuilder.CreateTable(
      name:"MenuCard",
      columns: table => new
      {
        MenuCardId = table.Column<int>(nullable: false)
          .Annotation("SqlServer:ValueGenerationStrategy",
            SqlServerValueGenerationStrategy.IdentityColumn),
        Title = table.Column<string>(nullable: true)
      },
      constraints: table =>
      {
        table.PrimaryKey("PK_MenuCard", x => x.MenuCardId);
      });

    migrationBuilder.CreateTable(
      name:"Menu",
      columns: table => new
      {
        MenuId = table.Column<int>(nullable: false)
          .Annotation("SqlServer:ValueGenerationStrategy",
            SqlServerValueGenerationStrategy.IdentityColumn),
        MenuCardId = table.Column<int>(nullable: false),
        Price = table.Column<decimal>(nullable: false),
        Text = table.Column<string>(nullable: true)
      },
      constraints: table =>
      {
        table.PrimaryKey("PK_Menu", x => x.MenuId);
        table.ForeignKey(
          name:"FK_Menu_MenuCard_MenuCardId",
          column: x => x.MenuCardId,
          principalTable:"MenuCard",
          principalColumn:"MenuCardId",
          onDelete: ReferentialAction.Cascade);
      });
  }

  protected override void Down(MigrationBuilder migrationBuilder)
  {
    migrationBuilder.DropTable("Menu");
    migrationBuilder.DropTable("MenuCard");
  }
}

注意 正在拓展的各种更改都能够创设另一个搬迁。新搬迁仅定义从原先版本到新本子所需的改变。要是客户的数据库需求从随机早期的本子更新,迁移数据库时调用供给的搬迁。 

在开发进程中,也行不须要具备的动员搬迁,可能供给从品种中开创,因为大概未有该类暂且气象的数据仓库储存在。在这种情况下能够去除迁移并创办1个较大的新搬迁。

使用.NET CLI进行搬迁

要利用C#代码自动创制数据库,能够利用enet工具使用package
dotnet-ef扩充.NET
CLI工具。此软件包包含用于为搬迁成立C#代码的吩咐。通过安装dotnet-ef
NuGet包能够义务令可用。您能够经过从类型布署文件(代码文件Menus萨姆ple /
project.json)中的工具部分引用此软件包来设置它:

"tools": {
  "dotnet-ef":"1.0.0-*"
 }

ef命令提供以下命令:数据库、dbcontext和迁移。数据库命令用于将数据库升级到一定的动员搬迁景况。
dbcontext命令列出项目中的全体DbContext派生类型(dbcontext
list),并从数据库(dbcontext scaffold)创造上下文和实业。
migrations命令则创立和删除迁移,以及开创SQL脚本去创设包罗全部迁移的数据库。假诺生产数据库只好从SQL管理员使用SQL代码创设和修改,可以将转移的剧本移交给SQL管理员。 

为了成立起来迁移以从代码创立数据库,能够从开发人士命令提醒符调用以下命令,该命令创制名称叫InitMenuCards的动员搬迁:

>dotnet ef migrations add InitMenuCards

指令migrations
add使用反射以及相反的引用模型访问DbContext派生类。此音信创立三个类来创建和翻新数据库。使用Menu,MenuCard和MenusContext类创制八个类,MenusContextModelSnapshot和InitMenuCards。命令成功后得以在Migrations文件夹中找到那三种档次。

MenusContextModelSnapshot类包罗创设数据库的模型的当下景况:

[DbContext(typeof(MenusContext))]
partial class MenusContextModelSnapshot: ModelSnapshot
{
  protected override void BuildModel(ModelBuilder modelBuilder)
  {
    modelBuilder
     .HasAnnotation("ProductVersion","7.0.0-rc1-16348")
     .HasAnnotation("SqlServer:ValueGenerationStrategy",
       SqlServerValueGenerationStrategy.IdentityColumn);

     modelBuilder.Entity("MenusSample.Menu", b =>
     {
       b.Property<int>("MenuId")
        .ValueGeneratedOnAdd();
       b.Property<int>("MenuCardId");
       b.Property<decimal>("Price");
       b.Property<string>("Text");
       b.HasKey("MenuId");
     });

     modelBuilder.Entity("MenusSample.MenuCard", b =>
     {
       b.Property<int>("MenuCardId")
        .ValueGeneratedOnAdd();

       b.Property<string>("Title");
       b.HasKey("MenuCardId");
     });
     modelBuilder.Entity("MenusSample.Menu", b =>
     {
       b.HasOne("MenusSample.MenuCard")
        .WithMany()
        .HasForeignKey("MenuCardId");
     });
  }
}

InitMenuCards类定义了Up和Down方法。
Up方法列出了创办MenuCard和菜单表所需的持有操作,包涵主键、列和关联。
Down方法删除八个表:

public partial class InitMenuCards: Migration
{
  protected override void Up(MigrationBuilder migrationBuilder)
  {
    migrationBuilder.CreateTable(
      name:"MenuCard",
      columns: table => new
      {
        MenuCardId = table.Column<int>(nullable: false)
          .Annotation("SqlServer:ValueGenerationStrategy",
            SqlServerValueGenerationStrategy.IdentityColumn),
        Title = table.Column<string>(nullable: true)
      },
      constraints: table =>
      {
        table.PrimaryKey("PK_MenuCard", x => x.MenuCardId);
      });

    migrationBuilder.CreateTable(
      name:"Menu",
      columns: table => new
      {
        MenuId = table.Column<int>(nullable: false)
          .Annotation("SqlServer:ValueGenerationStrategy",
            SqlServerValueGenerationStrategy.IdentityColumn),
        MenuCardId = table.Column<int>(nullable: false),
        Price = table.Column<decimal>(nullable: false),
        Text = table.Column<string>(nullable: true)
      },
      constraints: table =>
      {
        table.PrimaryKey("PK_Menu", x => x.MenuId);
        table.ForeignKey(
          name:"FK_Menu_MenuCard_MenuCardId",
          column: x => x.MenuCardId,
          principalTable:"MenuCard",
          principalColumn:"MenuCardId",
          onDelete: ReferentialAction.Cascade);
      });
  }

  protected override void Down(MigrationBuilder migrationBuilder)
  {
    migrationBuilder.DropTable("Menu");
    migrationBuilder.DropTable("MenuCard");
  }
}

注意 正在进展的每一个更改都得以创建另三个搬迁。新搬迁仅定义从原先版本到新本子所需的变动。假设客户的数据库供给从随机早期的版本更新,迁移数据库时调用须求的迁徙。 

在支付进度中,也行不需求持有的搬迁,也许要求从品类中创设,因为大概没有该类一时气象的数据仓库储存在。在那种情景下得以去除迁移并创制1个较大的新搬迁。

使用MSBuild进行搬迁  

比方你正在使用基于MSBuild的项目Entity
Framework迁移而不是DNX,迁移命令是见仁见智的。使用完整框架控制台应用程序、WPF应用程序或ASP.NET
4.陆档次项目,要求在NuGet包管理器控制斯特拉斯堡钦点迁移命令,而不是开发人士命令提醒符。从Visual
Studio通过 工具➪库管理器控制台➪包管理器控制台
运行包管理器控制台。

在包管理器控制台可以行使PowerShell脚本添加和删除迁移。命令如下

> Add-Migration InitMenuCards

创设一个Migrations文件夹,当中包罗如前所示的迁移类。

制造数据库 

随着迁移类型形成,能够创造数据库。
DbContext派生类MenusContext包涵多少个重返DatabaseFacade对象的Database属性。使用DatabaseFacade能够创制和删除数据库。借使数据库不存在,EnsureCreated方法会创造数据库;若是数据库已存在,则不实施别的操作。方法EnsureDeletedAsync删除数据库。以下代码片段制造数据库(假使它不设有)(代码文件MenusSample
/ Program.cs):

private static async Task CreateDatabaseAsync()
{
  using (var context = new MenusContext())
  {
bool created = await context.Database.EnsureCreatedAsync();
    string createdText = created ?"created":"already exists";
    WriteLine($"database {createdText}");
  }
}

注意 假定数据仓库储存在不过一个较旧的社团版本,EnsureCreatedAsync方法不会利用结构改变。这时能够通过调用Migrate方法来开始展览组织升级。
Migrate是Microsoft.Data.Entity命名空间中定义的DatabaseFacade类的恢弘方法。

运营程序将创立表MenuCard和Menu。基于暗中同意约定,表与实业类型是均等的称谓。另三个约定用于创立主键:MenuCardId列会被定义为主键,因为属性名以Id结束。

CREATE TABLE [dbo].[MenuCard] (
  [MenuCardId] INT            IDENTITY (1, 1) NOT NULL,
  [Title]      NVARCHAR (MAX) NULL,
  CONSTRAINT [PK_MenuCard] PRIMARY KEY CLUSTERED ([MenuCardId] ASC)
);

Menu表定义了Menu卡德Id,它是MenuCard表的外键。由于DELETE
CASCADE,删除MenuCard也会去除全数涉及的Menu行:

CREATE TABLE [dbo].[Menu] (
  [MenuId]     INT             IDENTITY (1, 1) NOT NULL,
  [MenuCardId] INT             NOT NULL,
  [Price]      DECIMAL (18, 2) NOT NULL,
  [Text]       NVARCHAR (MAX)  NULL,
  CONSTRAINT [PK_Menu] PRIMARY KEY CLUSTERED ([MenuId] ASC),
  CONSTRAINT [FK_Menu_MenuCard_MenuCardId] FOREIGN KEY ([MenuCardId])
  REFERENCES [dbo].[MenuCard] ([MenuCardId]) ON DELETE CASCADE
);

在创造代码中有局地有些改变是行得通的。例如,Text
和 Title 列的分寸能够从NVAOdysseyCHA普拉多(MAX)减小,SQL
Server定义了可用来Price列的Money类型,并且协会名称能够从dbo更改。 Entity
Framework提供了多少个选项从代码中实施这个改动:数据批注和Fluent
API,上边将商讨。

多少批注

影响生成的数据库的1种艺术是向实体类型丰盛数据注释。能够接纳Table属性更改表的名称。要改变结构名称,Table属性定义Schema属性。如若要为字符串类型内定不相同的尺寸,能够动用马克斯Length属性(代码文件MenusWithDataAnnotations
/ MenuCard.cs):

[Table("MenuCards", Schema ="mc")]
public class MenuCard
{
  public int MenuCardId { get; set; }
  [MaxLength(120)]
  public string Title { get; set; }
  public List<Menu> Menus { get; }
}

Menu类的Table和马克斯Length属性同样能够利用。使用Column属性更改SQL类型(代码文件MenusWithDataAnnotations
/ Menu.cs):

[Table("Menus", Schema ="mc")]
public class Menu
{
  public int MenuId { get; set; }
  [MaxLength(50)]
  public string Text { get; set; }
  [Column(TypeName ="Money")]
  public decimal Price { get; set; }
  public int MenuCardId { get; set; }
  public MenuCard MenuCard { get; set; }
}

动用迁移创制数据库后得以看到结构名称下表的新名称,以及Title、Text
和 Price 字段中已更改的数据类型:

CREATE TABLE [mc].[MenuCards] (
  [MenuCardId] INT            IDENTITY (1, 1) NOT NULL,
  [Title]      NVARCHAR (120) NULL,
  CONSTRAINT [PK_MenuCard] PRIMARY KEY CLUSTERED ([MenuCardId] ASC)
);

CREATE TABLE [mc].[Menus] (
  [MenuId]     INT           IDENTITY (1, 1) NOT NULL,
  [MenuCardId] INT           NOT NULL,
  [Price]      MONEY         NOT NULL,
  [Text]       NVARCHAR (50) NULL,
  CONSTRAINT [PK_Menu] PRIMARY KEY CLUSTERED ([MenuId] ASC),
  CONSTRAINT [FK_Menu_MenuCard_MenuCardId] FOREIGN KEY ([MenuCardId])
    REFERENCES [mc].[MenuCards] ([MenuCardId]) ON DELETE CASCADE
);

利用MSBuild进行搬迁  

假诺你正在使用基于MSBuild的项目Entity
Framework迁移而不是DNX,迁移命令是例外的。使用完整框架控制台应用程序、WPF应用程序或ASP.NET
四.陆类别项目,需求在NuGet包管理器控制埃德蒙顿钦点迁移命令,而不是开发人士命令提醒符。从Visual
Studio通过 工具➪库管理器控制台➪包管理器控制台
运维包管理器控制台。

在包管理器控制台可以选用PowerShell脚本添加和删除迁移。命令如下

> Add-Migration InitMenuCards

成立1个Migrations文件夹,在那之中蕴藏如前所示的迁移类。

创制数据库 

乘机迁移类型形成,能够创设数据库。
DbContext派生类MenusContext包罗2个回去DatabaseFacade对象的Database属性。使用DatabaseFacade能够创建和删除数据库。借使数据库不存在,EnsureCreated方法会创建数据库;假如数据库已存在,则不履行此外操作。方法EnsureDeletedAsync删除数据库。以下代码片段创立数据库(借使它不存在)(代码文件MenusSample
/ Program.cs):

private static async Task CreateDatabaseAsync()
{
  using (var context = new MenusContext())
  {
bool created = await context.Database.EnsureCreatedAsync();
    string createdText = created ?"created":"already exists";
    WriteLine($"database {createdText}");
  }
}

注意 设若数据库存在不过1个较旧的结构版本,EnsureCreatedAsync方法不会动用结构改变。那时能够经过调用Migrate方法来拓展示公布局升级。
Migrate是Microsoft.Data.Entity命名空间中定义的DatabaseFacade类的扩张方法。

运维程序将成立表MenuCard和Menu。基于私下认可约定,表与实体类型是千篇1律的称号。另八个约定用于创立主键:MenuCardId列会被定义为主键,因为属性名以Id甘休。

CREATE TABLE [dbo].[MenuCard] (
  [MenuCardId] INT            IDENTITY (1, 1) NOT NULL,
  [Title]      NVARCHAR (MAX) NULL,
  CONSTRAINT [PK_MenuCard] PRIMARY KEY CLUSTERED ([MenuCardId] ASC)
);

Menu表定义了MenuCardId,它是MenuCard表的外键。由于DELETE
CASCADE,删除Menu卡德也会去除全部涉及的Menu行:

CREATE TABLE [dbo].[Menu] (
  [MenuId]     INT             IDENTITY (1, 1) NOT NULL,
  [MenuCardId] INT             NOT NULL,
  [Price]      DECIMAL (18, 2) NOT NULL,
  [Text]       NVARCHAR (MAX)  NULL,
  CONSTRAINT [PK_Menu] PRIMARY KEY CLUSTERED ([MenuId] ASC),
  CONSTRAINT [FK_Menu_MenuCard_MenuCardId] FOREIGN KEY ([MenuCardId])
  REFERENCES [dbo].[MenuCard] ([MenuCardId]) ON DELETE CASCADE
);

在创立代码中有一部分局地改变是实惠的。例如,Text
和 Title 列的深浅能够从NVA路虎极光CHAENVISION(MAX)减小,SQL
Server定义了可用以Price列的Money类型,并且协会名称能够从dbo更改。 Entity
Framework提供了三个挑选从代码中履行这一个改变:数据批注和Fluent
API,上面将商讨。

数量批注

潜移默化生成的数据库的1种方法是向实体类型丰裕数据注释。能够行使Table属性更改表的称呼。要转移结构名称,Table属性定义Schema属性。若是要为字符串类型钦命分化的长短,能够选择马克斯Length属性(代码文件MenusWithDataAnnotations
/ MenuCard.cs):

[Table("MenuCards", Schema ="mc")]
public class MenuCard
{
  public int MenuCardId { get; set; }
  [MaxLength(120)]
  public string Title { get; set; }
  public List<Menu> Menus { get; }
}

Menu类的Table和马克斯Length属性同样能够运用。使用Column属性更改SQL类型(代码文件MenusWithDataAnnotations
/ Menu.cs):

[Table("Menus", Schema ="mc")]
public class Menu
{
  public int MenuId { get; set; }
  [MaxLength(50)]
  public string Text { get; set; }
  [Column(TypeName ="Money")]
  public decimal Price { get; set; }
  public int MenuCardId { get; set; }
  public MenuCard MenuCard { get; set; }
}

使用迁移成立数据库后方可见到结构名称下表的新名称,以及Title、Text
和 Price 字段中已更改的数据类型:

CREATE TABLE [mc].[MenuCards] (
  [MenuCardId] INT            IDENTITY (1, 1) NOT NULL,
  [Title]      NVARCHAR (120) NULL,
  CONSTRAINT [PK_MenuCard] PRIMARY KEY CLUSTERED ([MenuCardId] ASC)
);

CREATE TABLE [mc].[Menus] (
  [MenuId]     INT           IDENTITY (1, 1) NOT NULL,
  [MenuCardId] INT           NOT NULL,
  [Price]      MONEY         NOT NULL,
  [Text]       NVARCHAR (50) NULL,
  CONSTRAINT [PK_Menu] PRIMARY KEY CLUSTERED ([MenuId] ASC),
  CONSTRAINT [FK_Menu_MenuCard_MenuCardId] FOREIGN KEY ([MenuCardId])
    REFERENCES [mc].[MenuCards] ([MenuCardId]) ON DELETE CASCADE
);

Fluent API  

潜移默化创立的表的另1种艺术是使用Fluent
API中DbContext派生类的OnModelCreating方法。它的亮点是足以保持实体类型大约,而不添加其他性质,Fluent
API还提供了比采纳品质越多的选项。 

以下代码片段显示了BooksContext类重写OnModelCreating方法。作为参数接收的ModelBuilder类提供了有的办法,并定义了两种扩展方法。
HasDefaultSchema是里面一个恢宏方法,它将暗许结构接纳于当下有所种类的模子。
Entity方法重回五个EntityTypeBuilder,使你能够自定义实体,例如将其映射到一定的表名和定义键和目录(代码文件MenusSample
/ MenusContext.cs):

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
  base.OnModelCreating(modelBuilder);

  modelBuilder.HasDefaultSchema("mc");

  modelBuilder.Entity<MenuCard>()
    .ToTable("MenuCards")
    .HasKey(c => c.MenuCardId);

  // etc.

  modelBuilder.Entity<Menu>()
    .ToTable("Menus")
    .HasKey(m => m.MenuId);

  // etc.
}

EntityTypeBuilder定义了三个Property方法来安顿属性。
Property方法重回PropertyBuilder,能够依次配置具有最大尺寸值,须要的装置和SQL类型的性质,并内定是或不是应自动生成值(例如标识列):

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
  // etc.

  modelBuilder.Entity<MenuCard>()
    .Property<int>(c => c.MenuCardId)
    .ValueGeneratedOnAdd();

  modelBuilder.Entity<MenuCard>()
    .Property<string>(c => c.Title)
    .HasMaxLength(50);

  modelBuilder.Entity<Menu>()
    .Property<int>(m => m.MenuId)
    .ValueGeneratedOnAdd();

  modelBuilder.Entity<Menu>()
.Property<string>(m => m.Text)
    .HasMaxLength(120);

  modelBuilder.Entity<Menu>()
    .Property<decimal>(m => m.Price)
    .HasColumnType("Money");

  // etc.
} 

EntityTypeBuilder定义映射方法去定义1对多映射。HasMany
结合 WithOne 方法定义了多Menus 和1个Menu Card 的映射。
HasMany须求与WithOne链接,即HasOne方法要求一个带WithMany或WithOne的链。链接
HasOne 和
WithMany定义了一对多涉及,链接HasOne与WithOne定义了一定的涉嫌:

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
  // etc.

  modelBuilder.Entity<MenuCard>()
    .HasMany(c => c.Menus)
    .WithOne(m => m.MenuCard);
  modelBuilder.Entity<Menu>()
    .HasOne(m => m.MenuCard)
    .WithMany(c => c.Menus)
    .HasForeignKey(m => m.MenuCardId);
}

在OnModelCreating方法中开创映射之后方可创立如前所示的动员搬迁。

Fluent API  

潜移默化创立的表的另一种格局是选择Fluent
API中DbContext派生类的OnModelCreating方法。它的帮助和益处是足以保持实体类型大概,而不添加其他性质,Fluent
API还提供了比使用质量愈多的选项。 

以下代码片段呈现了BooksContext类重写OnModelCreating方法。作为参数接收的ModelBuilder类提供了1些方法,并定义了二种扩大方法。
HasDefaultSchema是内部二个扩张方法,它将暗许结构选拔于方今具备品类的模子。
Entity方法再次回到1个EntityTypeBuilder,使你能够自定义实体,例如将其映射到一定的表名和定义键和目录(代码文件Menus萨姆ple
/ MenusContext.cs):

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
  base.OnModelCreating(modelBuilder);

  modelBuilder.HasDefaultSchema("mc");

  modelBuilder.Entity<MenuCard>()
    .ToTable("MenuCards")
    .HasKey(c => c.MenuCardId);

  // etc.

  modelBuilder.Entity<Menu>()
    .ToTable("Menus")
    .HasKey(m => m.MenuId);

  // etc.
}

EntityTypeBuilder定义了一个Property方法来安顿属性。
Property方法再次来到PropertyBuilder,能够依次配置具有最大尺寸值,要求的安装和SQL类型的习性,并钦命是还是不是应自动生成值(例如标识列):

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
  // etc.

  modelBuilder.Entity<MenuCard>()
    .Property<int>(c => c.MenuCardId)
    .ValueGeneratedOnAdd();

  modelBuilder.Entity<MenuCard>()
    .Property<string>(c => c.Title)
    .HasMaxLength(50);

  modelBuilder.Entity<Menu>()
    .Property<int>(m => m.MenuId)
    .ValueGeneratedOnAdd();

  modelBuilder.Entity<Menu>()
.Property<string>(m => m.Text)
    .HasMaxLength(120);

  modelBuilder.Entity<Menu>()
    .Property<decimal>(m => m.Price)
    .HasColumnType("Money");

  // etc.
} 

EntityTypeBuilder定义映射方法去定义壹对多映射。HasMany
结合 WithOne 方法定义了多Menus 和二个Menu Card 的投射。
HasMany要求与WithOne链接,即HasOne方法须要三个带WithMany或WithOne的链。链接
HasOne 和
WithMany定义了壹对多关系,链接HasOne与WithOne定义了一定的涉及:

protected override void OnModelCreating(ModelBuilder modelBuilder)
{
  // etc.

  modelBuilder.Entity<MenuCard>()
    .HasMany(c => c.Menus)
    .WithOne(m => m.MenuCard);
  modelBuilder.Entity<Menu>()
    .HasOne(m => m.MenuCard)
    .WithMany(c => c.Menus)
    .HasForeignKey(m => m.MenuCardId);
}

在OnModelCreating方法中开创映射之后能够创立如前所示的迁徙。

从数据库创设模型  

从模型能够创设数据库,相反从数据库也得以成立模型。 

要从SQL
Server数据库执行此操作,除了别的包,还非得将NuGet包添加到DNX项目中,EntityFramework.MicrosoftSqlServer.Design。然后能够在开发人士命令提示符使用以下命令:

> dnx ef dbcontext scaffold 
"server=(localdb)\MSSQLLocalDb;database=SampleDatabase; trusted_connection=true""EntityFramework.MicrosoftSqlServer"

dbcontext命令能够从品类中列出DbContext对象,同时也开创DBContext对象。命令scaffold成立DbContext派生类以及模型类。
dnx ef dbcontext scaffold
必要四个需求的参数:数据库的连年字符串和接纳的提供程序。前边所示的口舌中,在SQL
Server(localdb)\
MSSQLLocalDb上访问数据库SampleDatabase。使用的提供程序是EntityFramework.MicrosoftSqlServer。这么些NuGet包以及拥有相同名称和设计后缀的NuGet包必须添加到项目中。 

运营此命令后,能够看看DbContext派生类以及变化的模型类型。暗许情形下,模型的安插利用fluent
API落成。不过也能够将其转移为使用提供-a选项的数目批注。还足以影响生成的上下文类名称以及出口目录。只需使用选取-h检查分化的可用选项。

 

—————-未完待续

从数据库成立模型  

从模型能够成立数据库,相反从数据库也得以创设模型。 

要从SQL
Server数据库执行此操作,除了别的包,还必须将NuGet包添加到DNX项目中,EntityFramework.MicrosoftSqlServer.Design。然后能够在开发职员命令提示符使用以下命令:

> dnx ef dbcontext scaffold 
"server=(localdb)\MSSQLLocalDb;database=SampleDatabase; trusted_connection=true""EntityFramework.MicrosoftSqlServer"

dbcontext命令能够从品种中列出DbContext对象,同时也创立DBContext对象。命令scaffold创制DbContext派生类以及模型类。
dnx ef dbcontext scaffold
须要三个须求的参数:数据库的接二连三字符串和行使的提供程序。后面所示的讲话中,在SQL
Server(localdb)\
MSSQLLocalDb上访问数据库萨姆pleDatabase。使用的提供程序是EntityFramework.MicrosoftSqlServer。那几个NuGet包以及独具相同名称和布置后缀的NuGet包必须添加到项目中。 

运作此命令后,能够见到DbContext派生类以及变化的模子类型。私下认可意况下,模型的布局利用fluent
API达成。可是也足以将其改变为运用提供-a选项的多少批注。还足以影响生成的前后文类名称以及出口目录。只需选择选用-h检查差别的可用选项。

 

—————-未完待续

发表评论

电子邮件地址不会被公开。 必填项已用*标注

网站地图xml地图
Copyright @ 2010-2019 美高梅手机版4858 版权所有