Code First 到新数据库Code First to a New Database

此视频和分步演练提供了面向新数据库的 Code First 开发的简介。 此方案包括针对不存在的数据库和 Code First 将创建的数据库，或者 Code First 将向其中添加新表的空数据库。 Code First 允许使用 C# 或 VB.Net 类定义模型。 还可以选择使用类和属性上的属性或使用 Fluent API 来执行其他配置。

观看视频Watch the video

此视频介绍了面向新数据库的 Code First 开发。 此方案包括针对不存在的数据库和 Code First 将创建的数据库，或者 Code First 将向其中添加新表的空数据库。 Code First 允许使用C#或 VB.Net 类定义模型。 还可以选择使用类和属性上的属性或使用 Fluent API 来执行其他配置。

主讲人：Rowan Miller

视频：WMVMP4 | WMV (ZIP)

先决条件Pre-Requisites

需要至少安装 Visual Studio 2010 或 Visual Studio 2012 才能完成此演练。

如果你使用的是 Visual Studio 2010，你还需要安装NuGet 。

1.创建应用程序1. Create the Application

为了简单起见，我们将构建一个使用 Code First 执行数据访问的基本控制台应用程序。

• 打开 Visual Studio
• 文件->> 项目 。
• 从左侧菜单和控制台应用程序选择Windows
• 输入CodeFirstNewDatabaseSample作为名称
• 选择“确定”

2.创建模型2. Create the Model

让我们使用类定义一个非常简单的模型。 我们只是在 Program.cs 文件中对其进行定义，但在实际应用程序中，您可以将类拆分为单独的文件，并可能是单独的项目。

在 Program.cs 中的 Program 类定义下，添加以下两个类。

public class Blog
{
    public int BlogId { get; set; }
    public string Name { get; set; }
    public virtual List<Post> Posts { get; set; }
}
public class Post
{
    public int PostId { get; set; }
    public string Title { get; set; }
    public string Content { get; set; }
    public int BlogId { get; set; }
    public virtual Blog Blog { get; set; }
}

你会注意到，我们正在建立两个导航属性（博客和博客）虚拟。 这将启用实体框架的延迟加载功能。 延迟加载是指在您尝试访问这些属性时，这些属性的内容将自动从数据库加载。

3.创建上下文3. Create a Context

现在可以定义一个派生上下文，它表示与数据库的会话，从而使我们能够查询和保存数据。 我们定义了从 DbContext 派生的上下文，并为模型中的每个类公开了类型化的 DbSet。

现在，我们开始使用实体框架中的类型，因此我们需要添加 EntityFramework NuGet 包。

• 项目–> 管理 NuGet 程序包 。 注意:如果你没有 “管理 NuGet 包 … “ 选项你应安装最新版本的 NuGet
• 选择 “联机“ 选项卡
• 选择EntityFramework包
• 单击“安装”

在 Program.cs 的顶部为 system.string 添加 using 语句。

using System.Data.Entity;

在 Program.cs 中的 Post 类下面添加以下派生上下文。

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

下面是 Program.cs 应该包含的完整列表。

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using System.Data.Entity;
namespace CodeFirstNewDatabaseSample
{
    class Program
    {
        static void Main(string[] args)
        {
        }
    }
    public class Blog
    {
        public int BlogId { get; set; }
        public string Name { get; set; }
        public virtual List<Post> Posts { get; set; }
    }
    public class Post
    {
        public int PostId { get; set; }
        public string Title { get; set; }
        public string Content { get; set; }
        public int BlogId { get; set; }
        public virtual Blog Blog { get; set; }
    }
    public class BloggingContext : DbContext
    {
        public DbSet<Blog> Blogs { get; set; }
        public DbSet<Post> Posts { get; set; }
    }
}

这就是我们开始存储和检索数据所需的全部代码。 很显然，幕后会出现很多情况，接下来我们将对此进行介绍，但首先我们来看看这一点。

4.读取 & 写入数据4. Reading & Writing Data

在 Program.cs 中实现 Main 方法，如下所示。 此代码创建一个新的上下文实例，然后使用它来插入新的博客。 然后，它使用 LINQ 查询从按标题字母顺序排序的数据库中检索所有博客。

class Program
{
    static void Main(string[] args)
    {
        using (var db = new BloggingContext())
        {
            // Create and save a new Blog
            Console.Write("Enter a name for a new Blog: ");
            var name = Console.ReadLine();
            var blog = new Blog { Name = name };
            db.Blogs.Add(blog);
            db.SaveChanges();
            // Display all Blogs from the database
            var query = from b in db.Blogs
                        orderby b.Name
                        select b;
            Console.WriteLine("All blogs in the database:");
            foreach (var item in query)
            {
                Console.WriteLine(item.Name);
            }
            Console.WriteLine("Press any key to exit...");
            Console.ReadKey();
        }
    }
}

你现在可以运行该应用程序并对其进行测试。

Enter a name for a new Blog: ADO.NET Blog
All blogs in the database:
ADO.NET Blog
Press any key to exit...

我的数据在哪里？Where’s My Data?

按惯例，DbContext 已为您创建了一个数据库。

• 如果本地 SQL Express 实例可用（默认情况下随 Visual Studio 2010 一起安装），则 Code First 已在该实例上创建了数据库
• 如果 SQL Express 不可用，Code First 将尝试使用LocalDB.aspx) （默认情况下安装 Visual Studio 2012）
• 数据库以派生上下文的完全限定名称命名，在本例中为CodeFirstNewDatabaseSample. “bloggingcontext”

这些只是默认的约定，有多种方法可用于更改 Code First 使用的数据库，有关详细信息，请访问DbContext 如何发现模型和数据库连接主题。 你可以使用 Visual Studio 中的服务器资源管理器连接到此数据库

• 视图-> 服务器资源管理器

• 右键单击 “数据连接“，然后选择 “添加连接 … “

• 如果尚未从服务器资源管理器连接到数据库，则需要选择 Microsoft SQL Server 作为数据源

  

• 连接到 LocalDB 或 SQL Express，具体取决于你安装的是哪个

现在，我们可以检查 Code First 创建的架构。

DbContext 通过查看我们定义的 DbSet 属性来确定要包括在模型中的类。 然后，它使用默认的 Code First 约定集来确定表和列的名称、确定数据类型、查找主键等。 稍后在本演练中，我们将介绍如何覆盖这些约定。

5.处理模型更改5. Dealing with Model Changes

现在，可以对模型进行一些更改，当我们进行这些更改时，我们还需要更新数据库架构。 为此，我们将使用一项称为 Code First 迁移的功能，或使用较短的迁移。

迁移允许我们提供一组有序的步骤，这些步骤描述如何升级（和降级）我们的数据库架构。 其中的每个步骤（称为迁移）都包含一些描述要应用的更改的代码。

第一步是为 “Bloggingcontext” 启用 Code First 迁移。

• 工具-> 库包管理器-> 程序包管理器控制台

• 在包管理器控制台中运行 Enable-Migrations 命令

• 已将新的迁移文件夹添加到包含两个项目的项目中：

  • Configuration.cs –此文件包含迁移将用于迁移 “bloggingcontext” 的设置。 对于本演练，我们不需要更改任何内容，但可以在此处指定种子数据，注册其他数据库的提供程序，更改将在其中生成迁移的命名空间等。
  • <时间戳>_InitialCreate.cs –这是第一次迁移，它表示已应用到数据库的更改，以使其成为包含博客和文章表的数据库的空数据库。 尽管我们允许 Code First 自动为我们创建这些表，但现在我们已选择迁移，它们已转换为迁移。 还在本地数据库中记录了已应用此迁移的 Code First。 文件名上的时间戳用于排序目的。

  现在，我们来对模型进行更改，将 Url 属性添加到博客类：

public class Blog
{
    public int BlogId { get; set; }
    public string Name { get; set; }
    public string Url { get; set; }
    public virtual List<Post> Posts { get; set; }
}

• 在 Package Manager Console 中运行Add-迁移 AddUrl命令。 添加迁移命令将检查自上次迁移后发生的更改，并基架找到的任何更改进行新迁移。 我们可以为迁移指定一个名称;在此示例中，我们将调用迁移 “AddUrl”。 基架代码是说，我们需要向 dbo 添加 Url 列，该 Url 列可以保存字符串数据。博客表。 如果需要，我们可以编辑基架代码，但在这种情况下不需要这样做。

namespace CodeFirstNewDatabaseSample.Migrations
{
    using System;
    using System.Data.Entity.Migrations;
    public partial class AddUrl : DbMigration
    {
        public override void Up()
        {
            AddColumn("dbo.Blogs", "Url", c => c.String());
        }
        public override void Down()
        {
            DropColumn("dbo.Blogs", "Url");
        }
    }
}

• 在 Package Manager Console 中运行 “更新数据库“ 命令。 此命令会将任何挂起的迁移应用到数据库。 已应用 InitialCreate 迁移，因此迁移只会应用新的 AddUrl 迁移。 提示：调用 “更新数据库” 时，可以使用 -Verbose开关来查看正在对数据库执行的 SQL。

此时，新的 Url 列将添加到数据库的 “博客” 表中：

6.数据注释6. Data Annotations

到目前为止，我们只是让 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 无法知道用户名应为用户的主密钥。
• 现在我们将使用数据批注，因此我们需要在 Program.cs 的顶部添加 using 语句

using System.ComponentModel.DataAnnotations;

• 现在为用户名属性添加批注，以确定它是主键

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

• 使用Add-迁移 AddUser命令基架迁移，将这些更改应用到数据库
• 运行 “更新-数据库“ 命令以将新迁移应用到数据库

新表现在已添加到数据库中：

EF 支持的全部批注列表为：

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

7.Fluent API7. Fluent API

在上一部分中，我们介绍了如何使用数据批注来补充或替代约定检测到的内容。 配置模型的另一种方法是通过 Code First Fluent API。

大多数模型配置可以使用简单的数据批注完成。 Fluent API 是一种更高级的方法，它指定模型配置，该配置涵盖了数据批注可以执行的所有操作以及数据批注无法实现的更高级配置。 数据批注和 Fluent API 可一起使用。

若要访问 Fluent API 可以重写 DbContext 中的 OnModelCreating 方法。 假设我们要将用户名称栏存储在中的列重命名为显示_名称。

• 用以下代码替代 “Bloggingcontext” 上的 OnModelCreating 方法

public class BloggingContext : DbContext
{
    public DbSet<Blog> Blogs { get; set; }
    public DbSet<Post> Posts { get; set; }
    public DbSet<User> Users { get; set; }
    protected override void OnModelCreating(DbModelBuilder modelBuilder)
    {
        modelBuilder.Entity<User>()
            .Property(u => u.DisplayName)
            .HasColumnName("display_name");
    }
}

• 使用Add-迁移 ChangeDisplayName命令基架迁移，将这些更改应用到数据库。
• 运行 “更新-数据库“ 命令，以将新迁移应用到数据库。

DisplayName 列现在已重命名为显示_名称：

SummarySummary

在本演练中，我们将使用新数据库查看 Code First 开发。 我们使用类定义了一个模型，然后使用该模型来创建数据库并存储和检索数据。 创建数据库后，我们使用 Code First 迁移来更改模型，因为模型已演化。 我们还了解了如何使用数据批注和熟知的 API 配置模型。