RouteCollectionExtensions.MapRoute 方法 (ASP.NET设置路由)
重载列表
| 名称 | 说明 | |
|---|---|---|
  |
MapRoute(RouteCollection, String, String) | 映射指定的 URL 路由。 |
|
MapRoute(RouteCollection, String, String, Object) | 映射指定的 URL 路由并设置默认路由值。 |
|
MapRoute(RouteCollection, String, String, String[]) | 映射指定的 URL 路由并设置命名空间。 |
|
MapRoute(RouteCollection, String, String, Object, Object) | 映射指定的 URL 路由并设置默认路由值和约束。 |
|
MapRoute(RouteCollection, String, String, Object, String[]) | 映射指定的 URL 路由并设置默认的路由值和命名空间。 |
|
MapRoute(RouteCollection, String, String, Object, Object, String[]) | 映射指定的 URL 路由并设置默认的路由值、约束和命名空间。 |
public static Route MapRoute( this RouteCollection routes, string name, string url, Object defaults, Object constraints, string[] namespaces )
参数
- routes
- 类型：System.Web.Routing.RouteCollection
应用程序的路由的集合。
- name
- 类型：System.String
要映射的路由的名称。
- url
- 类型：System.String
路由的 URL 模式。
- defaults
- 类型：System.Object
一个包含默认路由值的对象。
- constraints
- 类型：System.Object
一组表达式，用于指定 url 参数的值。
- namespaces
- 类型：System.String[]
应用程序的命名空间集合。
使用说明
在 Visual Basic 和 C# 中，可以在 RouteCollection 类型的任何对象上将此方法作为实例方法来调用。当使用实例方法语法调用此方法时，请省略第一个参数。
当创建好一个mvc应用后，应用已经被配置好可以用asp.net routing了。ASP.NET MVC路由在两个地方被激发。
一、asp.net routing在web.config中被激活，有关route的配置有四个配置节：system.web.httpModules , system.web.httpHandlers , system.webserver.modules, the system.webserver.handlers，删除这些配置节时要小心，因为没有它们routing将不再工作。
二、更重要的是，在global.asax文件中已经创建了路由表，global.asax是一个包含了asp.net应用生命周期内事件句柄的特殊文件。路由表在Application Start 事件中被创建。
- using System;
- using System.Collections.Generic;
- using System.Linq;
- using System.Web;
- using System.Web.Mvc;
- using System.Web.Routing;
- namespace MvcApplication1
- {
- publicclass MvcApplication : System.Web.HttpApplication
- { //使ASP.NET有实例化MvcHandler的能力
- publicstaticvoid RegisterRoutes(RouteCollection routes)
- { //使路由系统忽略处理ASP.NET的Web资源文件(WebResource.axd或 ScriptResource.axd).
- routes.IgnoreRoute("{resource}.axd/{*pathInfo}");
- //对RouteCollection添加的扩展方法
- routes.MapRoute(
- "Default",
- "{controller}/{action}/{id}",
- new { controller = "Home", action = "Index", id = "" }
- );
- }
- protectedvoid Application_Start()
- {
- RegisterRoutes(RouteTable.Routes);
- }
- }
- }
当程序运行后，Application_Start() 方法被调用，同时调用方法内的RegisterRoutes() 方法。这个方法创建了路由表。
默认的ASP.NET MVC路由表中只含有一个叫做default的路由。这个默认路由把url拆分成三个部分分别对应controller，action和View。
当请求URL：/Home/Index/3时，下列代码执行:HomeController.Index(3)。
如果不指定controller，则默认为Home，不指定Action则默认为Index，不指定参数则默认为空。
我们将通过例子来看一下到底默认路由是怎么把URl映射到controller和action的。想象我们在地址栏中输入了如下URL：/Home
由于默认action为Index，所以下面的方法被调用
- using System.Web.Mvc;
- namespace MvcApplication1.Controllers
- {
- [HandleError]
- publicclass HomeController : Controller
- {
- public ActionResult Index(string id)
- {
- return View();
- }
- }
- }
这个方法接受一个字符串类型的id参数，上面的URL执行了这个方法，传入一个空的id。
由于mvc框架引用controller actions的方式，/Home同时也会触发下列事件
- using System.Web.Mvc;
- namespace MvcApplication1.Controllers
- {
- [HandleError]
- publicclass HomeController : Controller
- {
- public ActionResult Index()
- {
- return View();
- }
- }
- }
这个方法不接受参数，/Home将触发这个Index（），同时/Home/Index/3也会调用这个方法，id参数将被忽略。
/Home也会与下面的方法匹配
- using System.Web.Mvc;
- namespace MvcApplication1.Controllers
- {
- [HandleError]
- publicclass HomeController : Controller
- {
- public ActionResult Index(int? id)
- {
- return View();
- }
- }
- }
该方法接受一个int类型的参数id,因为这个参数可以为null，该方法将被调用而不会产生任何错误。
最后调用下面的方法，这里会引发一个异常
- using System.Web.Mvc;
- namespace MvcApplication1.Controllers
- {
- [HandleError]
- publicclass HomeController : Controller
- {
- public ActionResult Index(int id)
- {
- return View();
- }
- }
- }
因为这个参数是不可以为null的。
MapRoute方法
public static Route MapRoute(
this RouteCollection routes,
string name,
string url,
Object defaults,
Object constraints,
string[] namespaces
)
name:路由在路由列表里的唯一名字(两次MapRoute时name不能重复)
url:路由匹配的url格式
defaults:路由url {占位符} 的默认值
constraints:url的 {占位符} 的约束
namespaces:这个是用于设置路由搜索的控制器命名空间!
例：
routes.MapRoute(
"constraints", //name "{controller}/{action}", //url null, //defaults new { controller = @"[a-z]{4,}", //controller必须为英文字符,最少长度为4 action = @"[a-z]{4,}" //action必须为英文字符,最少长度为4 }, //constraints null //namespaces);建立有Area时路由的注册情况:
