共用方式為


RouteCollection.MapPageRoute 方法

定義

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

多載

MapPageRoute(String, String, String)

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

MapPageRoute(String, String, String, Boolean)

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

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

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

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

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

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

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

範例

下列範例示範如何使用此方法定義 Web Forms 應用程式的路由。 此範例示範在 Global.asax 檔案中呼叫Application_Start名為 RegisterRoutes 的方法。 方法會使用 的每個 多載 MapPageRoute ,將路由新增至應用程式。 如需如何定義 Web Forms 應用程式路由的詳細資訊,請參閱 如何:定義 Web Forms 應用程式的路由

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

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。

傳回

加入至路由集合的路由。

範例

下列範例示範如何使用這個方法來定義路由。 第一個語句會定義沒有名稱的路由。 第二個語句會定義具名路由。 這個範例是方法概觀中提供之較大範例的 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 類別所建立的物件。

另請參閱

適用於

MapPageRoute(String, String, String, Boolean)

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

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 屬性。

傳回

加入至路由集合的路由。

範例

下列範例示範如何使用這個方法來定義路由。 這個範例是方法概觀中提供之較大範例的 MapPageRoute 一部分。

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

備註

這個方法可供撰寫程式代碼方便使用。 它相當於呼叫 方法, Add 並傳遞 Route 使用 PageRouteHandler 類別所建立的物件。

另請參閱

適用於

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

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

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

路由參數的預設值。

傳回

加入至路由集合的路由。

範例

下列範例示範如何使用這個方法來定義路由。 這個範例是方法概觀中提供之較大範例的 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 類別所建立的物件。

另請參閱

適用於

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

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

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 要求必須符合此條件約束,才能當做這個路由來加以處理。

傳回

加入至路由集合的路由。

範例

下列範例示範如何使用這個方法來定義路由。 這個範例是方法概觀中提供之較大範例的 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 類別所建立的物件。

另請參閱

適用於

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

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

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 模式。

傳回

加入至路由集合的路由。

例外狀況

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 類別所建立的物件。

另請參閱

適用於