ASP.NET WebForms MapPageRoute 路由配置

MapPageRoute 应该是 ASP.NET 4.0 中的东西，但现在我是第一次使用它，使用场景是：MVC 混合使用 WebForm，然后对 WebForm 进行路由配置，当然也可以使用 ISAPI_Rewrite 3，不同的是要在 IIS 中配置，相对而言，MapPageRoute 在程序中进行配置更加灵活方便，下面是关于 MapPageRoute 的简单整理。

1. 最简单：

public class MvcApplication : System.Web.HttpApplication
{
    protected void Application_Start()
    {
        RouteTable.Routes.MapPageRoute("WebFormRoute",
            "test",
            "~/WebForm1.aspx");
    }
}

public partial class WebForm1 : System.Web.UI.Page
{
    protected void Page_Load(object sender, EventArgs e)
    {
        Response.Write("hello world!");
    }
}

效果：

2. 带参数：

public class MvcApplication : System.Web.HttpApplication
{
    protected void Application_Start()
    {
        RouteTable.Routes.MapPageRoute("WebFormRoute",
            "test/{para}",
            "~/WebForm1.aspx");
    }
}

public partial class WebForm1 : System.Web.UI.Page
{
    protected void Page_Load(object sender, EventArgs e)
    {
        Response.Write("hello world! <br />");
        Response.Write("para: " + Page.RouteData.Values["para"]);
    }
}

效果：

注意：

当我们使用参数映射的时候，在获取参数值使用的是 Page.RouteData.Values，而不是 Request.QueryString，有一种情况是，如果你的 Url 映射还是 WebForm1.aspx 文件名的形式，只不过这个文件地址发生了变化，这时候你就不需要在 MapPageRoute 中进行参数配置了，只需要进行 Url 和 WebForm 文件地址配置，那这样配置，使用 Request.QueryString 可以获取到参数值吗？我试过是可以的，没有了参数映射配置，也就不需要 Page.RouteData.Values 进行获取参数值了，一种偷巧行为。

3. 带多个参数：

public class MvcApplication : System.Web.HttpApplication
{
    protected void Application_Start()
    {
        RouteTable.Routes.MapPageRoute("WebFormRoute",
            "test/{para1}/{para2}",
            "~/WebForm1.aspx");
    }
}

public partial class WebForm1 : System.Web.UI.Page
{
    protected void Page_Load(object sender, EventArgs e)
    {
        Response.Write("hello world! <br />");
        Response.Write("para1: " + Page.RouteData.Values["para1"]+ "<br />");
        Response.Write("para2: " + Page.RouteData.Values["para2"]+ "<br />");
    }
}

效果：

注意：

多个参数的映射还有一种写法是：test/{para1}&{para2}，但我试过这种写法会报错，而在 Scott Guthrie 的一篇博文中评论回复，这种方式是可以的，如下：

4. 非正规参数：

public class MvcApplication : System.Web.HttpApplication
{
    protected void Application_Start()
    {
        RouteTable.Routes.MapPageRoute("WebFormRoute",
            "test/{para1}/{para2}.html",
            "~/WebForm1.aspx");
    }
}

public partial class WebForm1 : System.Web.UI.Page
{
    protected void Page_Load(object sender, EventArgs e)
    {
        Response.Write("hello world! <br />");
        Response.Write("para1: " + Page.RouteData.Values["para1"]+ "<br />");
        Response.Write("para2: " + Page.RouteData.Values["para2"]+ "<br />");
    }
}

效果：

注意：

<system.webServer>
    <modules runAllManagedModulesForAllRequests="true" />
</system.webServer>

在 MapPageRoute Url 映射的时候，使用的后缀是 .html，需要在 web.config 添加上面配置，如果使用的是 .aspx，则不需要，runAllManagedModulesForAllRequests 在之前的博文中有说过，就不重复了。

4. MapPageRoute 方法参数：

//参数
public Route MapPageRoute(
    string routeName,//路由的名称。
    string routeUrl,//路由的 URL 模式。
    string physicalFile,//路由的物理 URL。
    bool checkPhysicalUrlAccess,//一个值，该值指示 ASP.NET 是否应验证用户是否有权访问物理 URL（始终会检查路由 URL）。
    RouteValueDictionary defaults,//路由参数的默认值。
    RouteValueDictionary constraints,//一些约束，URL 请求必须满足这些约束才能作为此路由处理。
    RouteValueDictionary dataTokens//与路由关联的值，但这些值不用于确定路由是否匹配 URL 模式。
)

public class MvcApplication : System.Web.HttpApplication
{
    protected void Application_Start()
    {
        RouteTable.Routes.MapPageRoute("WebFormRoute",
            "test/{para1}/{para2}/{*queryvalues}",
            "~/WebForm1.aspx",
            false,
            null,
            new RouteValueDictionary { { "para1", "^[0-9]*$" }, { "para2", "^[A-Za-z]+$" } },
            new RouteValueDictionary { { "para3", "xishuai1" }, { "para4", "xishuai2" } });
    }
}

public partial class WebForm1 : System.Web.UI.Page
{
    protected void Page_Load(object sender, EventArgs e)
    {
        Response.Write("hello world! <br />");
        Response.Write("para1: " + Page.RouteData.Values["para1"]+ "<br />");
        Response.Write("para2: " + Page.RouteData.Values["para2"]+ "<br />");
        Response.Write("para3: " + Page.RouteData.DataTokens["para3"] + "<br />");
        Response.Write("para4: " + Page.RouteData.DataTokens["para4"]+ "<br />");
    }
}

效果：

参考资料：

• URL Routing with ASP.NET 4 Web Forms (VS 2010 and .NET 4.0 Series)
• Using Friendly URLs in Web Forms