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)

Параметры

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

Исключения

Примеры

Комментарии

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

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

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

Дополнительные ресурсы