【工欲善其事必先利其器】—Entity Framework实例详解

开始本篇文章之前，先说一下Entity Framework 6 Alpha1在NuGet中已可用，原文链接http://blogs.msdn.com/b/adonet/archive/2012/10/30/ef6-alpha-1-available-on-nuget.aspx

俗话说：“工欲善其事必先利其器”，在深入讲解Entity Framework之前，先准备一下开发工具以及前期的配置。

一、开发工具

开发工具基本略过，这里说一下，我使用的是Visual Studio 2012，Entity Framework版本为4.3.1，获取这个版本的办法：在Package Manager Console中输入Install-Package EntityFramework -Version 4.3.1。至于数据库，主要是LocalDb。

二、连接数据库

当使用NuGet安装完Entity Framework后，在配置文件中会自动加入entityFramework节，里面有defaultConnectionFactory元素，如下：

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <configSections>
    <!-- For more information on Entity Framework configuration, visit http://go.microsoft.com/fwlink/?LinkID=237468 -->
    <section name="entityFramework" type="System.Data.Entity.Internal.ConfigFile.EntityFrameworkSection, EntityFramework, Version=4.3.1.0, Culture=neutral, PublicKeyToken=b77a5c561934e089" />
  </configSections>
  <entityFramework>
    <defaultConnectionFactory type="System.Data.Entity.Infrastructure.SqlConnectionFactory, EntityFramework">
      <parameters>
        <parameter value="Data Source=(localdb)\v11.0; Integrated Security=True; MultipleActiveResultSets=True" />
      </parameters>
    </defaultConnectionFactory>
  </entityFramework>
</configuration>

在没有提供具体数据库连接的情况下，EF默认使用这一配置。如上面代码中，默认会连接到LocalDb，数据库的名称为上下文完全限定名（命名空间+类名）。以前经常提到默认连接到.\SQLEXPRESS，因为安装的版本不同。

EF中提供了两个连接工厂：SqlConnectionFactory和SqlCeConnectionFactory。使用方式分别如下：

Database.DefaultConnectionFactory = new SqlConnectionFactory("Data Source=.;Database=Test;UId=sa;Pwd=sasa;MultipleActiveResultSets=True");

或

Database.DefaultConnectionFactory = new SqlConnectionFactory("Data Source=.;Database=Test;User=sa;Password=sasa;MultipleActiveResultSets=True");

和

Database.DefaultConnectionFactory = new SqlCeConnectionFactory("System.Data.SqlServerCe.4.0");

在配置文件和代码中同时有DefaultConnectionFactory的情况下，代码中的优先。

下面，写一个简单的控制台程序。代码如下：

namespace ConnectDatabase
{
    class Program
    {
        static void Main(string[] args)
        {
            using (TestContext ctx = new TestContext())
            {
                var blog = new Blog()
                {
                    Name = "EF"
                };
                blog.Posts.Add(new Post()
                {
                    Title = "连接数据库",
                    Content = "这是连接数据库的测试",
                    Creationdate = DateTime.Now,
                    Blog = blog
                });
                ctx.Blogs.Add(blog);
                ctx.SaveChanges();

                foreach (var item in ctx.Blogs)
                {
                    Console.WriteLine(item.Name);
                }
            }
        }
    }

    public class TestContext : DbContext
    {
        protected override void OnModelCreating(DbModelBuilder modelBuilder)
        {
            base.OnModelCreating(modelBuilder);
        }

        public DbSet<Blog> Blogs { get; set; }
        public DbSet<Post> Posts { get; set; }
    }

    public class Blog
    {
        public Blog()
        {
            Posts = new List<Post>();
        }

        public int Id { get; set; }
        public string Name { get; set; }
        public virtual List<Post> Posts { get; set; }
    }

    public class Post
    {
        public int Id { get; set; }
        public string Title { get; set; }
        public string Content { get; set; }
        public DateTime Creationdate { get; set; }
        public virtual Blog Blog { get; set; }
    }
}

使用默认连接配置，生成的数据库名称为：ConnectDatabase.TestContext，如下图所示：

重写上面配置有以下方法：

1.在配置文件中添加connectionStrings，name和上下文类名一致。

<connectionStrings>
  <add name="TestContext1" connectionString="Data Source=(localdb)\v11.0;Database=Test;Integrated Security=True;MultipleActiveResultSets=True" providerName="System.Data.SqlClient"/>
</connectionStrings>

2.同1，但是name和上下文类名不一致。这就需要修改TextContext代码，如下：

public TestContext() : this("TestContext1") { }

public TestContext(string nameOrConnectionString)
    : base(nameOrConnectionString)
{

}

或

public TestContext()
    : base("name=TestContext1")
{

}

或

public TestContext():base("TestContext1"){}

下面给出连接具体数据库的配置：

1.连接Sql Server数据库

<connectionStrings>
  <add name="TestContext" connectionString="Data Source=.;Database=Test;User=sa;Password=sasa;MultipleActiveResultSets=True" providerName="System.Data.SqlClient"/>
</connectionStrings>

2.连接Sql Server Compact 4.0

<connectionStrings>
  <add name="TestContext" connectionString="Data Source=|DataDirectory|\Test.sdf" providerName="System.Data.SqlServerCe.4.0"/>
</connectionStrings>

3.连接MySql 5.5

连接MySql数据库需要安装mysql提供程序mysql-connector-net-6.6.4，本文最后提供这些工具的下载地址。

<connectionStrings>
  <add name="TestContext"
    connectionString="User Id=root;server=localhost;password=sasa;database=test1"
    providerName="MySql.Data.MySqlClient" />
</connectionStrings>

三、数据库初始化

1.关闭初始化

Database.SetInitializer<TestContext>(null);

2.CreateDatabaseIfNotExists

这是Entity Framework的默认初始化策略，没有必要设置它，如果真的需要设置，如下：

Database.SetInitializer(new CreateDatabaseIfNotExists<TestContext>());

3.DropCreateDatabaseWhenModelChanges

如果模型发生了改变，则删除并重建数据库。

Database.SetInitializer(new DropCreateDatabaseWhenModelChanges<TestContext>());

4.DropCreateDatabaseAlways

无论模型和数据库匹配与否，都删除并重建数据库。

Database.SetInitializer(new DropCreateDatabaseAlways<TestContext>());

5.Database.Initialize可以强制初始化，即使在当前AppDomain中已经发生了。下面我写个单元测试程序，来演示这一点：

[TestClass]
public class UnitTest1
{
    [TestMethod]
    public void TestForceInitialize()
    {
        //说明一点：我Demo中的TestContext和Microsoft.VisualStudio.TestTools.UnitTesting.TestContext冲突了，所以写成了ConnectDatabase.TestContext
        //Arrage
        Database.SetInitializer(new DropCreateDatabaseAlways<ConnectDatabase.TestContext>());
        //Act
        using (ConnectDatabase.TestContext ctx = new ConnectDatabase.TestContext())
        {
            ctx.Database.Initialize(force: true);
            ctx.Blogs.Add(new ConnectDatabase.Blog()
            {
                Name = "强制初始化1"
            });
            ctx.SaveChanges();
        }
        using (ConnectDatabase.TestContext ctx = new ConnectDatabase.TestContext())
        {
            ctx.Database.Initialize(force: true);
            ctx.Blogs.Add(new ConnectDatabase.Blog()
            {
                Name = "强制初始化2"
            });
            ctx.SaveChanges();
        }
        ConnectDatabase.Blog blog = null;
        using (ConnectDatabase.TestContext ctx = new ConnectDatabase.TestContext())
        {
            blog = ctx.Blogs.FirstOrDefault();
        }

        //Assert
        Assert.IsNotNull(blog);
        Assert.AreEqual("强制初始化2", blog.Name);

    }
}

测试结果：

因为设置的初始化策略为DropCreateDatabaseAlways，每一次调用Database.Initialize，参数为true，都会重新删除并创建数据库。

四、Seed数据

创建数据库时初始化一些数据，首先自定义初始化策略，重写Seed方法，代码如下：

public class DropCreateDatabaseWithSeedData : DropCreateDatabaseAlways<TestContext>
{
    protected override void Seed(TestContext context)
    {
        context.Blogs.Add(new Blog()
        {
            Name = "种子数据1"
        });
        context.Blogs.Add(new Blog()
        {
            Name = "种子数据2"
        });
        //注意没有调用context.SaveChanges(),base.Seed(context)会调用
        base.Seed(context);
    }
}

下面是测试程序：

[TestMethod]
public void SeedData()
{
    Database.SetInitializer(new DropCreateDatabaseWithSeedData());
    List<ConnectDatabase.Blog> blogList = null;
    using (ConnectDatabase.TestContext ctx = new ConnectDatabase.TestContext())
    {
        blogList = ctx.Blogs.OrderBy(t => t.Id).ToList();
    }
    Assert.AreEqual(2, blogList.Count);
    Assert.AreEqual("种子数据1", blogList[0].Name);
    Assert.AreEqual("种子数据2", blogList[1].Name);
}

测试结果：

五、创建索引

在Seed方法中，使用ExecuteSqlCommand创建索引，代码如下：

protected override void Seed(TestContext context)
{
    context.Database.ExecuteSqlCommand("CREATE INDEX IX_Test_Name ON Blogs (Name)");
    context.Blogs.Add(new Blog()
    {
        Name = "种子数据1"
    });
    context.Blogs.Add(new Blog()
    {
        Name = "种子数据2"
    });
    //注意没有调用context.SaveChanges(),base.Seed(context)会调用
    base.Seed(context);
}

六、结束语

mysql相关工具下载地址：

1.mysql-5.5.28-winx64.msi

2.mysql-connector-net-6.6.4.msi

3.mysql-workbench-gpl-5.2.44-win32.msi

本篇中主要讲了Entity Framework连接数据库、初始化的一些知识，跟题目”工欲善其事必先利其器“有点不符，但仔细想想也相差不了多远，解决了最基本的，后面的才能更顺利。

点击查看《Entity Framework实例详解》系列的其他文章。

如果遇到问题，可以访问Entity Framework社区，网址是www.ef-community.com