Entity Framework Code First 学习

using System.Data.Entity;

 1 class Program 
 2 { 
 3     static void Main(string[] args) 
 4     { 
 5         using (var db = new BloggingContext()) 
 6         { 
 7             // Create and save a new Blog 
 8             Console.Write("Enter a name for a new Blog: "); 
 9             var name = Console.ReadLine(); 
10  
11             var blog = new Blog { Name = name }; 
12             db.Blogs.Add(blog); 
13             db.SaveChanges(); 
14  
15             // Display all Blogs from the database 
16             var query = from b in db.Blogs 
17                         orderby b.Name 
18                         select b; 
19  
20             Console.WriteLine("All blogs in the database:"); 
21             foreach (var item in query) 
22             { 
23                 Console.WriteLine(item.Name); 
24             } 
25  
26             Console.WriteLine("Press any key to exit..."); 
27             Console.ReadKey(); 
28         } 
29     } 
30 }

我的数据在哪里？

按照约定，DbContext 已经创建了一个数据库。

• 如果本地 SQL Express 实例可用（默认情况下随 Visual Studio 2010 安装），则 Code First 已对该实例创建了数据库
• 如果 SQL Express 不可用，则 Code First 将尝试使用 LocalDb（默认情况下随 Visual Studio 2012 安装）
• 数据库以派生上下文的完全限定名命名，在我们的示例中，名称为 EntityFrameworkStudy.BloggingContext
  

这些仅仅是默认约定，除此之外，还有多种方式可更改 Code First 所用的数据库。有关更多信息，请参见DbContext 如何发现模型和数据库连接 主题。

可以在 Visual Studio 中使用服务器资源管理器连接至此数据库

• “视图”->“服务器资源管理器”
• 右键单击“数据连接”并选择“添加连接…”
• 如果尚未从服务器资源管理器连接至数据库，则需要选择 Microsoft SQL Server 作为数据源
  
  

现在，可以检查 Code First 已经创建的架构。

DbContext 通过查看我们定义的 DbSet 属性，了解模型包含哪些类。随后，它使用 Code First 约定的默认集来确定表和列的名称，确定数据类型，查找主键等。本演练稍后将介绍如何重写这些约定。

5.处理模型更改

现在更改模型，当我们进行更改时，还需要更新数据库架构。为此，我们使用一个称为“Code First 迁移”（或简称“迁移”）的功能。（Migration）

“迁移”是一组有序的步骤，描述如何升级（和降级）数据库架构。这些步骤（称为“迁移”）中的每个步骤均包含一些代码，用于描述要应用的更改。 

第一步是为 BloggingContext 启用 Code First 迁移。

• “工具”->“库程序包管理器”->“程序包管理器控制台”
• 在程序包管理器控制台中运行 Enable-Migrations 命令
• 一个新的 Migrations 文件夹已添加至项目中，它包含两个文件：
  • Configuration.cs — 此文件包含“迁移”将用来迁移 BloggingContext 的设置。在本演练中不需要进行任何更改，但是，在此处可以指定种子数据、为其他数据库注册提供程序、更改生成迁移的命名空间等。
  • <时间戳>_InitialCreate.cs — 这是第一个迁移，它表示已经应用于数据库的更改。应用更改的目的是将其从空数据库迁移至包含博客和文章表的数据库。尽管我们让 Code First 自动创建这些表，现在我们选择“迁移”（已转化为一次“迁移”）。Code First 还在本地数据库中记录：该“迁移”已经应用。文件名中的时间戳用于排序。
  
  现在，更改模型，向 Blog 类添加一个 Url 属性：

1 public class Blog 
2 { 
3     public int BlogId { get; set; } 
4     public string Name { get; set; } 
5     public string Url { get; set; } 
6  
7     public virtual List<Post> Posts { get; set; } 
8 }

 1 namespace CodeFirstNewDatabaseSample.Migrations 
 2 { 
 3     using System; 
 4     using System.Data.Entity.Migrations; 
 5      
 6     public partial class AddUrl : DbMigration 
 7     { 
 8         public override void Up() 
 9         { 
10             AddColumn("dbo.Blogs", "Url", c => c.String()); 
11         } 
12          
13         public override void Down() 
14         { 
15             DropColumn("dbo.Blogs", "Url"); 
16         } 
17     } 
18 }

6.数据注释

到目前为止，EF 发现了使用其默认约定的模型。但是，有时类不遵从约定，我们需要能够执行进一步配置。对此有两种方法；本节将介绍数据注释，下一节将介绍 Fluent API。

• 向模型添加用户类
  

  public class User 
  { 
      public string Username { get; set; } 
      public string DisplayName { get; set; } 
  }

  • 我们还需要向派生上下文添加一个集
    

    public class BloggingContext : DbContext 
    { 
        public DbSet<Blog> Blogs { get; set; } 
        public DbSet<Post> Posts { get; set; } 
        public DbSet<User> Users { get; set; } 
    }

    • 如果尝试添加迁移，会收到错误消息“EntityType‘User’未定义键。请为该 EntityType 定义键。”这是因为 EF 无法知道 Username 应为用户的主键。
    • 我们将使用数据注释，因此需要在 Program.cs 的顶部添加一个 using 语句

    using System.ComponentModel.DataAnnotations;

    • 现在，注释 Username 属性，将它标识为主键

    public class User 
    { 
        [Key] 
    　　 public string UserId {get;set;}
        public string Username { get; set; } 
        public string DisplayName { get; set; } 
    }

    • 使用 Add-Migration AddUser 命令搭建一个迁移，将这些更改应用于数据库
    • 运行 Update-Database 命令，将新迁移应用于数据库
      
      

    EF 支持的完整注释列表为：

    • KeyAttribute
    • StringLengthAttribute
    • MaxLengthAttribute
    • ConcurrencyCheckAttribute
    • RequiredAttribute
    • TimestampAttribute
    • ComplexTypeAttribute
    • ColumnAttribute
    • TableAttribute
    • InversePropertyAttribute
    • ForeignKeyAttribute
    • DatabaseGeneratedAttribute
    • NotMappedAttribute
      
      

7.Fluent API

上一节介绍了如何使用数据注释来补充或重写按约定检测的内容。另一种模型配置方法是通过 Code First Fluent API。

大多数模型配置都可使用简单数据注释进行。Fluent API 是一种更高级的方法，除某些数据注释不可能支持的更高级配置外，可以指定包含数据注释所有功能的模型配置。数据注释和 Fluent API 可一起使用。

要访问 Fluent API，需要在 DbContext 中重写 OnModelCreating 方法。假设我们需要重命名 User.DisplayName 存储至 display_name 的列。

• 使用以下代码重写 BloggingContext 的 OnModelCreating 方法
  

  1  protected override void OnModelCreating(DbModelBuilder modelBuilder) 
  2     { 
  3         modelBuilder.Entity<User>() 
  4             .Property(u => u.DisplayName) 
  5             .HasColumnName("display_name"); 
  6     } 

  • 使用 Add-Migration ChangeDisplayName 命令搭建迁移，将这些更改应用于数据库。(如果还有其它的更改也想加在这个migration中，可以更改完后再次运行Add-Migration changedisplayname -force命令)
  • 运行 Update-Database 命令，将新迁移应用于数据库。

DisplayName 列现在重命名为 display_name：