RouteCollection.MapPageRoute 方法

定義

命名空間:: System.Web.Routing

組件:: System.Web.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

提供一種方式來定義 Web Forms 應用程式的路由。

多載

名稱	Description
MapPageRoute(String, String, String)	提供一種方式來定義 Web Forms 應用程式的路由。
MapPageRoute(String, String, String, Boolean)	提供一種方式來定義 Web Forms 應用程式的路由。
MapPageRoute(String, String, String, Boolean, RouteValueDictionary)	提供一種方式來定義 Web Forms 應用程式的路由。
MapPageRoute(String, String, String, Boolean, RouteValueDictionary, RouteValueDictionary)	提供一種方式來定義 Web Forms 應用程式的路由。
MapPageRoute(String, String, String, Boolean, RouteValueDictionary, RouteValueDictionary, RouteValueDictionary)	提供一種方式來定義 Web Forms 應用程式的路由。

範例

以下範例展示了如何利用此方法定義網頁表單應用程式的路由。範例中顯示了一個名為 RegisterRoutes Global.asax 檔案的方法，從 Global.asax 檔案中被呼叫 Application_Start 。該方法利用每個的 MapPageRoute 超載來為應用程式添加一條路由。欲了解更多如何定義網頁表單應用程式路由的資訊，請參閱「如何定義網頁表單應用程式的路由」。

 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 Forms 應用程式的路由。

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

路由的網址模式。

physicalFile: String

路由的實體網址。

傳回

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 Forms 應用程式的路由。

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

路由的網址模式。

physicalFile: String

路由的實體網址。

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 Forms 應用程式的路由。

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

路由的網址模式。

physicalFile: String

路由的實體網址。

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 Forms 應用程式的路由。

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

路由的網址模式。

physicalFile: String

路由的實體網址。

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 Forms 應用程式的路由。

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

路由的網址模式。

physicalFile: String

路由的實體網址。

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 路由

適用於

意見反應

此頁面對您有幫助嗎？