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 ファイルのからApplication_Start呼び出されるという名前RegisterRoutesのメソッドを示しています。メソッドは、の 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使用してPageRouteHandler作成されたオブジェクトをRoute渡すことと同じです。

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

物理的な URL にアクセスするための権限をユーザーが持っていることを ASP.NET で確認するかどうかを示す値 (ルート 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 ルーティング

適用対象

次の方法で共有

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)

パラメーター

戻り値

例外

例

注釈

こちらもご覧ください

適用対象

その他のリソース