用实体框架创建一个模型类(C#)

原文地址：http://www.asp.net/learn/mvc/tutorial-16-cs.aspx

通过本次教程，你将学会怎样通过实体框架使用asp.net mvc。你将学会使用实体向导来创建一个ado.net实体数据模型。在本次教程里，我们会创建一个web应用程序来说明怎样用实体框架显示，插入，更新和删除数据库数据。

Microsoft Entity Framework是一个对象关系映射工具，它能让你一个创建数据访问层。避免手动创建数据访问类带来的麻烦。

为了演示怎样使用Entity framework。我们将创建一个简单的应用程序。在这里我们创建一个movie database应用程序，这个应用程序能让你显示和编辑movie数据库记录。

本次教程假定你有vs2008 或者visual web developer 2008 和 service pack 1。要使用entity framework你需要service pack 1。你可以从http://www.asp.net/downloads/下载Visual Studio 2008 Service Pack 1 或者Visual Web Developer with Service Pack 1。

注意：
ASP.NET MVC 和the Microsoft Entity Framework没有必然的联系。除了Entity Framework，你还可以选择其他的 O/RM工具（如：Microsoft LINQ to SQL, NHibernate 或者SubSonic）。

然后我们要创建一个数据库，和相应的model (具体内容略)。

注意：
在model文件夹下面的designer.cs文件里，不要写代码，容易出错。如果你想扩展designer.cs里面的entity类的方法，你可以在另一个文件里写partial classes。

用entity framework 选择数据记录

下面的index（）动作通过entity framework返回所有数据库里的记录：
Listing 1 – Controllers\HomeController.cs

Code

注意到，在listing 1里有一个构造器，这个构造器用来初始化类里的字段域_db。_db代表了用entityframework生成的实体。_db域是在刚才model里的创建的MoviesDBEntities类的一个实例。

注意：
为了能在controler里使用theMoviesDBEntities类，你必须引入MovieEntityApp.Models namespace命名空间（theMoviesDBEntities所在的空间）。

_db在index()动作里被用来从数据库的表里返回记录。tolist()会把movie数据集转变为一般的movie objects集合(List<movie>).

返回的数据集是用LINQ to entities技术实现的。上面listing 1使用的时LINQ方法语法来返回数据集。如果你喜欢，你也可以使用LINQ查询语法来实现，下面是两种语法的相同实现：

ViewData.Model = _db.MovieSet.ToList();
ViewData.Model = (from m in _db.MovieSet select m).ToList();

你觉得那总LINQ语法直观，就用哪种。它们在执行上没有什么不同，唯一的不同是形式的不同。

下面的listing 2 用来显示提取的记录：
Listing 2 – Views\Home\Index.aspx

<%@ Page Language="C#"
  Inherits="System.Web.Mvc.ViewPage<List<MovieEntityApp.Models.Movie>>" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>Index</title>
</head>
<body>
    <div>

<% foreach (var m in ViewData.Model)
   { %>

    Title: <%= m.Title %>
    <br />
    Director: <%= m.Director %>
    <br />
    <%= Html.ActionLink("Edit", "Edit", new { id = m.Id })%>
    <%= Html.ActionLink("Delete", "Delete", new { id = m.Id })%>

        <hr />
<% } %>

<%= Html.ActionLink("Add Movie", "Add") %>

    </div>
</body>
</html>

结果如图：

index view是一个类型化得视图。index view包含了一个<%@ Page %>指令，这个指令里有Inherits特性，而这个特性指明把model里的property转变为强类型的一般（泛型）的movie objects集合（List<movie>)。

用 entity framework插入记录

你可以用entity framework轻松的插入记录到数据库里。listing 3 包含了两个新action动作，你可以用他们来插入记录到数据库里：
Listing 3 – Controllers\HomeController.cs (Add methods)

public ActionResult Add()
{
    return View();
}

[AcceptVerbs(HttpVerbs.Post)]
public ActionResult Add(FormCollection form)
{
    var movieToAdd = new Movie();

    // Deserialize (Include white list!)
    TryUpdateModel(movieToAdd, new string[] { "Title", "Director" }, form.ToValueProvider());

    // Validate
    if (String.IsNullOrEmpty(movieToAdd.Title))
        ModelState.AddModelError("Title", "Title is required!");
    if (String.IsNullOrEmpty(movieToAdd.Director))
        ModelState.AddModelError("Director", "Director is required!");

    // If valid, save movie to database
    if (ModelState.IsValid)
    {
        _db.AddToMovieSet(movieToAdd);
        _db.SaveChanges();
        return RedirectToAction("Index");
    }

    // Otherwise, reshow form
    return View(movieToAdd);
}

第一个add()动作只是返回一个试图。这个视图包含了一个form（用来添加新记录）（如图，finger 8）。当你点击submint第二个Add(FormCollection form)动作会被调用。

注意到，第二个Add有一个特性AcceptVerbs。这样只用当执行一个HTTP POST操作时，这个add动作才会被调用。换句话说，就是只用当posting an HTML form时，Add(FormCollection form)动作会被调用.

在第二个Add(FormCollection form)里，通过ASP.NET MVC的 TryUpdateModel()方法，创建一个新的Entity Framework Movie类的实例，TryUpdateModel会收集传到add()的FormCollection,并把收集到的数据转变为一个movie实例。

使用Entity Framework，并要用上TryUpdateModel 或者UpdateModel方法时，你需要公开相应的类的属性。（个属性的名称要相同）。

接着，add(FormCollection )方法执行一些简单的表单认证。这个add动作会认证Title 和Director有值。如果认证失败，那么认证的错误信息会加到ModelState上。

如果没哟认证错误，那么一条新的记录会被entity framework加到Movies database table里。即执行如下的两行代码：

_db.AddToMovieSet(movieToAdd);
_db.SaveChanges();

第一行代码把新纪录添加到set of movies中，第二行代码把所作的更改写入底层数据库中（写入数据库文件）

Figure 8 – The Add view

用entity framework更新数据库记录

你大部分时候都可以想我们上面插入记录一样，更新记录。listing 4 包含了两个动作Edit(),第一个返回一个html form（这个form是用来编辑记录的）.第二个会尝试根系记录。
Listing 4 – Controllers\HomeController.cs (Edit methods)

public ActionResult Edit(int id)
{
    // Get movie to update
    var movieToUpdate = _db.MovieSet.First(m => m.Id == id);

    ViewData.Model = movieToUpdate;
    return View();
}

[AcceptVerbs(HttpVerbs.Post)]
public ActionResult Edit(FormCollection form)
{
    // Get movie to update
    var id = Int32.Parse(form["id"]);
    var movieToUpdate = _db.MovieSet.First(m => m.Id == id);

    // Deserialize (Include white list!)
    TryUpdateModel(movieToUpdate, new string[] { "Title", "Director" }, form.ToValueProvider());

    // Validate
    if (String.IsNullOrEmpty(movieToUpdate.Title))
        ModelState.AddModelError("Title", "Title is required!");
    if (String.IsNullOrEmpty(movieToUpdate.Director))
        ModelState.AddModelError("Director", "Director is required!");

    // If valid, save movie to database
    if (ModelState.IsValid)
    {
        _db.SaveChanges();
        return RedirectToAction("Index");
    }

    // Otherwise, reshow form
    return View(movieToUpdate);
}

第二个edit()执行时，先从数据库里获得一条与id相同的记录。

接着，TryUpdateModel()方法吧form里的值转变为一个movie实例。

最后，如果没有认证错误，就保存所作的更改到底层数据库。

下面是编辑记录的页面。注意有一个隐藏域id.
Listing 5 – Views\Home\Edit.aspx

<%@ Page Language="C#"
  Inherits="System.Web.Mvc.ViewPage<MovieEntityApp.Models.Movie>" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>Edit</title>
    <style type="text/css">

    .input-validation-error
    {
        background-color:Yellow;
    }

    </style>
</head>
<body>
    <div>

<h1>Edit Movie</h1>

<form method="post" action="/Home/Edit">

    
    <%= Html.Hidden("id") %>

    Title:
    <br />
    <%= Html.TextBox("title") %>

    <br /><br />
    Director:
    <br />
    <%= Html.TextBox("director") %>

    <br /><br />
    <input type="submit" value="Edit Movie" />
</form>

    </div>
</body>
</html>

用Entity Framework删除记录

你可以用下面的方法来删除记录：
Listing 6 -- \Controllers\HomeController.cs (Delete action)

public ActionResult Delete(int id)
{
    // Get movie to delete
    var movieToDelete = _db.MovieSet.First(m => m.Id == id);

    // Delete
    _db.DeleteObject(movieToDelete);
    _db.SaveChanges();

    // Show Index view
    return RedirectToAction("Index");
}

调用DeleteObject()来删除。

总结
本次教程的目标是展示如何用ASP.NET MVC和the Microsoft Entity Framework来创建数据库操作应用程序。你学会了如何创建一个可以选择，插入，更新和删除记录的应用程序。

首先，我们讨论了如何用Entity Data Model向导来创建Entity Data Model。
接着，你学习了如何用LINQ to Entities技术获得记录。

最后，我们使用Entity Framework来完成选择，插入，更新和删除记录。