ASP.NET MVC 5 - 给电影表和模型添加新字段

在本节中，您将使用Entity Framework Code First来实现模型类上的操作。从而使得这些操作和变更，可以应用到数据库中。

默认情况下，就像您在之前的教程中所作的那样，使用 Entity Framework Code First自动创建一个数据库，Code First为数据库所添加的表，将帮助您跟踪数据库是否和从它生成的模型类是同步的。如果他们不是同步的，Entity Framework将抛出一个错误。这非常方便的在开发时就可以发现错误，否则您可能会在运行时才发现这个问题。

为对象模型的变更设置 Code First Migrations

从解决方案资源管理器中双击Movies.mdf，打开数据库工具, 在数据库工具（数据库资源管理器、服务器资源管理器或 SQL Server对象资源管理器），右键单击Movies.mdf f，并选择删除。

Build应用程序，以确保没有任何编译错误。

从工具菜单上，单击库包管理器，然后点击程序包管理器控制台.

在程序包管理器控制台窗口，在提示符 PM> 后输入：

Enable-Migrations -ContextTypeName MvcMovie.Models.MovieDBContext

如上所示的Enable-Migrations 命令，会在Migrations文件夹下创建一个Configuration.cs 文件。

在Visual Studio 里面打开Configuration.cs 文件. 用下面的代码替换Seed函数：

protected override void Seed(MvcMovie.Models.MovieDBContext context) 
{ 
    context.Movies.AddOrUpdate( i => i.Title, 
        new Movie 
        { 
            Title = "When Harry Met Sally", 
            ReleaseDate = DateTime.Parse("1989-1-11"), 
            Genre = "Romantic Comedy", 
            Price = 7.99M 
        },

         new Movie 
         { 
             Title = "Ghostbusters ", 
             ReleaseDate = DateTime.Parse("1984-3-13"), 
             Genre = "Comedy", 
             Price = 8.99M 
         },

         new Movie 
         { 
             Title = "Ghostbusters 2", 
             ReleaseDate = DateTime.Parse("1986-2-23"), 
             Genre = "Comedy", 
             Price = 9.99M 
         },

       new Movie 
       { 
           Title = "Rio Bravo", 
           ReleaseDate = DateTime.Parse("1959-4-15"), 
           Genre = "Western", 
           Price = 3.99M 
       } 
   ); 
   
}

右键单击红色波浪线下Movie，并选择“解析(Resolve)”，然后单击“using MvcMovie.Models;

这样做会增加下面的语句：

using MvcMovie.Models;

Code First Migrations调用Seed的方法，每个迁移（程序包管理器控制台更新数据库），此方法用于updates数据（如果数据存在），或inserted数据。

在AddOrUpdate方法在下面的代码执行一个的“upsert”操作：

context.Movies.AddOrUpdate(i => i.Title, 
    new Movie 
    { 
        Title = "When Harry Met Sally", 
        ReleaseDate = DateTime.Parse("1989-1-11"), 
        Genre = "Romantic Comedy", 
        Rating = "PG", 
        Price = 7.99M 
    }

因为Seed方法与每个迁移同时运行时，故，你不能仅仅插入数据，因为当你正试图添加，可能已经完成了创建数据库后的第一次迁移。“upsert”操作阻止错误的发生，如果你尝试插入一个已经存在的行，它覆盖任何数据更改，当你在测试应用程序的同时。你可能不希望这样的事情发生：在某些情况下，当您更改数据测试时，你希望你的变化后数据库同步更新。在这种情况下，你想要做一个有条件的插入操作：只有当它不存在的时候，插入一行。
传递给AddOrUpdate的方法的第一个参数，指定的属性来使用以检查是否已存在某行。对于您所提供的测试影片的数据，Title属性可以被用于此目的，因为每个标题在列表中是唯一：

context.Movies.AddOrUpdate(i => i.Title,

这个代码假设titiles属性是唯一的。如果手动添加一个重复的标题，你会得到下面的异常。

更多关于 AddOrUpdate 方法的信息，请参见 Take care with EF 4.3 AddOrUpdate Method..

按 CTRL-SHIFT-B 来Build工程。（如果此次Build不成功，以下的步骤将会失败。）

下一步是创建一个DbMigration类，用于初始化数据库迁移。此迁移类将创建新的数据库，这也就是为什么在之前的步骤中你要删除movie.mdf文件。

在软件包管理器控制台窗口中，输入"add-migration Initial"命令来创建初始迁移。" Initial" 的名称是任意，是用于创建迁移文件的名称。

Code First Migrations将会在Migrations文件夹中创建另一个类文件（文件名为: {DateStamp}_Initial.cs )，此类中包含的代码将创建数据库的Schema。迁移文件名使用时间戳作为前缀，以帮助用来排序和查找。查看{DateStamp}_Initial.cs文件，它包含了为电影数据库创建电影表的说明。当您更新数据库时， {DateStamp}_Initial.cs文件将会被运行并创建 DB 的Schema。然后Seed方法将运行，用来填充 DB 的测试数据。

在软件包管理器控制台中，输入命令" update-database "，创建数据库并运行Seed方法。

如果您收到表已经存在并且无法创建的错误，可能是因为您已经删除了数据库，并且在执行update-database之前，您运行了应用程序。在这种情况下，再次删除Movies.mdf文件，然后重试update-database命令。如果您仍遇到错误，删除Migration文件夹及其内容，然后从头开始重做。（即删除Movies.mdf文件，然后再进行Enable-Migrations）

运行该应用程序，然后浏览URL /Movies Seed数据显示如下:

为影片模型添加评级(Rating)属性

给现有的Movie类，添加新的Rating属性。打开Models\Movie.cs文件并添加如下Rating属性：

public string Rating { get; set; }

完整的Movie类如下：

public class Movie 
{ 
    public int ID { get; set; } 
    public string Title { get; set; }

    [Display(Name = "Release Date")] 
    [DataType(DataType.Date)] 
    [DisplayFormat(DataFormatString = "{0:yyyy-MM-dd}", ApplyFormatInEditMode = true)] 
    public DateTime ReleaseDate { get; set; } 
    public string Genre { get; set; } 
    public decimal Price { get; set; } 
    public string Rating { get; set; } 
}

Build 应用程序 Build>Build Move或CTRL-SHIFT-B.

因为你已经添加了新的字段，电影类的，你还需要Bind，所以这次新的属性将被包含。更新的绑定属性，Create和Edit动作方法, 包括Rating属性：

[Bind(Include = "ID,Title,ReleaseDate,Genre,Price,Rating")]

您还需要更新视图模板，以显示浏览器视图中创建和编辑新的评级(Rating)属性。

打开\Views\Movies\Index.cshtml文件，在Price列后面添加<th>Rating</th>的列头。然后添加一个<td>列来显示@item.Rating的值。下面是更新的Index.cshtml视图模板：

@model IEnumerable<MvcMovie.Models.Movie> 
@{ 
    ViewBag.Title = "Index"; 
} 
<h2>Index</h2> 
<p> 
    @Html.ActionLink("Create New", "Create") 
    @using (Html.BeginForm("Index", "Movies", FormMethod.Get)) 
    { 
    <p> 
        Genre: @Html.DropDownList("movieGenre", "All") 
        Title: @Html.TextBox("SearchString") 
        <input type="submit" value="Filter" /> 
    </p> 
    } 
</p> 
<table class="table"> 
    <tr> 
        <th> 
            @Html.DisplayNameFor(model => model.Title) 
        </th> 
        <th> 
            @Html.DisplayNameFor(model => model.ReleaseDate) 
        </th> 
        <th> 
            @Html.DisplayNameFor(model => model.Genre) 
        </th> 
        <th> 
            @Html.DisplayNameFor(model => model.Price) 
        </th> 
        <th> 
            @Html.DisplayNameFor(model => model.Rating) 
        </th>

        <th></th> 
    </tr>

@foreach (var item in Model) { 
    <tr> 
        <td> 
            @Html.DisplayFor(modelItem => item.Title) 
        </td> 
        <td> 
            @Html.DisplayFor(modelItem => item.ReleaseDate) 
        </td> 
        <td> 
            @Html.DisplayFor(modelItem => item.Genre) 
        </td> 
        <td> 
            @Html.DisplayFor(modelItem => item.Price) 
        </td> 
        <td> 
            @Html.DisplayFor(modelItem => item.Rating) 
        </td>

        <td> 
            @Html.ActionLink("Edit", "Edit", new { id=item.ID }) | 
            @Html.ActionLink("Details", "Details", new { id=item.ID }) | 
            @Html.ActionLink("Delete", "Delete", new { id=item.ID }) 
        </td> 
    </tr> 
}

</table>

下一步，打开\Views\Movies\Create.cshtml文件，并在form标签结束处的附近添加如下代码。您可以在创建新的电影时指定一个电影等级。

<div class="form-group"> 
            @Html.LabelFor(model => model.Price, new { @class = "control-label col-md-2" }) 
            <div class="col-md-10"> 
                @Html.EditorFor(model => model.Price) 
                @Html.ValidationMessageFor(model => model.Price) 
            </div> 
        </div>

        <div class="form-group"> 
            @Html.LabelFor(model => model.Rating, new { @class = "control-label col-md-2" }) 
            <div class="col-md-10"> 
                @Html.EditorFor(model => model.Rating) 
                @Html.ValidationMessageFor(model => model.Rating) 
            </div> 
        </div>

        <div class="form-group"> 
            <div class="col-md-offset-2 col-md-10"> 
                <input type="submit" value="Create" class="btn btn-default" /> 
            </div> 
        </div> 
    </div> 
}

<div> 
    @Html.ActionLink("Back to List", "Index") 
</div>

@section Scripts { 
    @Scripts.Render("~/bundles/jqueryval") 
}



<div class="form-group">

@Html.LabelFor(model => model.Price, new { @class = "control-label col-md-2" })

<div class="col-md-10">

@Html.EditorFor(model => model.Price)

@Html.ValidationMessageFor(model => model.Price)

</div>

</div>

<div class="form-group">

@Html.LabelFor(model => model.Rating, new { @class = "control-label col-md-2" })

<div class="col-md-10">

@Html.EditorFor(model => model.Rating)

@Html.ValidationMessageFor(model => model.Rating)

</div>

</div>

<div class="form-group">

<div class="col-md-offset-2 col-md-10">

<input type="submit" value="Create" class="btn btn-default" />

</div>

</div>

</div>

}

<div>

@Html.ActionLink("Back to List", "Index")

</div>

@section Scripts {

@Scripts.Render("~/bundles/jqueryval")

}

现在，您已经更新应用程序代码以支持了新的Rating属性。

现在运行该应用程序，然后浏览 /Movies的 URL。然而，当您这样做时，您将看到以下之一的错误信息：

自从数据库创建后，备份的'MovieDBContext上下文模型已经改变。请考虑使用Code First Migrations更新数据库 (http://go.microsoft.com/fwlink/?LinkId=238269).

你看到这个错误，因为更新的的Movie模型类中比现在Movie现有数据库表的schema不同。（在数据库表中没有Rating列。）

有几个解决错误的方法:

1. Entity Framework会自动删除并重新创建数据库根据新模型类schema。在开发周期的早期，这种方式非常方便，当你正在做开发一个测试数据库，它可以让你快速演进模型和数据库schema。不足之处，你将失去现有的数据库中的数据 - 所以对生产数据库你不想使用这种方法！通常是一个富有成效的办法，开发一个应用程序来初始化数据库的自动测试数据。更多关于Entity Framework database初始化的信息，请参阅Tom Dykstra's fantastic ASP.NET MVC/Entity Framework tutorial.

2. 显式修改现有数据库的架构，以便它匹配的模型类。这种方法的优点是，你保持你的数据。可以使手动或通过建立数据库更改脚本实现它。

3. 使用Code First Migrations来更新数据库schema。

在本教程中，我们将使用Code First Migrations方法。

更新Seed 方法，以使它可以给新列提供一个值。打开Migrations\Configuration.cs 文件，在每个Movie下添加Rating 字段.

new Movie 
        { 
            Title = "When Harry Met Sally", 
            ReleaseDate = DateTime.Parse("1989-1-11"), 
            Genre = "Romantic Comedy", 
            Rating = "PG", 
            Price = 7.99M 
        },

编译解决方案，打开程序包管理器控制台窗体，输入如下命令：

add-migration Rating

add-migration命令告诉migration framework，来检查当前电影模型与当前的影片 DB Schema并创建必要的代码以将数据库迁移到新的模型。AddRatingMig 是一个任意的文件名参数，用于命名migration文件。它将有助于使得迁移步骤成为一个有意义的名字。

当命令完成后，用Visual Studio 打开类文件，新继承自DbMIgration 类的定义，并在Up 方法中，您可以看到创建新列的代码：

public partial class AddRatingMig : DbMigration 
{ 
    public override void Up() 
    { 
        AddColumn("dbo.Movies", "Rating", c => c.String()); 
    } 
    
    public override void Down() 
    { 
        DropColumn("dbo.Movies", "Rating"); 
    } 
}

Build解决方案，然后在 程序包管理器控制台窗口中输入"update-database"命令。

下面的图片显示了 程序包管理器控制台窗口的输出（日期戳前面添加的评级会有所不同）

重新运行应用程序，然后浏览 /Movies 的 URL。您可以看到新的评级字段。

单击CreateNew链接来添加一部新电影。注意，请您可以为电影添加评级。

单击Create。新的电影，包括评级，将显示在电影列表中：

该项目目前正在使用的迁移 (migrations)，当你添加新的字段或更新数据库Schema, 你不需要删除数据库。在下一节中，我们将让更多的架构更改，并使用迁移来更新的数据库。

此外您也应该把Rating 字段添加到Edit、Details和Delete的视图模板中。

您可以再次在 程序包管理器控制台窗口中输入"update-database"命令，将不会有任何新的变化，因为数据库Schema 和模型类现在是匹配的。然而，运行“update-database”将运行再次Seed方法，如果你改变任何种子数据，更改都将丢失，因为Seed的方法upserts数据。你可以阅读更多关于Seed的方法Tom Dykstra's的流行的ASP.NET MVC/Entity Framework tutorial.。

在本节中，您看到了如何修改模型对象并始终保持其和数据库Schema的同步。您还学习了使用填充示例数据来创建新数据库的例子，您可以反复尝试。这只是一个简单的介绍Code First，更完整的教程的请参阅Creating an Entity Framework Data Model for an ASP.NET MVC Application。接下来，让我们看看如何将丰富的验证逻辑添加到模型类，并对模型类执行一些强制的业务规则验证。相信有了本节如何修改模型对象并始终保持其和数据库Schema同步的内容介绍，大家会对MVC的理解又加深一步。后面如果要进行ASP.ET MVC的开发，在具备MVC的知识的同时，还可以借助一些开发工具。使用 ComponentOne Studio ASP.NET MVC 这款轻量级控件，可以助力你的MVC开发过程。

-----------------------------------------------------------------------------------------

《ASP.NET MVC 5 入门指南》12篇文章汇总如下：

1. ASP.NET MVC 5 - 开始MVC 5之旅

2. ASP.NET MVC 5 - 控制器

3. ASP.NET MVC 5 - 视图

4. ASP.NET MVC 5 - 将数据从控制器传递给视图

5. ASP.NET MVC 5 - 添加一个模型

6. ASP.NET MVC 5 - 创建连接字符串(Connection String)并使用SQL Server LocalDB

7. ASP.NET MVC 5 - 从控制器访问数据模型

8. ASP.NET MVC 5 - 验证编辑方法(Edit method)和编辑视图(Edit view)

9. ASP.NET MVC 5 - 给电影表和模型添加新字段

10. ASP.NET MVC 5 - 给数据模型添加校验器