控制器
最后更新于:2022-04-01 16:29:08
MVC代表: *模型-视图-控制器* 。MVC是一个架构良好并且易于测试和易于维护的开发模式。基于MVC模式的应用程序包含:
· **M**odels: 表示该应用程序的数据并使用验证逻辑来强制实施业务规则的**数据类**。
· **V**iews: 应用程序动态生成 HTML所使用的模板文件。
· **C**ontrollers: 处理浏览器的请求,取得数据模型,然后指定要响应浏览器请求的视图模板。
本系列教程,我们将覆盖所有这些概念,并告诉您如何在ASP.NET MVC 5中使用它们来构建应用程序。
首先,让我们创建一个控制器类。在**解决方案资源管理器中**,用鼠标右键单击控制器文件夹(*Controllers* ),然后选择“**添加控制器“**。
[![clip_image002](https://docs.gechiui.com/gc-content/uploads/sites/kancloud/2016-01-02_568736b336a5c.jpg "clip_image002")](http://images.cnitblog.com/blog/139239/201311/14104030-f1d61d487b6e40c99874d02a8d21568d.jpg)
在添加**Scaffold**对话框,单击**MVC5控制器 - 空**,然后单击“**添加**”。
[![clip_image004](https://docs.gechiui.com/gc-content/uploads/sites/kancloud/2016-01-02_568736b34d3bd.gif "clip_image004")](http://images.cnitblog.com/blog/139239/201311/14104034-5c762e7c290a42a984763831f72d75d8.gif)
命名新的控制器为“HelloWorldController”,并单击“ 添加“。
[![clip_image006](https://docs.gechiui.com/gc-content/uploads/sites/kancloud/2016-01-02_568736b3668d3.gif "clip_image006")](http://images.cnitblog.com/blog/139239/201311/14104035-3005bdcdfa61486497b7a557684bf484.gif)
请注意,在**解决方案资源管理器中**会创建一个名为*HelloWorldController.cs*的新文件和一个新的文件夹*Views\HelloWorld*。该文件会被IDE默认打开。
[![clip_image008](https://docs.gechiui.com/gc-content/uploads/sites/kancloud/2016-01-02_568736b37bece.gif "clip_image008")](http://images.cnitblog.com/blog/139239/201311/14104037-67b0ff0eb9524f4ba8ef380f8b3a0578.gif)
用下面的代码替换该文件中的内容。
~~~
using System.Web;
using System.Web.Mvc;
namespace MvcMovie.Controllers
{
public class HelloWorldController : Controller
{
//
// GET: /HelloWorld/
public string Index()
{
return "This is my <b>default</b> action...";
}
//
// GET: /HelloWorld/Welcome/
public string Welcome()
{
return "This is the Welcome action method...";
}
}
}
~~~
在这个例子中控制器方法将返回一个字符串的HTML。本控制器被命名HelloWorldController代码中的第一种方法被命名为Index。让我们从浏览器中调用它。运行应用程序(按F5或CTRL + F5)。在浏览器的地址栏中输入路径“HelloWorld“。(例如,在下面的示例中:[http://localhost:1234/HelloWorld](http://localhost:1234/HelloWorld))页面在浏览器中的表现如下面的截图。在上面的方法中,代码直接返回了一个字符串。你告诉系统只返回一些HTML,系统确实这样做了!
[![clip_image002[4]](https://docs.gechiui.com/gc-content/uploads/sites/kancloud/2016-01-02_568736b38d2cc.jpg "clip_image002[4]")](http://images.cnitblog.com/blog/139239/201311/14104052-fde5f79a3c44460ea7f29a0aad8dded0.jpg)
ASP.NET MVC会调用不同的控制器类(和其内部不同的操作方法)这取决于传入URL。所使用的ASP.NET MVC的默认URL路由逻辑使用这样的格式来判定哪些代码以便调用:
/[Controller]/[ActionName]/[Parameters]
你也可在*App_Start/RouteConfig.cs *文件内通过配置URL路由解析规则:
~~~
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 }
);
}
~~~
如果您运行应用程序并没有提供任何URL段的,默认为“Home”的控制器和“Index”的操作方法,在上面的代码中的defaults部分指定的:
- 第一部分的URL确定哪个控制器类会被执行。因此 */HelloWorld*映射到HelloWorldController控制器类。
- 第二部分的URL确定要执行控制器类中的那个操作方法。因此 */HelloWorld/Index,*会使得`HelloWorldController`控制器类的Index 方法被执行。请注意,我们只需要浏览*/HelloWorld*路径,默认情况下会调用Index方法。如果没有明确的指定操作方法,Index方法会默认的被控制器类调用。
- 第三部分的URL段(Parameters参数)是路由数据。在本教程中,稍后我们将看到路由数据。
浏览*http://localhost:xxxx/HelloWorld/Welcome。*Welcome方法会被运行并返回字符串:"This is the Welcome action method...”。 默认的MVC映射为/[Controller]/[ActionName]/[Parameters] 对于这个URL,控制器类是HelloWorld,操作方法是Welcome,您还没有使用过URL的[Parameters] 部分。
[![image](https://docs.gechiui.com/gc-content/uploads/sites/kancloud/2016-01-02_568736b3a09b1.png "image")](http://images.cnitblog.com/blog/139239/201311/14104058-cfe64bd304b6420fae3fef7614acada5.png)
让我们稍微修改一下这个例子,以便可以使用URL传递一些参数信息给控制器类(例如, */HelloWorld/Welcome?name=Scott&numtimes=4*)。改变您的Welcome 方法来包含两个参数,如下所示。需要注意的是,示例代码使用了C#语言的可选参数功能,numTimes参数在不传值时,默认值为1。
~~~
public string Welcome(string name, int numTimes = 1) {
return HttpUtility.HtmlEncode("Hello " + name + ", NumTimes is: " + numTimes);
}
~~~
安全注意事项: 上面的代码使用了 HttpServerUtility.HtmlEncode 来保护应用从malacious输入的(也就是JavaScript). 有关详细信息,请参阅How to: Protect Against Script Exploits in a Web Application by Applying HTML Encoding to Strings.
运行您的应用程序并浏览此URL(*http://localhost:xxxx/HelloWorld/Welcome?name=Scott&numtimes=4)*。你可以对参数name 和numtimes 尝试不同的值。[ASP.NET MVC model binding system](http://odetocode.com/Blogs/scott/archive/2009/04/27/6-tips-for-asp-net-mvc-model-binding.aspx) 会自动将地址栏中URL里的 query string映射到您方法中的参数。
[![clip_image002[6]](https://docs.gechiui.com/gc-content/uploads/sites/kancloud/2016-01-02_568736b3b96c9.jpg "clip_image002[6]")](http://images.cnitblog.com/blog/139239/201311/14104100-8bd3ac70e76c4d5db44205dad507c3cf.jpg)
上面的例子,没有用到URL段参数的部分( Parameters)。 通过[query strings](http://en.wikipedia.org/wiki/Query_string)传递name 和 numTimes的参数.
用下面的代码替换“Welcome”的方法:
~~~
public string Welcome(string name, int ID = 1)
{
return HttpUtility.HtmlEncode("Hello " + name + ", ID: " + ID);
}
~~~
运行应用程序并输入以下网址URL: *http://localhost:xxx/HelloWorld/Welcome/3?name=Rick*
[![clip_image002[5]](https://docs.gechiui.com/gc-content/uploads/sites/kancloud/2016-01-02_568736b3cdf37.gif "clip_image002[5]")](http://images.cnitblog.com/blog/139239/201311/14104102-87f8fba9c24c469a95b9439f20893d77.gif)
这次URL第三部分的参数匹配了参数ID。
通过查看下面的RegisterRoutes路由规则函数:
~~~
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 }
);
}
~~~
在ASP.NET MVC应用程序,通过参数传递路由数据是为更典型的应用(如同上面用query string传递 ID参数)。您还可以增加一条路由来传递name 和numtimes ,在路由数据在URL中的参数。在App_Start\RouteConfig.cs file文件中,添加“Hello”的的路由:
~~~
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 }
);
routes.MapRoute(
name: "Hello",
url: "{controller}/{action}/{name}/{id}"
);
}
}
~~~
运用应用程序,在浏览器输入:/localhost:XXX/HelloWorld/Welcome/Scott/3.
[![clip_image002[7]](https://docs.gechiui.com/gc-content/uploads/sites/kancloud/2016-01-02_568736b3dfb2a.gif "clip_image002[7]")](http://images.cnitblog.com/blog/139239/201311/14104117-b10bbb104bec48ad87c752f40bdc170e.gif)
对于众多MVC应用程序的缺省默认的路由可以正常工作。稍后您将学习本教程中通过使用模型绑定的数据,你就不必修改缺省的路由。
在上面的例子中,控制器一直在做着MVC中“VC”部分的职能:也就是视图和控制器的工作。该控制器直接返回HTML内容。通常情况下,您不会让控制器直接返回HTML,因为这样代码会变得非常的繁琐。相反,我们通常会使用一个单独的视图模板文件来帮助生成返回的HTML。让我们来看看下面我们如何能做到这一点吧。
# ASP.NET MVC 5 系列文章
1. [ASP.NET MVC 5-开始MVC5之旅](http://www.cnblogs.com/powertoolsteam/p/aspnet-mvc5-getting-started.html)
1. [ASP.NET MVC 5 - 控制器](http://www.cnblogs.com/powertoolsteam/p/aspnet-mvc5-controller.html)
原文地址:[http://www.asp.net/mvc/tutorials/mvc-5/introduction/adding-a-controller](http://www.asp.net/mvc/tutorials/mvc-5/introduction/adding-a-controller)