RouteCollection.MapPageRoute 方法

參考

定義

命名空間:: System.Web.Routing

組件:: System.Web.dll

重要

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

提供一種方式來定義 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。

傳回

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

傳回

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

路由參數的預設值。

傳回

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

傳回

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

傳回

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)

參數

傳回

例外狀況

範例

備註

另請參閱

適用於

其他資源