ASP.NET MVC 从零开始 - create and run
这篇文章是从我的 github 博客 http://lxconan.github.io 导入的。
如果你想用 ASP.NET MVC 创建一个网络应用，那么你可以搜到很多的文章。但是没有多少文章告诉你，如何从零开始创建一个 ASP.NET MVC 应用程序。这对我们是非常有害的，我们希望了解每一个细节，搞清 Components 之间的联系。然后，再放心的使用向导创建 ASP.NET MVC 应用程序。需要表明一点的是，我说的从零开始，是从零开始一步一步创建 App，我希望你应该熟悉 C#，并至少对 ASP.NET MVC 多多少少有些了解。
我们将使用 ASP.NET MVC 5，因此请至少准备好一个支持 .NET 4.5 的 Visual Studio 版本（2012 或者 2013）。如果没有银子购买专业版或者以上版本，那么用免费的 Express 版本也是不错的。
首先我们要创建一个空白的 Web Application。打开 visual studio 并创建一个空白的 Web Application。为了照顾新同学我大发善心的告诉你，应该选择 ASP.NET Empty Web Application。微软会非常友好的添加一大堆你可能一辈子都用不着的程序集引用。因此我们第一件事儿就是删掉他们。删到如下程度为止：
Solution
|-Homework.App
|-Properties
| |-AssemblyInfo.cs
|-References
| |-System
| |-System.Core
|-Web.config安装 ASP.NET MVC 5 Packages
在前几个 ASP.NET MVC 版本的时候，你需要从官方网站上下个包，然后点 Setup 然后……总之一切都显得有点儿不专业，好在现在不用了。打开 nuget manager ，安装 Microsoft ASP.NET MVC，或者在 package management console 里面输入：
Install-Package Microsoft.AspNet.Mvc -Version 5.0.0这个 package 会安装以下三个依赖包：Microsoft ASP.NET Razor、Microsoft ASP.NET Web Pages 以及 Microsoft Web Infrastructure。以下的东西不用记，如果有兴趣，你可以当看小说似的看一下：
- 其中第一个包是 ASP.NET MVC 的 Razor 的语言解析器，用于将 .cshtml 的服务端页面解析为抽象语法树，并提供编辑器支持。
- 第二个包，也就是
ASP.NET Web Pages，提供了 ASP.NET MVC 服务端页面编辑需要的各种辅助工具。- 例如，防止 XSS 和 CSRF 攻击的辅助类型（参见
System.Web.Helpers、System.Web.Helpers.AntiXsrf名字空间） - Model 的客户端验证类型（就是类似“必须填写”，“必须在xxx范围之内”这种东西，当然，我对这些东西不抱有好感），以及最基本的 HTML 元素输出的支持（
TagBuilder，这可是个好同志，如果你不用他书写自己的HtmlHelper扩展方法，而是还在用string.Format()输出 HTML，那么，快去改掉那些该死的代码）。这些都在System.Web.Mvc名字空间里。 - 服务端页面的基本类型：
WebPageBase。你可能惊讶的发现了一个名为WebPage的类型，并且里面还有Model，Layout等你耳熟能详的属性，你兴奋的以为你找到了组织但是我只能告诉你你搞错了。这个WebPage真的是一坨 Rubbish。真正的 ASP.NET MVC WebPage 在System.Web.Mvc.WebViewPage里，这是一个为了向下兼容而遗留下来的历史问题。 - Razor 服务端页面的编译逻辑（在
System.Web.WebPages.Razor里）。 - 一些好用的和过时了的页面辅助类型（请看
System.Web.Helpers）。这里加入我的个人吐槽，如果你以后创建了一个 Framework，那么千万不要把辅助类加到你的 Framework 的包中，而是当作一个附加的包供大家自由下载使用。否则为了向后兼容性你不得不让这些丑陋的设计一直存在下去，并被持续吐槽。
- 例如，防止 XSS 和 CSRF 攻击的辅助类型（参见
- 第三个包，也就是
Microsoft Web Infrastructure提供了 ASP.NET 的基础架构——才怪！里面充斥了对反射功能的封装（服务端页面需要这些特性）和系统环境的检查（例如注册表）。总之，加上它，ASP.NET MVC 需要它，但是我们不会使用它。
安装好以后我们的工程看起来貌似有些料了：
Solution
|-Homework.App
|-Properties
| |-AssemblyInfo.cs
|-References
| |-Microsoft.Web.Infrastructure
| |-System
| |-System.Core
| |-System.Web.Helpers
| |-System.Web.Mvc
| |-System.Web.Razor
| |-System.Web.WebPages
| |-System.Web.WebPages.Deployment
| |-System.Web.WebPages.Razor
|-Web.config创建基本工程结构
Convension over configuration 是目前大家偏好的设计形式，Rails 在这方面非常典型，其他的 MVC Framework 也在这样做。那么我们就按照这种约定创建工程结构吧。
- 首先我们需要一个 Controllers 名字空间来存放（默认 Area，我们以后会涉及 Area 这个概念） 下面的 Controllers 类型；
- 另外我们需要一个 Views 文件夹来存放服务端页面。
像这样：
Solution
|-Homework.App
|-Properties
| |-AssemblyInfo.cs
|-References
| |-Microsoft.Web.Infrastructure
| |-System
| |-System.Core
| |-System.Web.Helpers
| |-System.Web.Mvc
| |-System.Web.Razor
| |-System.Web.WebPages
| |-System.Web.WebPages.Deployment
| |-System.Web.WebPages.Razor
|-Controllers
|-Views
|-Web.configHello World
看标题你就知道激动人心的时刻即将来临了。让我们开始最后的冲刺吧。我们要添加一个 HomeController，然后添加一个 View，View 上书写着不变的咒语：Hello World。
这个过程网络上的文章多如牛毛，我就简述了，总之你应该得到如下的工程结构：
Solution
|-Homework.App
|-Properties
| |-AssemblyInfo.cs
|-References
| |-Microsoft.Web.Infrastructure
| |-System
| |-System.Core
| |-System.Web.Helpers
| |-System.Web.Mvc
| |-System.Web.Razor
| |-System.Web.WebPages
| |-System.Web.WebPages.Deployment
| |-System.Web.WebPages.Razor
|-Controllers
| |-HomeController.cs
|-Views
| |-Home
| |-Index.cshtml
|-Global.asax
| |-Global.asax.cs
|-Web.config以上的内容我认为唯一可能出问题的就是如何创建 Global.asax 文件，单击右键，选择创建 Glboal Application Class 就可以了。
下面我们简单过一下新添加的文件的内容。其中，Index.cshtml 中的内容应该是类似这样的：
@inherits System.Web.Mvc.WebViewPage
@{
Layout = null;
}
<!DOCTYPE html>
<html>
<head>
<title>Index</title>
</head>
<body>
<h1>Hello World!</h1>
</body>
</html>这里我们有必要解释几句。第一行，也就是 @inherits System.Web.Mvc.WebViewPage 这句话描述了当前页面的类型是 System.Web.Mvc.WebViewPage。我们之前说到了，所有的 ASP.NET MVC 页面的基础类型是 WebPage，而 WebViewPage 是 WebPage 的一个派生类，他提供了 MVC 的页面需要的所有方法和属性，例如 Model 属性，Html 属性，Layout 属性。
第二行，也就是 @{ Layout = null; } 这一行，说明了我们这个服务端页面的所有布局信息都在这里，没有母板页的影响。关于 Layout我们后续文章会有涉及。
接下来我们看看 HomeController，它里面的内容是这样的。
using System.Web.Mvc;
namespace Homework.App.Controllers
{
[RoutePrefix("home")]
public class HomeController : Controller
{
[Route("")]
public ActionResult Index()
{
return View();
}
}
}HomeController 类中仅仅包含一个 GET 方法 Index() 他直接返回了 View() 这样，ASP.NET MVC 将依据 Home/Index.cshtml 的内容生成页面并返回给客户端。
哦，我敢肯定你发现了什么不同：[RoutePrefix] 和 [Route] 是个什么东西，原来的 Route 不是需要用 RouteCollection.MapRoute() 方法注册吗？漂亮！这是 ASP.NET MVC 5 提供的新特性（从 sinatra 抄过来的，不过我一点没有鄙夷的意思，因为 ASP.NET MVC 在不断的改进。大家一直都在互相抄，当一个新的语言或者 Framework 形成的时候，大家做的第一件事情就是把我们在其他语言和 Framework 上做的工作完完整整的重新抄一遍）。
问题是，原来我们需要在 Web 应用程序启动的时候使用 RouteTable.Routes.MapRoute() 指定路由的模版，那么现在要怎么做呢？请打开 Global.asax.cs 文件，删掉那些不用的方法，只留下如下的内容。
using System;
using System.Web;
using System.Web.Mvc;
using System.Web.Routing;
namespace Homework.App
{
public class Global : HttpApplication
{
protected void Application_Start(object sender, EventArgs e)
{
RouteTable.Routes.MapMvcAttributeRoutes();
}
}
}Application_Start 方法会在应用程序启动的时候调用，而其中的 RouteTable.Routes.MapMvcAttributeRoutes(); 就是在声明我们将使用 Attribute 进行路由的解析。
你是否迫不及待的按下了 Ctrl + F5 并且看到了期待已久的 Hello World？恭喜你！在下一节中我们将讨论一些 web.config 的配置的问题。