RouteCollection.MapPageRoute Метод

Определение

Пространство имен:: System.Web.Routing

Сборка:: System.Web.dll

Важно!

Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.

Предоставляет способ определения маршрутов для приложений веб-форм.

Перегрузки

Имя	Описание
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)	Предоставляет способ определения маршрутов для приложений веб-форм.

Примеры

В следующем примере показано, как определить маршруты для приложения веб-форм с помощью этого метода. В примере показан метод с именем RegisterRoutes , который вызывается из Application_Start файла Global.asax. Метод использует каждую перегрузку MapPageRoute для добавления маршрута в приложение. Дополнительные сведения о том, как определить маршруты для приложений веб-форм, см. в разделе "Практическое руководство. Определение маршрутов для приложений веб-форм".

 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

MapPageRoute(String, String, String)

Предоставляет способ определения маршрутов для приложений веб-форм.

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

См. также раздел

ASP.NET маршрутизация

Применяется к

MapPageRoute(String, String, String, Boolean)

Предоставляет способ определения маршрутов для приложений веб-форм.

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)

Предоставляет способ определения маршрутов для приложений веб-форм.

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)

Предоставляет способ определения маршрутов для приложений веб-форм.

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)

Предоставляет способ определения маршрутов для приложений веб-форм.

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)

Параметры

Возвращаемое значение

Исключения

Примеры

Комментарии

См. также раздел

Применяется к

Обратная связь