次の方法で共有


RouteCollection.MapPageRoute メソッド

定義

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。

戻り値

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

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

注釈

このメソッドは、コーディングの利便性を高める目的で提供されます。 これは、 メソッドを呼び出し、 クラスをAdd使用してPageRouteHandler作成された オブジェクトをRoute渡すことと同じです。

こちらもご覧ください

適用対象

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 プロパティを設定します。

戻り値

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

次の例は、このメソッドを使用してルートを定義する方法を示しています。 この例は、メソッドの概要で使用できる大きな例の MapPageRoute 一部です。

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

注釈

このメソッドは、コーディングの利便性を高める目的で提供されます。 これは、 メソッドを呼び出し、 クラスをAdd使用してPageRouteHandler作成された オブジェクトをRoute渡すことと同じです。

こちらもご覧ください

適用対象

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

物理的な URL にアクセスするための権限をユーザーが持っていることを ASP.NET で確認するかどうかを示す値 (ルート 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使用してPageRouteHandler作成された オブジェクトをRoute渡すことと同じです。

こちらもご覧ください

適用対象

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

物理的な URL にアクセスするための権限をユーザーが持っていることを ASP.NET で確認するかどうかを示す値 (ルート 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使用してPageRouteHandler作成された オブジェクトをRoute渡すことと同じです。

こちらもご覧ください

適用対象

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

物理的な URL にアクセスするための権限をユーザーが持っていることを ASP.NET で確認するかどうかを示す値 (ルート 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使用してPageRouteHandler作成された オブジェクトをRoute渡すことと同じです。

こちらもご覧ください

適用対象