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 フォームアプリケーションのルートを定義する方法を示しています。この例では、Global.asax ファイルのRegisterRoutesから呼び出される Application_Start という名前のメソッドを示します。このメソッドは、 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

ルートコレクションに追加されるルート。

例

次の例は、このメソッドを使用してルートを定義する方法を示しています。最初のステートメントは、名前のないルートを定義します。 2 番目のステートメントは、名前付きルートを定義します。この例は、 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")

注釈

こちらもご覧ください

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)

注釈

こちらもご覧ください

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

defaults: RouteValueDictionary

ルートパラメーターの既定値。

返品

Route

ルートコレクションに追加されるルート。

例

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()}))

注釈

こちらもご覧ください

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

defaults: RouteValueDictionary

ルートの既定値。

constraints: RouteValueDictionary

このルートとして処理するために URL 要求が満たす必要がある制約。

返品

Route

ルートコレクションに追加されるルート。

例

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}" }))

注釈

こちらもご覧ください

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

defaults: RouteValueDictionary

ルートパラメーターの既定値。

constraints: RouteValueDictionary

このルートとして処理するために URL 要求が満たす必要がある制約。

dataTokens: RouteValueDictionary

ルートが URL パターンと一致するかどうかを判断するために使用されないルートに関連付けられている値。

返品

Route

ルートコレクションに追加されるルート。

例外

ArgumentNullException

routeUrl パラメーターはnull。

例

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" }))

注釈

こちらもご覧ください

ASP.NET ルーティング

適用対象

フィードバック

このページはお役に立ちましたか?