创建自定义路由约束(C#)

这篇教程要演示如何创建自定义路由约束。自定义路由约束能够使路由只有达到某些自定义条件时才会匹配。

在这篇教程里，我们创建一个 Localhost 路由约束。 它只匹配从本地计算机发出的请求。通过Internet发送的远程请求不被匹配。

要实现自定义路由约束就要实现 IRouteConstraint接口。这个接口极其简单，就描述了一个简单方法：

bool Match( HttpContextBase httpContext, Route route, string parameterName, RouteValueDictionary values, RouteDirection routeDirection )

方法返回一个布尔值。返回false的话，被约束的路由不匹配浏览器请求。

Localhost约束见代码 1.

代码1 – LocalhostConstraint.cs

using System.Web; 
using System.Web.Routing; 
namespace MvcApplication1.Constraints 
{ 
    public class LocalhostConstraint : IRouteConstraint
   {
      public bool Match ( HttpContextBase httpContext, Route route, string parameterName, RouteValueDictionary values, RouteDirection routeDirection ) 
      { 
          return httpContext.Request.IsLocal; 
      } 
   } 
} 

代码1的约束利用了由HttpRequest类暴露的 IsLocal属性。当请求的IP地址是127.0.0.1或者与服务器IP地址一样时，这个属性就返回true。

使用在Global.asax文件中定义的自定义约束。代码2中的 Global.asax 文件使用了 Localhost 约束来防止来自Admin页的任何请求，除非它们是从本地服务器发出的。例如，从远程服务器发送 /Admin/DeleteAll 请求将会失败。

代码2 – Global.asax

using System;
using System.Collections.Generic;
using System.Linq;
using System.Web;
using System.Web.Mvc;
using System.Web.Routing;
using MvcApplication1.Constraints;
namespace MvcApplication1
{
    public class MvcApplication : System.Web.HttpApplication
    {
        public static void RegisterRoutes(RouteCollection routes)
        {
            routes.IgnoreRoute("{resource}.axd/{*pathInfo}");
            routes.MapRoute("Admin",
               "Admin/{action}",
               new { controller = "Admin" }, new { isLocal = new LocalhostConstraint() });
            //routes.MapRoute( 
            // "Default",
            // Route name
            // "{controller}/{action}/{id}", 
            // URL with parameters
            // new { controller = "Home", action = "Index", id = "" }
            // Parameter defaults 
            //); 
        }

        protected void Application_Start()
        {
            RegisterRoutes(RouteTable.Routes);
        }
    }
}

Localhost 约束被用在Admin路由的定义上。这个路由不会被远程浏览器请求所匹配。然而，其他定义在Global.asax中的路由有可能匹配相同的请求。重点理解的是，约束只防止特定的一个路由匹配请求而不是Global.asax文件中定义的所有路由。

注意 Default 路由在代码2中已经被注释掉了。如果你包括了 Default 路由，那么 Default 路由会匹配Admin控制器的的请求。在这种情况下，远程用户仍然可以调用Admin控制器的action，即使它们的请求不会匹配Admin路由。

原文地址：http://www.asp.net/learn/mvc/tutorial-25-cs.aspx