Поделиться через


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)

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

Примеры

В следующем примере показано, как определить маршруты для приложения веб-форм с помощью этого метода. В примере показан метод с именем 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

Комментарии

Этот метод предоставляется для удобства написания кода. Это эквивалентно вызову Add метода и передаче Route объекта, созданного PageRouteHandler с помощью класса .

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-адрес маршрута.

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

Маршрут, добавляемый в коллекцию маршрутов.

Примеры

В следующем примере показано, как определить маршрут с помощью этого метода. Первая инструкция определяет маршрут без имени. Вторая инструкция определяет именованный маршрут. Этот пример является частью более крупного примера, доступного в обзоре 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 с помощью класса .

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

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

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.

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

Маршрут, добавляемый в коллекцию маршрутов.

Примеры

В следующем примере показано, как определить маршрут с помощью этого метода. Этот пример является частью более крупного примера, доступного в обзоре MapPageRoute метода.

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

Комментарии

Этот метод предоставляется для удобства написания кода. Это эквивалентно вызову Add метода и передаче Route объекта, созданного PageRouteHandler с помощью класса .

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

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

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

Значение, которое указывает, следует ли ASP.NET проверять полномочия пользователя на доступ к физическому URL-адресу (такая проверка всегда выполняется для 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 метода и передаче Route объекта, созданного PageRouteHandler с помощью класса .

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

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

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

Значение, которое указывает, следует ли ASP.NET проверять полномочия пользователя на доступ к физическому URL-адресу (такая проверка всегда выполняется для 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 метода и передаче Route объекта, созданного PageRouteHandler с помощью класса .

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

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

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

Значение, которое указывает, следует ли ASP.NET проверять полномочия пользователя на доступ к физическому URL-адресу (такая проверка всегда выполняется для 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 метода и передаче Route объекта, созданного PageRouteHandler с помощью класса .

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

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