您的位置:首页 > 编程语言 > ASP

【第一篇】ASP.NET MVC快速入门之数据库操作(MVC5+EF6)

2017-08-09 10:03 609 查看

新建项目

打开VS2015,找到菜单项[文件->新建->项目],打开向导对话框:

注意我们的选择项:

1.     运行平台:.NET FrameWork 4.5

2.     项目模板:ASP.NET Web Application (.NET Framework)

3.     项目名称:AspNetMvc.QuickStart,如果你在跟着本教程练习,建议起相同的项目名称,方便直接拷贝代码到你的项目中。

 

点击[确定]按钮,向导会带我们到另一个选择对话框:

 

 

由于本教程是快速入门,所以我们从最简单的入手,只勾选必需的选项:

1.     不进行身份验证。ASP.NET MVC提供了完善的身份验证方案,我们会有单独的文章讲解。

2.     仅勾选 MVC 引用。

 

点击[确定],VS2015会创建一个可直接运行的项目,按下快捷键[Ctrl+F5],不调试直接运行:

 

 

默认的目录结构如下:

 

如果你之前在WebForms下进行开发,对其中的一些文件夹和文件应该很熟悉了:

1.     Web.config:项目配置文件,里面保存项目配置参数以及数据库连接字符串。

2.     packages.config:Nuget配置文件

3.     Global.asax:全局代码文件,提供应用程序级别以及会话级别的事件处理函数,可以在Application_Start中注册全局变量。

4.     favicon.ico:浏览器地址栏图标,在HTML的head标签中引用。

5.     App_Data:放置本地数据库文件,比如LocalDB生成的数据库文件。

 

下面几个文件夹,用来放置静态文件,从名称就可以方便的猜出其用途:

1.     Scripts:放置静态脚本文件,比如jQuery等。

2.     fonts:放置图标字体文件,比如流行的FontAwesome字体等。

3.     Content:放置静态文件,比如xml文件、Bootstrap的CSS库。

 

下面几个文件是ASP.NET MVC新引入的:
1.     App_Start:用来放置应用初始化类,这个是MVC4引入的一个命名约定,其实这就是一个普通的文件夹,没有特殊的含义。

2.     Controllers:控制器类。

3.     Models:模型类,比如EF CodeFirst的模型定义。

4.     Views:视图文件,最初的视图引擎是WebForms View Engine,使用和ASPX文件相同的语法,而现在用的Razor视图引擎是MVC3引入的,以cshtml为后缀。

 

 

页面流程

首先看下 [About]页面:

 

这个页面之所以能够呈现在我们眼前,经历了三个主要流程:

1.     MVC的路由引擎根据URL查找相应的控制器(HomeController.cs)。

2.     控制器的操作方法About准备数据,然后传入视图Home/About.cshtml。

3.     视图准备HTML片段,放入布局页面并返回浏览器。

 

路由引擎->控制器

一切还得从Global.asax中说起,在其中的应用程序启用事件中,我们需要注册路由处理器:

protected void Application_Start(){       AreaRegistration.RegisterAllAreas();       FilterConfig.RegisterGlobalFilters(GlobalFilters.Filters);       RouteConfig.RegisterRoutes(RouteTable.Routes);       BundleConfig.RegisterBundles(BundleTable.Bundles);}


 

RouteConfig.cs类位于App_Start文件夹中,我们来看下内容:

public class RouteConfig{       public static void RegisterRoutes(RouteCollection routes)       {              routes.IgnoreRoute("{resource}.axd/{*pathInfo}");               routes.MapRoute(                     name: "Default",                     url: "{controller}/{action}/{id}",                     defaults: new { controller = "Home", action = "Index", id = UrlParameter.Optional }              );       }}


 

 

这里注册一个名为Default的路由规则,对应的URL是{controller}/{action}/{id},这里三个占位符分别表示:

1.     {controller}:控制器,默认是Home,对应的控制器类是HomeController.cs。

2.     {action}:控制器里面的方法,默认是Index。所以如果用户直接通过http://localhost/访问系统时,默认调用Home控制器中的Index方法处理。

3.     {id}:参数ID,可选项,这个参数对应于操作方法中的id参数。

 

控制器方法->视图

通过上面的介绍,我们就知道了http://localhost:55654/Home/About网址对应于Home控制器的About方法。

 

我们在Controllers/HomeController.cs中找到相应的方法:

public ActionResult About(){       ViewBag.Message = "Your application description page.";        return View();}


 

 

ViewBag是一个动态对象(dynamic),可以用来存储任意参数,用来从控制器向视图传递数据。

 

从控制器向视图传递数据一般有两种方法:

1.     传入模型,然后在视图中通过Model对象访问,这是一种强类型的方式,也是推荐的做法。其局限性就是只能传入一个模型,如果需要传入多个模型对象,就需要自定义类来包含多个模型,另一种方法就是ViewBag。

2.     ViewBag,视图包传递数据非常方便,但是在视图中可能需要进行强制类型转换。在常见的传入一个主模型和多个次模型时,可以把多次模型放到ViewBag中,从而避免自定义类的麻烦。

 

作为命名约定,这个操作方法会自动调用相应名称的视图文件About.cshtml。

视图->浏览器

下面来看About.cshtml视图文件:

@{    ViewBag.Title = "About";}<h2>@ViewBag.Title.</h2><h3>@ViewBag.Message</h3> <p>Use this area to provide additional information.</p>


 

 

以@开头用来输出C#代码的运行结果,MVC会自动判断于何处结束C#代码,并转入HTML代码。

 

需要注意,页面第一行的@{ }用来执行一段C#代码,不会输出内容,这里定义了一个ViewBag.Title的变量,并在下面的代码中使用@ViewBag.Title输出到页面中。

 

很多初学者可能有些疑惑,为啥控制器中定义了ViewBag.Message,而在视图中定义了ViewBag.Title,这两者有啥区别?

一般来说是没有功能的区别,仅仅是语义的区别。在视图中定义的变量仅在视图中使用,比如这里定义的ViewBag.Title不仅在About.cshtml中使用,而且在布局视图Shared/­_Layout.cshtml中也用到了。

 

布局视图

布局视图类似于WebForms中的母版页,具体的视图页面会作为一部分嵌入到布局视图中,然后返回到浏览器形成一个完整的页面。

 

每一个视图页面默认会使用Views/_ViewStart.cshtml中的定义的内容:

@{    Layout = "~/Views/Shared/_Layout.cshtml";}


 

 

这里面指定了布局视图的位置,我们来简单看下布局视图的内容:

<!DOCTYPE html><html><head>    <meta charset="utf-8" />    <meta name="viewport" content="width=device-width, initial-scale=1.0">    <title>@ViewBag.Title - My ASP.NET Application</title>    @Styles.Render("~/Content/css")    @Scripts.Render("~/bundles/modernizr")</head><body>    <div class="navbar navbar-inverse navbar-fixed-top">        <div class="container">            <div class="navbar-header">                <button type="button" class="navbar-toggle" data-toggle="collapse" data-target=".navbar-collapse">                    <span class="icon-bar"></span>                    <span class="icon-bar"></span>                    <span class="icon-bar"></span>                </button>                @Html.ActionLink("Application name", "Index", "Home", new { area = "" }, new { @class = "navbar-brand" })            </div>            <div class="navbar-collapse collapse">                <ul class="nav navbar-nav">                    <li>@Html.ActionLink("Home", "Index", "Home")</li>                    <li>@Html.ActionLink("About", "About", "Home")</li>                    <li>@Html.ActionLink("Contact", "Contact", "Home")</li>                </ul>            </div>        </div>    </div>    <div class="container body-content">        @RenderBody()        <hr />        <footer>            <p>© @DateTime.Now.Year - My ASP.NET Application</p>        </footer>    </div>     @Scripts.Render("~/bundles/jquery")    @Scripts.Render("~/bundles/bootstrap")    @RenderSection("scripts", required: false)</body></html>


 

 

其中head标签下面的title中使用了在About视图中定义的ViewBag.Title属性。

这个布局视图使用Bootstrap库定义的CSS样式来完成,包含标题栏,导航菜单,以及页脚的定义,具体的内容会嵌入@RenderBody()的地方,最终形成完整的HTML页面返回。

 

数据库操作

上面从控制器传入视图的数据是硬编码的一个字符串,实际项目中则经常需要从数据库中读取数据,我们使用微软推荐的Entity Framework CodeFirst开发模式来创建和使用数据库。

安装Entity Framework

首先需要安装EF,在VS2015中找到[工具]菜单,然后找到NuGet包管理器:

 

转到[浏览]选项卡,可以搜索Entity Framework,安装其最新稳定版到项目中:

 

安装后,会自动更改Web.config添加相应的配置信息。

 

 

创建模型

我们计划完成一个简单的学生管理系统,包含基本的增删改查(CRUD)。

首先在Models文件,创建学生(Student)的模型类:

public class Student{       public int ID { get; set; }       public string Name { get; set; }       public int Gender { get; set; }       public string Major { get; set; }       public DateTime EntranceDate { get; set; }}


 

 

然后创建数据库操作上下文,EF需要这个文件来创建和访问数据库:

public class StudentDbContext : DbContext{       public DbSet<Student> Students { get; set; }}


 

 

由于这个类继承自EF的DbContext基类,因此需要在文件头部添加如下引用:

using System.Data.Entity;


 

 

 

创建完这两个文件,需要重新编译项目(快捷键Ctrl+Shift+B),否则下面添加控制器时会出错。

添加控制器

在Controllers目录上点击右键,添加控制器,弹出向导对话框:

 

这里选择 MVC 5 Controller with views, using Entity Framework,然后进入设置对话框:

在这个对话框中,我们需要指定刚才创建的模型类(Student)和数据访问上下文类(StudentDbContext),然后VS不仅可以自动创建视图,而且使用EF自动创建CRUD的全部代码,是不是很酷!

 

全部功能完成了!

是不是很惊奇,我们甚至没来得及写视图代码,没有配置数据库,没有写CRUD的逻辑代码,VS模板帮我们生成了一切,现在运行一下(Ctrl+F5),并在浏览器中输入/Students:

 

表格页面

表格页面对应于Students控制器下的Index操作方法:

public class StudentsController : Controller{       private StudentDbContext db = new StudentDbContext();        // GET: Students       public ActionResult Index()       {              return View(db.Students.ToList());       }      }


 

 

首先,我们看到控制器内部定义了一个私有变量db,并进行初始化。这是数据库操作上下文实例,所有的CRUD操作都讲依赖于这个实例。

 

在Index方法中,通过向View方法传递学生列表的方式,把模型数据传递到了视图,在Views/Students/Index.cshtml视图文件中,我们声明了传入模型的类型:

@model IEnumerable<AspNetMvc.QuickStart.Models.Student>


 

 

在视图中,Model属性的类型就确定为强类型IEnumrable<Student>,配合VS提供的智能感知,不仅可以快速编写代码,并且在编译时还检查代码的有效性。

完整的Index.cshtml代码:

@model IEnumerable<AspNetMvc.QuickStart.Models.Student> @{    ViewBag.Title = "Index";} <h2>Index</h2> <p>    @Html.ActionLink("Create New", "Create")</p><table class="table">    <tr>        <th>            @Html.DisplayNameFor(model => model.Name)        </th>        <th>            @Html.DisplayNameFor(model => model.Gender)        </th>        <th>            @Html.DisplayNameFor(model => model.Major)        </th>        <th>            @Html.DisplayNameFor(model => model.EntranceDate)        </th>        <th></th>    </tr> @foreach (var item in Model) {    <tr>        <td>            @Html.DisplayFor(modelItem => item.Name)        </td>        <td>            @Html.DisplayFor(modelItem => item.Gender)        </td>        <td>            @Html.DisplayFor(modelItem => item.Major)        </td>        <td>            @Html.DisplayFor(modelItem => item.EntranceDate)        </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>


 

 

看着很有古老的ASP的感觉吧,不过这里的Model属性是强类型的,因此在foreach循环中,VS明确知道item类型是Student,从而方便代码编写:

 

@Html里面都是MVC提供的辅助方法,用来辅助生成HTML代码:

1.     ActionLink:用来生成超链接,链接到本控制器内的某个操作方法(也可以是其他控制器的方法,有重载函数),可以指定路由参数,通过对象初始化语法来创建,比如new {id=item.ID}。

2.     DisplayNameFor:显示模型属性的名称。强类型辅助方法,允许我们使用一个lambda表达式来指定某个模型属性,而不用写字符串。好处不仅有智能感知,编译时检查,而且也方便代码重构,比如我们在更改模型的属性名称时,视图中的相应代码也会改变。

3.     DisplayFor:显示模型属性的值。

新增页面

 

新增页面对应于Students控制器下的Create操作方法:

// GET: Students/Createpublic ActionResult Create(){       return View();}


 

 

对应的视图文件:

@model AspNetMvc.QuickStart.Models.Student @{    ViewBag.Title = "Create";} <h2>Create</h2> @using (Html.BeginForm()){    @Html.AntiForgeryToken()       <div class="form-horizontal">        <h4>Student</h4>        <hr />        @Html.ValidationSummary(true, "", new { @class = "text-danger" })        <div class="form-group">            @Html.LabelFor(model => model.Name, htmlAttributes: new { @class = "control-label col-md-2" })            <div class="col-md-10">                @Html.EditorFor(model => model.Name, new { htmlAttributes = new { @class = "form-control" } })                @Html.ValidationMessageFor(model => model.Name, "", new { @class = "text-danger" })            </div>        </div>                           @* 省略 Gender Major EntranceDate *@               <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")}


 

首先定义了视图中使用的模型类型是Student,这样LabelFor强类型辅助方法就可以从模型元数据中获取需要显示的文本。

 

页面打开时,由于并未传入任何模型对象,所以Model为空对象,如下所示:

所以页面上默认的输入框都是空的,截图中是作者输入值后的效果。

 

Html.BeginForm()会在页面上生成一个form标签,默认的提交地址还是当前页面(action=/Students/Create),默认的请求方法是post,如下所示:

 

因此,点击[Create]按钮时,会发出一个POST请求到后台,对应于Students控制器的Create方法。

保存数据与模型绑定

下面我们来看下拥有[HttpPost]元数据的Create方法:

[HttpPost][ValidateAntiForgeryToken]public ActionResult Create([Bind(Include = "ID,Name,Gender,Major,EntranceDate")] Student student){       if (ModelState.IsValid)       {              db.Students.Add(student);              db.SaveChanges();              return RedirectToAction("Index");       }        return View(student);}


 

 

这里面有两个安全措施:

1.     ValidateAntiForgeryToken:用来阻止CSRF(跨站请求伪造)。

2.     Bind:用来阻止Over-Posting(过多提交攻击)。

这两个安全手段我们会在以后的文章中详细介绍,这里就先略过。

 

我们先看下本次请求的POST参数:

 

但是Create方法中只有一个Student对象参数,是不是很神奇,其实这是一个重要的概念模型绑定

 

如果在WebForms中,我们可以会写一堆代码来从Request.Form中获取参数,并重建Student对象,类似如下代码:

Student student = new Student();student.Name = Request.Form["Name"];student.Gender = Convert.ToInt32(Request.Form["Gender"]);....


 

 

在MVC中,这一过程是自动完成,简单来说这就是模型绑定。

 

但是实际的模型绑定过程,不仅在请求的表单数据中查找,还会在路由参数,URL查询字符串,以及Cookie中查找。

 

如果模型绑定失败(比如模型参数不符合验证规则),则ModelState.IsValid就为false,这时会直接返回页面内容,此时模型对象student中保存的是用户输入的值,前端也会有错误提示,这个过程我们会在下一篇文章中讲解。

 

如果模型绑定成功,则保存新增数据,然后通过RedirectToAction来重定向到表格页面:
内容来自用户分享和网络整理,不保证内容的准确性,如有侵权内容,可联系管理员处理 点击这里给我发消息
标签: