RouteCollection.MapPageRoute 方法

参考

定义

命名空间:: System.Web.Routing

程序集:: System.Web.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

提供用于定义 Web 窗体应用程序的路由的方法。

重载

MapPageRoute(String, String, String)	提供用于定义 Web 窗体应用程序的路由的方法。
MapPageRoute(String, String, String, Boolean)	提供用于定义 Web 窗体应用程序的路由的方法。
MapPageRoute(String, String, String, Boolean, RouteValueDictionary)	提供用于定义 Web 窗体应用程序的路由的方法。
MapPageRoute(String, String, String, Boolean, RouteValueDictionary, RouteValueDictionary)	提供用于定义 Web 窗体应用程序的路由的方法。
MapPageRoute(String, String, String, Boolean, RouteValueDictionary, RouteValueDictionary, RouteValueDictionary)	提供用于定义 Web 窗体应用程序的路由的方法。

示例

以下示例演示如何使用此方法为 Web 窗体应用程序定义路由。该示例演示了一个名为 RegisterRoutes 的方法，该方法从 Application_Start Global.asax 文件中调用。方法使用的每个 MapPageRoute 重载将路由添加到应用程序。有关如何为 Web 窗体应用程序定义路由的详细信息，请参阅如何：定义 Web 窗体应用程序的路由。

 void RegisterRoutes(RouteCollection routes)
{
    routes.MapPageRoute("",
        "SalesReport/{locale}/{year}/{*queryvalues}", "~/sales.aspx");

    routes.MapPageRoute("SalesSummaryRoute",
        "SalesReportSummary/{locale}", "~/sales.aspx");

    routes.MapPageRoute("SalesDetailRoute",
        "SalesReportDetail/{locale}/{year}/{*queryvalues}", "~/sales.aspx",
        false);

    routes.MapPageRoute("SalesCurrentYearRoute",
        "SalesReportCurrent/{locale}/{year}/{*queryvalues}", "~/sales.aspx",
        false,
        new RouteValueDictionary 
            { { "locale", "US" }, { "year", DateTime.Now.Year.ToString() } });

    routes.MapPageRoute("ExpenseCurrentYearRoute",
        "ExpenseReportCurrent/{locale}", "~/expenses.aspx",
        false,
        new RouteValueDictionary 
            { { "locale", "US" }, { "year", DateTime.Now.Year.ToString() } },
        new RouteValueDictionary 
            { { "locale", "[a-z]{2}" }, { "year", @"\d{4}" } });

    routes.MapPageRoute("ExpenseDetailRoute",
        "ExpenseReportDetail/{locale}/{year}/{*queryvalues}", "~/expenses.aspx",
        false,
        new RouteValueDictionary 
            { { "locale", "US" }, { "year", DateTime.Now.Year.ToString() } },
        new RouteValueDictionary 
            { { "locale", "[a-z]{2}" }, { "year", @"\d{4}" } },
        new RouteValueDictionary 
            { { "account", "1234" }, { "subaccount", "5678" } });
}

Sub RegisterRoutes(ByVal routes As RouteCollection)
    routes.MapPageRoute("",
        "SalesReport/{locale}/{year}/{*queryvalues}", "~/sales.aspx")

    routes.MapPageRoute("SalesSummaryRoute",
        "SalesReportSummary/{locale}", "~/sales.aspx")

    routes.MapPageRoute("SalesDetailRoute",
        "SalesReportDetail/{locale}/{year}/{*queryvalues}", "~/sales.aspx",
        False)

    routes.MapPageRoute("SalesCurrentYearRoute",
        "SalesReportCurrent/{locale}/{year}/{*queryvalues}", "~/sales.aspx",
        false,
        new RouteValueDictionary(New With _ 
            { .locale = "US", .year = DateTime.Now.Year.ToString()}))

    routes.MapPageRoute("ExpenseCurrentYearRoute",
        "ExpenseReportCurrent/{locale}", "~/expenses.aspx",
        false,
        new RouteValueDictionary(New With _
            { .locale = "US", .year = DateTime.Now.Year.ToString()}),
        new RouteValueDictionary(New With _
            { .locale = "[a-z]{2}", .year = "\d{4}" }))

    routes.MapPageRoute("ExpenseDetailRoute",
        "ExpenseReportDetail/{locale}/{year}/{*queryvalues}", "~/expenses.aspx",
        false,
        new RouteValueDictionary(New With _
            { .locale = "US", .year = DateTime.Now.Year.ToString()}),
        new RouteValueDictionary(New With _ 
            { .locale = "[a-z]{2}", .year = "\d{4}" }),
        new RouteValueDictionary(New With _
            { .account = "1234", .subaccount = "5678" }))
End Sub

注解

提供此方法是为了方便编码。它等效于调用 Add 方法并传递 Route 使用 PageRouteHandler 类创建的对象。

MapPageRoute(String, String, String)

提供用于定义 Web 窗体应用程序的路由的方法。

public:
 System::Web::Routing::Route ^ MapPageRoute(System::String ^ routeName, System::String ^ routeUrl, System::String ^ physicalFile);

public System.Web.Routing.Route MapPageRoute (string routeName, string routeUrl, string physicalFile);

member this.MapPageRoute : string * string * string -> System.Web.Routing.Route

Public Function MapPageRoute (routeName As String, routeUrl As String, physicalFile As String) As Route

参数

routeName: String

路由的名称。

routeUrl: String

路由的 URL 模式。

physicalFile: String

路由的物理 URL。

Route

将添加到路由集合的路由。

示例

以下示例演示如何使用此方法定义路由。第一个语句定义没有名称的路由。第二个语句定义命名路由。此示例是方法概述中提供的更大示例的一 MapPageRoute 部分。

routes.MapPageRoute("",
    "SalesReport/{locale}/{year}/{*queryvalues}", "~/sales.aspx");

routes.MapPageRoute("SalesSummaryRoute",
    "SalesReportSummary/{locale}", "~/sales.aspx");

routes.MapPageRoute("",
    "SalesReport/{locale}/{year}/{*queryvalues}", "~/sales.aspx")

routes.MapPageRoute("SalesSummaryRoute",
    "SalesReportSummary/{locale}", "~/sales.aspx")

注解

提供此方法是为了方便编码。它等效于调用 Add 方法并传递 Route 使用 PageRouteHandler 类创建的对象。

另请参阅

ASP.NET 路由

适用于

MapPageRoute(String, String, String, Boolean)

提供用于定义 Web 窗体应用程序的路由的方法。

public:
 System::Web::Routing::Route ^ MapPageRoute(System::String ^ routeName, System::String ^ routeUrl, System::String ^ physicalFile, bool checkPhysicalUrlAccess);

public System.Web.Routing.Route MapPageRoute (string routeName, string routeUrl, string physicalFile, bool checkPhysicalUrlAccess);

member this.MapPageRoute : string * string * string * bool -> System.Web.Routing.Route

Public Function MapPageRoute (routeName As String, routeUrl As String, physicalFile As String, checkPhysicalUrlAccess As Boolean) As Route

参数

routeName: String

路由的名称。

routeUrl: String

路由的 URL 模式。

physicalFile: String

路由的物理 URL。

checkPhysicalUrlAccess: Boolean

一个值，该值指示 ASP.NET 是否应验证用户是否有权访问物理 URL（始终会检查路由 URL）。此参数设置 CheckPhysicalUrlAccess 属性。

Route

将添加到路由集合的路由。

示例

以下示例演示如何使用此方法定义路由。此示例是方法概述中提供的更大示例的一 MapPageRoute 部分。

routes.MapPageRoute("SalesDetailRoute",
    "SalesReportDetail/{locale}/{year}/{*queryvalues}", "~/sales.aspx",
    false);

routes.MapPageRoute("SalesDetailRoute",
    "SalesReportDetail/{locale}/{year}/{*queryvalues}", "~/sales.aspx",
    False)

注解

提供此方法是为了方便编码。它等效于调用 Add 方法并传递 Route 使用 PageRouteHandler 类创建的对象。

另请参阅

ASP.NET 路由

适用于

MapPageRoute(String, String, String, Boolean, RouteValueDictionary)

提供用于定义 Web 窗体应用程序的路由的方法。

public:
 System::Web::Routing::Route ^ MapPageRoute(System::String ^ routeName, System::String ^ routeUrl, System::String ^ physicalFile, bool checkPhysicalUrlAccess, System::Web::Routing::RouteValueDictionary ^ defaults);

public System.Web.Routing.Route MapPageRoute (string routeName, string routeUrl, string physicalFile, bool checkPhysicalUrlAccess, System.Web.Routing.RouteValueDictionary defaults);

member this.MapPageRoute : string * string * string * bool * System.Web.Routing.RouteValueDictionary -> System.Web.Routing.Route

Public Function MapPageRoute (routeName As String, routeUrl As String, physicalFile As String, checkPhysicalUrlAccess As Boolean, defaults As RouteValueDictionary) As Route

参数

routeName: String

路由的名称。

routeUrl: String

路由的 URL 模式。

physicalFile: String

路由的物理 URL。

checkPhysicalUrlAccess: Boolean

一个值，该值指示 ASP.NET 是否应验证用户是否有权访问物理 URL（始终会检查路由 URL）。此参数设置 CheckPhysicalUrlAccess 属性。

defaults: RouteValueDictionary

路由参数的默认值。

Route

将添加到路由集合的路由。

示例

以下示例演示如何使用此方法定义路由。此示例是方法概述中提供的更大示例的一 MapPageRoute 部分。

routes.MapPageRoute("SalesCurrentYearRoute",
    "SalesReportCurrent/{locale}/{year}/{*queryvalues}", "~/sales.aspx",
    false,
    new RouteValueDictionary 
        { { "locale", "US" }, { "year", DateTime.Now.Year.ToString() } });

routes.MapPageRoute("SalesCurrentYearRoute",
    "SalesReportCurrent/{locale}/{year}/{*queryvalues}", "~/sales.aspx",
    false,
    new RouteValueDictionary(New With _ 
        { .locale = "US", .year = DateTime.Now.Year.ToString()}))

注解

提供此方法是为了方便编码。它等效于调用 Add 方法并传递 Route 使用 PageRouteHandler 类创建的对象。

另请参阅

ASP.NET 路由

适用于

MapPageRoute(String, String, String, Boolean, RouteValueDictionary, RouteValueDictionary)

提供用于定义 Web 窗体应用程序的路由的方法。

public:
 System::Web::Routing::Route ^ MapPageRoute(System::String ^ routeName, System::String ^ routeUrl, System::String ^ physicalFile, bool checkPhysicalUrlAccess, System::Web::Routing::RouteValueDictionary ^ defaults, System::Web::Routing::RouteValueDictionary ^ constraints);

public System.Web.Routing.Route MapPageRoute (string routeName, string routeUrl, string physicalFile, bool checkPhysicalUrlAccess, System.Web.Routing.RouteValueDictionary defaults, System.Web.Routing.RouteValueDictionary constraints);

member this.MapPageRoute : string * string * string * bool * System.Web.Routing.RouteValueDictionary * System.Web.Routing.RouteValueDictionary -> System.Web.Routing.Route

Public Function MapPageRoute (routeName As String, routeUrl As String, physicalFile As String, checkPhysicalUrlAccess As Boolean, defaults As RouteValueDictionary, constraints As RouteValueDictionary) As Route

参数

routeName: String

路由的名称。

routeUrl: String

路由的 URL 模式。

physicalFile: String

路由的物理 URL。

checkPhysicalUrlAccess: Boolean

一个值，该值指示 ASP.NET 是否应验证用户是否有权访问物理 URL（始终会检查路由 URL）。此参数设置 CheckPhysicalUrlAccess 属性。

defaults: RouteValueDictionary

路由的默认值。

constraints: RouteValueDictionary

一些约束，URL 请求必须满足这些约束才能作为此路由处理。

Route

将添加到路由集合的路由。

示例

以下示例演示如何使用此方法定义路由。此示例是方法概述中提供的更大示例的一 MapPageRoute 部分。

routes.MapPageRoute("ExpenseCurrentYearRoute",
    "ExpenseReportCurrent/{locale}", "~/expenses.aspx",
    false,
    new RouteValueDictionary 
        { { "locale", "US" }, { "year", DateTime.Now.Year.ToString() } },
    new RouteValueDictionary 
        { { "locale", "[a-z]{2}" }, { "year", @"\d{4}" } });

routes.MapPageRoute("ExpenseCurrentYearRoute",
    "ExpenseReportCurrent/{locale}", "~/expenses.aspx",
    false,
    new RouteValueDictionary(New With _
        { .locale = "US", .year = DateTime.Now.Year.ToString()}),
    new RouteValueDictionary(New With _
        { .locale = "[a-z]{2}", .year = "\d{4}" }))

注解

提供此方法是为了方便编码。它等效于调用 Add 方法并传递 Route 使用 PageRouteHandler 类创建的对象。

另请参阅

ASP.NET 路由

适用于

MapPageRoute(String, String, String, Boolean, RouteValueDictionary, RouteValueDictionary, RouteValueDictionary)

提供用于定义 Web 窗体应用程序的路由的方法。

public:
 System::Web::Routing::Route ^ MapPageRoute(System::String ^ routeName, System::String ^ routeUrl, System::String ^ physicalFile, bool checkPhysicalUrlAccess, System::Web::Routing::RouteValueDictionary ^ defaults, System::Web::Routing::RouteValueDictionary ^ constraints, System::Web::Routing::RouteValueDictionary ^ dataTokens);

public System.Web.Routing.Route MapPageRoute (string routeName, string routeUrl, string physicalFile, bool checkPhysicalUrlAccess, System.Web.Routing.RouteValueDictionary defaults, System.Web.Routing.RouteValueDictionary constraints, System.Web.Routing.RouteValueDictionary dataTokens);

member this.MapPageRoute : string * string * string * bool * System.Web.Routing.RouteValueDictionary * System.Web.Routing.RouteValueDictionary * System.Web.Routing.RouteValueDictionary -> System.Web.Routing.Route

Public Function MapPageRoute (routeName As String, routeUrl As String, physicalFile As String, checkPhysicalUrlAccess As Boolean, defaults As RouteValueDictionary, constraints As RouteValueDictionary, dataTokens As RouteValueDictionary) As Route

参数

routeName: String

路由的名称。

routeUrl: String

路由的 URL 模式。

physicalFile: String

路由的物理 URL。

checkPhysicalUrlAccess: Boolean

一个值，该值指示 ASP.NET 是否应验证用户是否有权访问物理 URL（始终会检查路由 URL）。此参数设置 CheckPhysicalUrlAccess 属性。

defaults: RouteValueDictionary

路由参数的默认值。

constraints: RouteValueDictionary

一些约束，URL 请求必须满足这些约束才能作为此路由处理。

dataTokens: RouteValueDictionary

与路由关联的值，但这些值不用于确定路由是否匹配 URL 模式。

Route

将添加到路由集合的路由。

例外

ArgumentNullException

routeUrl 参数为 null。

示例

以下示例演示如何使用此方法定义路由。此示例是方法概述中提供的更大示例的一 MapPageRoute 部分。

routes.MapPageRoute("ExpenseDetailRoute",
    "ExpenseReportDetail/{locale}/{year}/{*queryvalues}", "~/expenses.aspx",
    false,
    new RouteValueDictionary 
        { { "locale", "US" }, { "year", DateTime.Now.Year.ToString() } },
    new RouteValueDictionary 
        { { "locale", "[a-z]{2}" }, { "year", @"\d{4}" } },
    new RouteValueDictionary 
        { { "account", "1234" }, { "subaccount", "5678" } });

routes.MapPageRoute("ExpenseDetailRoute",
    "ExpenseReportDetail/{locale}/{year}/{*queryvalues}", "~/expenses.aspx",
    false,
    new RouteValueDictionary(New With _
        { .locale = "US", .year = DateTime.Now.Year.ToString()}),
    new RouteValueDictionary(New With _ 
        { .locale = "[a-z]{2}", .year = "\d{4}" }),
    new RouteValueDictionary(New With _
        { .account = "1234", .subaccount = "5678" }))

注解

提供此方法是为了方便编码。它等效于调用 Add 方法并传递 Route 使用 PageRouteHandler 类创建的对象。

另请参阅

ASP.NET 路由

适用于

通过

RouteCollection.MapPageRoute 方法

定义

重载

示例

注解

MapPageRoute(String, String, String)

参数

返回

示例

注解

另请参阅

适用于

MapPageRoute(String, String, String, Boolean)

参数

返回

示例

注解

另请参阅

适用于

MapPageRoute(String, String, String, Boolean, RouteValueDictionary)

参数

返回

示例

注解

另请参阅

适用于

MapPageRoute(String, String, String, Boolean, RouteValueDictionary, RouteValueDictionary)

参数

返回

示例

注解

另请参阅

适用于

MapPageRoute(String, String, String, Boolean, RouteValueDictionary, RouteValueDictionary, RouteValueDictionary)

参数

返回

例外

示例

注解

另请参阅

适用于

其他资源