【译】ASP.NET MVC 5 教程 - 2:添加控制器
MVC 表示 模型-视图-控制器。MVC 是一种用于开发应用程序的模式,具备良好架构,可测试和易于维护。基于 MVC 应用程序中包含:
- Models: 表示应用程序的数据,并使用验证逻辑强制执行业务规则的数据的类。
- Views: 您的应用程序用来动态生成 HTML 响应的模板文件。
- Controllers: 处理传入的请求的浏览器,类检索模型的数据,然后指定将响应返回到浏览器中的视图模板。
在这个系列教程中涵盖了所有这些概念和教你怎么使用它们构建应用程序。
让我们开始创建一个控制器类。在 解决方案资源管理器中,右键单击 Controllers 文件夹,然后单击 添加,然后支架。
添加支架对话框中,单击MVC 5 控制器-空,然后单击添加。
注意在 解决方案资源管理器 已创建的新文件命名 HelloWorldController.cs。在 IDE 中打开该文件。
写入下面的代码:
1 using System.Web; 2 using System.Web.Mvc; 3 4 namespace MvcMovie.Controllers 5 { 6 public class HelloWorldController : Controller 7 { 8 // 9 // GET: /HelloWorld/ 10 11 public string Index() 12 { 13 return "This is my <b>default</b> action..."; 14 } 15 16 // 17 // GET: /HelloWorld/Welcome/ 18 19 public string Welcome() 20 { 21 return "This is the Welcome action method..."; 22 } 23 } 24 }
示例中,控制器的类名为 HelloWorldController
,继承于:Controller,上述第一种方法为 Index
。让我们从浏览器中调用它。运行该应用程序 (按 F5 或 Ctrl + F5)。在浏览器中,将"HelloWorld"添加到地址栏上的路径后面 。(例如,在图中,它下面的 http://localhost:1234/HelloWorld.)页面在浏览器中的将看到如下图所示的页面。在上述方法中,代码直接返回一个字符串。
ASP.NET MVC 会根据传入的 URL 调用不同的控制器类 (以及其中的不同操作方法)。ASP.NET MVC 所使用的默认 URL 路由逻辑使用这样的格式来确定哪些代码来调用:
/[Controller]/[ActionName]/[Parameters]
在App_Start/RouteConfig.cs文件中可以设置路由的格式。
1 public static void RegisterRoutes(RouteCollection routes) 2 { 3 routes.IgnoreRoute("{resource}.axd/{*pathInfo}"); 4 5 6 7 8 routes.MapRoute( 9 name: "Default", 10 url: "{controller}/{action}/{id}", 11 defaults: new { controller = "Home", action = "Index", id = UrlParameter.Optional } 12 ); 13 }
当您运行该应用程序并不提供任何 URL 部分时,它将默认的"Home"的控制器和上面代码的默认值部分中指定的"Index"的操作方法。
URL 的第一部分确定要执行的控制器类。所以 /HelloWorld 映射到 HelloWorldController
类。第二部分 URL 的确定要执行的类上的操作方法。所以 /HelloWorld/Index 会找到 HelloWorldController
类的 Index
的方法执行。请注意,我们只在浏览器中看到 /HelloWorld,而并无 Index
。这是因为命名 Index
的方法被指定一个称为控制器的默认方法。URL 段 ( Parameters
) 的第三部分是用于路由数据。我们将在本教程中稍后看到路由配置的资料。
下面在浏览中打开 http://localhost:xxxx/HelloWorld/Welcome。 Welcome
方法运行,并返回字符串"This is my default action..."。MVC 的默认映射是 /[Controller]/[ActionName]/[Parameters]
。对于这个 URL,控制器是 HelloWorld
,而 Welcome
是操作方法。您还没有使用 URL 的 [Parameters]
部分。
让我们将此示例稍微修改一下,以便您可以将一些参数信息从 URL 中传递给控制器 (例如, /HelloWorld/Welcome?name=Scott&numtimes=4)。更改您 Welcome
方法,包括两个参数,如下所示。请注意,该代码使用 C# 的可选参数功能来指示:当没有为 numTimes
参数传递值时,该参数的默认值应为 1。
1 public string Welcome(string name, int numTimes = 1) { 2 return HttpUtility.HtmlEncode("Hello " + name + ", NumTimes is: " + numTimes); 3 }
运行您的应用程序,然后在浏览中打开 URL (http://localhost:xxxx/HelloWorld/Welcome?name=Scott&numtimes=4)。在 URL 中您可以尝试不同的值 name
和 numtimes
。在ASP.NET MVC 模型绑定系统 从地址栏中命名的参数将自动映射给您的方法中指定的参数。
在上面的示例中,不使用 URL 段 ( Parameters
),作为查询字符串传递的name
和numTimes
参数。
Welcome方法替换为以下代码:
1 public string Welcome(string name, int ID = 1) 2 { 3 return HttpUtility.HtmlEncode("Hello " + name + ", ID: " + ID); 4 }
运行应用程序,然后输入以下 URL: http://localhost:xxx/HelloWorld/Welcome/3?name=Rick
这次 URL 的第三个部分匹配ID
,因为Welcome
的操作方法有一个匹配的 URL 规范在RegisterRoutes
方法中的参数 (ID
)。
1 public static void RegisterRoutes(RouteCollection routes) 2 { 3 routes.IgnoreRoute("{resource}.axd/{*pathInfo}"); 4 5 6 7 8 routes.MapRoute( 9 name: "Default", 10 url: "{controller}/{action}/{id}", 11 defaults: new { controller = "Home", action = "Index", id = UrlParameter.Optional } 12 ); 13 }
在 ASP.NET MVC 应用程序中,这是默认的路由配置 (像刚才那样用 ID)。您也可以添加一个路由,这两个name
传递给 和 numtimes
作为路由数据的 URL 中的参数。在App_Start\RouteConfig.cs文件中,添加"Hello"的路由配置:
1 public class RouteConfig 2 { 3 public static void RegisterRoutes(RouteCollection routes) 4 { 5 routes.IgnoreRoute("{resource}.axd/{*pathInfo}"); 6 7 8 9 10 routes.MapRoute( 11 name: "Default", 12 url: "{controller}/{action}/{id}", 13 defaults: new { controller = "Home", action = "Index", id = UrlParameter.Optional } 14 ); 15 16 17 18 19 routes.MapRoute( 20 name: "Hello", 21 url: "{controller}/{action}/{name}/{id}" 22 ); 23 } 24 }
在浏览器中打开 /localhost:XXX/HelloWorld/Welcome/Scott/3
.
对于许多的 MVC 应用程序都默认路由来正常工作。稍后在本教程中,通过使用模型程序,数据,您将了解到,所以一般不必修改默认路由。