【工欲善其事必先利其器】—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