最近悟出来一个道理，在这儿分享给大家：学历代表你的过去，能力代表你的现在，学习代表你的将来。
十年河东十年河西，莫欺少年穷
学无止境，精益求精
标题叫EF CodeFirs 代码迁移、数据迁移。
那么：到底叫代码迁移还是数据迁移？我在网上看了大半天，怎么叫的都有，后来查了MSDN，MSDN上叫代码迁移。在此，我们也称之为代码迁移。
为什么有人将其称为数据迁移呢？可能是因为本节内容和操作数据库有关<增加一张表，删除一张表，增加一个表字段，删除一个表字段，修改一个表字段等>，所以网友称之为数据迁移
MSDN等权威结构为什么称之为代码迁移呢？可能是因为本节的内容通过我们熟知的C#代码就可以搞定，所以称之为代码迁移
嘻嘻，上边是我的猜测，人家可跳过
正文：
背景：我们为什么要使用代码迁移？
我们使用CodeFirst初始化数据库无非以下三种方式：
一、 每次运行都会创建新的数据库
Database.SetInitializer<XXXXXContext>(new DropCreateDatabaseAlways<XXXXXContext>());
二、只有第一次运行~才会创建新的数据库~默认的方式
Database.SetInitializer<XXXXXContext>(new CreateDatabaseIfNotExists<XXXXXContext>());
三、 修改模型后~运行~会创建新的数据库
Database.SetInitializer<XXXXXContext>(new DropCreateDatabaseIfModelChanges<XXXXXContext>());
不论我们使用哪种方式，当条件成立时，都会创建新的数据库，而创建新的数据库就意味着‘从头再来’
举个例子：如果您的团队开发的项目已经被客户使用，客户在实际的生产操作中已经创建了很多数据，如果，某一天客户更改需求，我们难不成要采用上述方式将数据库重建？一旦重建，客户之前的数据就会丢失，这是任何一个客户不能容忍的
为了解决这个问题，我们要引入代码迁移
在进行代码迁移之前，我们必须做好数据库备份工作，确保客户数据的安全性及完整性
现在我们引入数据迁移示例：
我们有以下模型类：
Student模型类
public class Student
{
[Key]
public int Id { get; set; }
[Required]
[StringLength(10)]
public string Name { get; set; }//姓名
[StringLength(2)]
public string Sex { get; set; }//性别
[Unique(ErrorMessage="学号不允许重复")]
[StringLength(18)]
public string StudentNum { get; set; }//学号
[StringLength(100)]
public string StudentAddress { get; set; }//地址
}
Course模型类
public class Course
{
[Key]
public int Id { get; set; }
[Required]
[StringLength(20)]
public string Name { get; set; }//课程名称 }
Score模型类
[Key]
public int Id { get; set; }
public int StudentScore { get; set; }//学生分数
public int StudentID { get; set; }//学生ID
public int CourseID { get; set; }//课程ID
public virtual Student Student { get; set; }//virtual关键字修饰，用于延迟加载 提高性能 只有显式调用时 才会加载 并可以代表一个Student对象 也就是 属性==对象
public virtual Course Course { get; set; }//virtual关键字修饰，用于延迟加载 提高性能 只有显式调用时 才会加载 并可以代表一个Course对象 也就是 属性==对象
StudentContext上下文
public class StudentContext : DbContext
{
public StudentContext()
: base("StudentContext")//指定连接字符串
{
}
public DbSet<Student> Students { get; set; }
public DbSet<Course> Courses { get; set; }
public DbSet<Score> Scores { get; set; }
/// <summary>
/// OnModelCreating方法中的modelBuilder.Conventions.Remove语句禁止表名称正在多元化。如果你不这样做，所生成的表将命名为Students、Courses和Enrollments。相反，表名称将是Student、Course和Enrollment。开发商不同意关于表名称应该多数。本教程使用的是单数形式，但重要的一点是，您可以选择哪个你更喜欢通过包括或省略这行代码的形式。
/// </summary>
/// <param name="modelBuilder"></param>
protected override void OnModelCreating(DbModelBuilder modelBuilder)
{
modelBuilder.Conventions.Remove<PluralizingTableNameConvention>();
}
}
现在客户提出如下需求：在确保数据完整性的情况下，添加一张学校表<字段：学校名称、学校地址，学校热线>及增加学生联系方式字段
首先，我们添加学校模型类：
public class School//新建一张学校表-----------------------------新建的表
{
[Key]
public int schoolId { get; set; }
[Required]
[StringLength(10)]
public string schoolName { get; set; }//学校名称
[StringLength(100)]
public string StudentAddress { get; set; }//学校地址
[StringLength(20)]
public string StudentTel { get; set; }//学校热线
}
修改学生模型类如下：
public class Student
{
[Key]
public int Id { get; set; }
[Required]
[StringLength(10)]
public string Name { get; set; }//姓名
[StringLength(2)]
public string Sex { get; set; }//性别
[Unique(ErrorMessage="学号不允许重复")]
[StringLength(18)]
public string StudentNum { get; set; }//学号
[StringLength(100)]
public string StudentAddress { get; set; }//地址
[StringLength(11)]
public string StudentTel { get; set; }//联系电话----------------------------新加的字段
}
上下文类加上DBset<School>如下：
public class StudentContext : DbContext
{
public StudentContext()
: base("StudentContext")//指定连接字符串
{
}
public DbSet<Student> Students { get; set; }
public DbSet<Course> Courses { get; set; }
public DbSet<Score> Scores { get; set; }
public DbSet<School> Schools { get; set; }//新加一张表
/// <summary>
/// OnModelCreating方法中的modelBuilder.Conventions.Remove语句禁止表名称正在多元化。如果你不这样做，所生成的表将命名为Students、Courses和Enrollments。相反，表名称将是Student、Course和Enrollment。开发商不同意关于表名称应该多数。本教程使用的是单数形式，但重要的一点是，您可以选择哪个你更喜欢通过包括或省略这行代码的形式。
/// </summary>
/// <param name="modelBuilder"></param>
protected override void OnModelCreating(DbModelBuilder modelBuilder)
{
modelBuilder.Conventions.Remove<PluralizingTableNameConvention>();
}
}
下面，我们进行代码迁移<在进行代码迁移之前，您必须重新生成您的项目>：
首先，打开程序包管理器控制台
在PM>提示符下输入以下命令︰
enable-migrations
add-migration InitialCreate
解释下这两个命令的含义：enable-migrations 是指启动迁移，此命令输入后，系统会检查上下文目标 add-migration InitialCreate 创建名称为：时间戳_InitialCreate.CS的文件，其中时间戳是根据当前时间点生成的。
我们得到如下信息
至此，我们在项目中会发现多出一个名为：Migrations的文件夹，文件夹内有两个文件：201612080727320_InitialCreate.cs 和 Configuration.cs
下面介绍下这两个文件的作用：
Configuration.cs 中有个Seed方法，您每次代码迁移执行时，都会执行seed()方法，您可以通过Seed方法增加一些必要的数据。例如，上述我们增加了一张学校模型类，在代码迁移时，我们希望插入一条学校数据，我们可以这样修改seed()方法：
下面是我修改后的Seed方法：
namespace EF_Test.Migrations
{
using System;
using System.Data.Entity;
using System.Data.Entity.Migrations;
using System.Linq;
using EF_Test.DAL;
internal sealed class Configuration : DbMigrationsConfiguration<EF_Test.DAL.StudentContext>
{
public Configuration()
{
AutomaticMigrationsEnabled = false;
}
protected override void Seed(EF_Test.DAL.StudentContext context)
{
context.Schools.AddOrUpdate(
p => p.schoolId,
new School { schoolName = "河南城建学院", StudentAddress = "平顶山市新华区" , StudentTel="0375-88888888" }
);
context.SaveChanges();
}
}
}
201612080727320_InitialCreate.cs 或者称为：时间戳_InitialCreate.cs 是干嘛用的呢？我们来看看生成的代码，如下：
namespace EF_Test.Migrations
{
using System;
using System.Data.Entity.Migrations;
public partial class InitialCreate : DbMigration
{
public override void Up()
{
CreateTable(
"dbo.Course",
c => new
{
Id = c.Int(nullable: false, identity: true),
Name = c.String(nullable: false, maxLength: 20),
})
.PrimaryKey(t => t.Id);
CreateTable(
"dbo.Score",
c => new
{
Id = c.Int(nullable: false, identity: true),
StudentScore = c.Int(nullable: false),
StudentID = c.Int(nullable: false),
CourseID = c.Int(nullable: false),
})
.PrimaryKey(t => t.Id)
.ForeignKey("dbo.Course", t => t.CourseID, cascadeDelete: true)
.ForeignKey("dbo.Student", t => t.StudentID, cascadeDelete: true)
.Index(t => t.StudentID)
.Index(t => t.CourseID);
CreateTable(
"dbo.Student",
c => new
{
Id = c.Int(nullable: false, identity: true),
Name = c.String(nullable: false, maxLength: 10),
Sex = c.String(maxLength: 2),
StudentNum = c.String(maxLength: 18),
StudentAddress = c.String(maxLength: 100),
StudentTel = c.String(maxLength: 11),
})
.PrimaryKey(t => t.Id);
}
public override void Down()
{
DropForeignKey("dbo.Score", "StudentID", "dbo.Student");
DropForeignKey("dbo.Score", "CourseID", "dbo.Course");
DropIndex("dbo.Score", new[] { "CourseID" });
DropIndex("dbo.Score", new[] { "StudentID" });
DropTable("dbo.Student");
DropTable("dbo.Score");
DropTable("dbo.Course");
}
}
}
有两个方法，Up()和Down() 都是些创建表，删除主键，删除表的一些动作。我们先不管这些，继续我们的代码迁移：
在PM>提示符下输入以下命令︰
Update-Database 或者 Update-Database -Verbose 前者仅仅是更新数据库，不会在程序包管理器控制台中输出执行的SQL语句，而后者则可以输出执行的SQL语句，我们姑且使用后者吧
执行失败了，原因也很明确，是因为我们现有的数据库中已经存在Course等表，再次创建会发生异常，怎么办？
我们翻开 201612080727320_InitialCreate.cs 这个文件，将此文件作如下修改：
public override void Up()
{
CreateTable(
"dbo.School",
c => new
{
schoolId = c.Int(nullable: false, identity: true),
schoolName = c.String(nullable: false, maxLength: 10),
StudentAddress = c.String(maxLength: 100),
StudentTel = c.String(maxLength: 20),
})
.PrimaryKey(t => t.schoolId);
}
public override void Down()
{
DropTable("dbo.School");
}
项目生成成功后，再次执行：Update-Database -Verbose
万事大吉，执行成功，而且执行了Seed方法，那么我们的数据库中应该有一张名为 School 的表，并且里面有一条数据，如下：
学校模型创建成功了，但是，学生表中添加的字段加上去了么？
根据上图，学生表结构并没有加上StudentTel一列，为何？我们该怎么办？
在此，我们执行：add-migration 命令 add-migration 命令和 add-migration InitialCreate 命令的不同是一个指定了后缀名称，一个没有指定，需要我们自定义！
根据上图，我们创建了一个后缀为：SshoolCreate的文件，如下：
双击文件，我们发现里面没什么内容，我们添加如下代码：
public partial class SshoolCreate : DbMigration
{
public override void Up()
{
AddColumn("dbo.Student", "StudentTel", c => c.String(maxLength: 11));
}
public override void Down()
{
DropColumn("dbo.Student", "StudentTel");
}
}
继续执行：update-database 命令
执行成功，我们到数据库看看
字段StudentTel已经加入了表Student
至此，EF 代码迁移也就讲完了，上文比较乱，最后做个总结：
1、 数据库中有张名为：__MigrationHistory的表，主要用于代码迁移记录
每当你成功迁移一次，都会生成一条记录。
2、上文中提到：时间戳_InitialCreate.CS 文件，如果在项目中有多个同类文件，项目会执行距离当前时间最近的 时间戳_InitialCreate.CS，如果距离当前时间最近的 时间戳_InitialCreate.CS 在表__MigrationHistory中有记录，则不会执行！
3、其实代码迁移用到的命令也就那几个，在此总结下：
enable-migrations ： 启动代码迁移并生成Configuration.CS文件
add-migration ： 启动生成 时间戳_Name.CS文件，类似于：201612080802330_Name.CS这种文件，需要指定Name，用于多次迁移
add-migration InitialCreate ： 启动生成类似于：201612080802330_InitialCreate.CS这种文件
Update-Database -Verbose 和 Update-Database 执行代码迁移，修改数据库表结构。 前者会在执行过程中生成相应的SQL语句
4、常用的C#代码：
创建一张表：
public partial class InitialCreate : DbMigration
{
public override void Up()
{
CreateTable(
"dbo.School",
c => new
{
schoolId = c.Int(nullable: false, identity: true),
schoolName = c.String(nullable: false, maxLength: 10),
StudentAddress = c.String(maxLength: 100),
StudentTel = c.String(maxLength: 20),
})
.PrimaryKey(t => t.schoolId);
}
public override void Down()
{
DropTable("dbo.School");
}
删除一张表：
public partial class DropTable : DbMigration
{
public override void Up()
{
DropTable("dbo.School");
}
public override void Down()
{
CreateTable(
"dbo.School",
c => new
{
schoolId = c.Int(nullable: false, identity: true),
schoolName = c.String(nullable: false, maxLength: 10),
StudentAddress = c.String(maxLength: 100),
StudentTel = c.String(maxLength: 20),
})
.PrimaryKey(t => t.schoolId);
}
}
修改字段长度或字段名称
public partial class EEE : DbMigration
{
public override void Up()
{
AddColumn("dbo.Student", "StudentPhone", c => c.String(maxLength: 11));
DropColumn("dbo.Student", "StudentTel");
}
public override void Down()
{
AddColumn("dbo.Student", "StudentTel", c => c.String(maxLength: 11));
DropColumn("dbo.Student", "StudentPhone");
}
}
增加表字段：
public partial class FFF : DbMigration
{
public override void Up()
{
AddColumn("dbo.Student", "StudentPhowwwwne", c => c.String(maxLength: 11));
}
public override void Down()
{
DropColumn("dbo.Student", "StudentPhowwwwne");
}
}
删除表字段：
public partial class GGG : DbMigration
{
public override void Up()
{
DropColumn("dbo.Student", "StudentPhowwwwne");
}
public override void Down()
{
AddColumn("dbo.Student", "StudentPhowwwwne", c => c.String(maxLength: 11));
}
}
等等吧，上述代码都能生成。
5、如果您生成了一个新的 时间戳_XXXX.CS文件，请务必使用Update-DataBase命令执行，否则，您将永远不会生成下一个 时间戳_XXXX.CS文件，究其原因，是因为在数据表[__MigrationHistory]中没有记录。
最新的[__MigrationHistory]数据
根据上述数据，就证明我做了五次代码迁移了！
好了，本节的内容也就讲完了，谢谢大家的耐心查阅！
@陈卧龙的博客