Partilhar via


RouteCollection.MapPageRoute Método

Definição

Fornece uma maneira de definir rotas para aplicativos Web Forms.

Sobrecargas

MapPageRoute(String, String, String)

Fornece uma maneira de definir rotas para aplicativos Web Forms.

MapPageRoute(String, String, String, Boolean)

Fornece uma maneira de definir rotas para aplicativos Web Forms.

MapPageRoute(String, String, String, Boolean, RouteValueDictionary)

Fornece uma maneira de definir rotas para aplicativos Web Forms.

MapPageRoute(String, String, String, Boolean, RouteValueDictionary, RouteValueDictionary)

Fornece uma maneira de definir rotas para aplicativos Web Forms.

MapPageRoute(String, String, String, Boolean, RouteValueDictionary, RouteValueDictionary, RouteValueDictionary)

Fornece uma maneira de definir rotas para aplicativos Web Forms.

Exemplos

O exemplo a seguir mostra como definir rotas para um aplicativo Web Forms usando esse método. O exemplo mostra um método chamado RegisterRoutes de Application_Start no arquivo Global.asax. O método usa cada sobrecarga de MapPageRoute para adicionar uma rota ao aplicativo. Para obter mais informações sobre como definir rotas para aplicativos web forms, consulte Como definir rotas para aplicativos Web Forms.

 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

Comentários

Esse método é fornecido para fins de conveniência de codificação. É equivalente a chamar o Add método e passar um Route objeto que é criado usando a PageRouteHandler classe .

MapPageRoute(String, String, String)

Fornece uma maneira de definir rotas para aplicativos Web Forms.

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

Parâmetros

routeName
String

O nome da rota.

routeUrl
String

O padrão de URL para a rota.

physicalFile
String

A URL física para a rota.

Retornos

A rota adicionada à coleção de rotas.

Exemplos

O exemplo a seguir mostra como definir uma rota usando esse método. A primeira instrução define uma rota que não tem um nome. A segunda instrução define uma rota nomeada. Este exemplo faz parte de um exemplo maior que está disponível na visão geral do MapPageRoute método.

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

Comentários

Esse método é fornecido para fins de conveniência de codificação. É equivalente a chamar o Add método e passar um Route objeto que é criado usando a PageRouteHandler classe .

Confira também

Aplica-se a

MapPageRoute(String, String, String, Boolean)

Fornece uma maneira de definir rotas para aplicativos Web Forms.

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

Parâmetros

routeName
String

O nome da rota.

routeUrl
String

O padrão de URL para a rota.

physicalFile
String

A URL física para a rota.

checkPhysicalUrlAccess
Boolean

Um valor que indica se o ASP.NET deve validar que o usuário tem autoridade para acessar a URL física (a URL da rota sempre é verificada). Esse parâmetro define a propriedade CheckPhysicalUrlAccess.

Retornos

A rota adicionada à coleção de rotas.

Exemplos

O exemplo a seguir mostra como definir uma rota usando esse método. Este exemplo faz parte de um exemplo maior que está disponível na visão geral do MapPageRoute método.

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

Comentários

Esse método é fornecido para fins de conveniência de codificação. É equivalente a chamar o Add método e passar um Route objeto que é criado usando a PageRouteHandler classe .

Confira também

Aplica-se a

MapPageRoute(String, String, String, Boolean, RouteValueDictionary)

Fornece uma maneira de definir rotas para aplicativos Web Forms.

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

Parâmetros

routeName
String

O nome da rota.

routeUrl
String

O padrão de URL para a rota.

physicalFile
String

A URL física para a rota.

checkPhysicalUrlAccess
Boolean

Um valor que indica se o ASP.NET deve validar que o usuário tem autoridade para acessar a URL física (a URL da rota sempre é verificada). Esse parâmetro define a propriedade CheckPhysicalUrlAccess.

defaults
RouteValueDictionary

Valores padrão para os parâmetros de rota.

Retornos

A rota adicionada à coleção de rotas.

Exemplos

O exemplo a seguir mostra como definir uma rota usando esse método. Este exemplo faz parte de um exemplo maior que está disponível na visão geral do MapPageRoute método.

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()}))

Comentários

Esse método é fornecido para fins de conveniência de codificação. É equivalente a chamar o Add método e passar um Route objeto que é criado usando a PageRouteHandler classe .

Confira também

Aplica-se a

MapPageRoute(String, String, String, Boolean, RouteValueDictionary, RouteValueDictionary)

Fornece uma maneira de definir rotas para aplicativos Web Forms.

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

Parâmetros

routeName
String

O nome da rota.

routeUrl
String

O padrão de URL para a rota.

physicalFile
String

A URL física para a rota.

checkPhysicalUrlAccess
Boolean

Um valor que indica se o ASP.NET deve validar que o usuário tem autoridade para acessar a URL física (a URL da rota sempre é verificada). Esse parâmetro define a propriedade CheckPhysicalUrlAccess.

defaults
RouteValueDictionary

Valores padrão para a rota.

constraints
RouteValueDictionary

Restrições que devem ser cumpridas por uma solicitação de URL para que ela seja processada como esta rota.

Retornos

A rota adicionada à coleção de rotas.

Exemplos

O exemplo a seguir mostra como definir uma rota usando esse método. Este exemplo faz parte de um exemplo maior que está disponível na visão geral do MapPageRoute método.

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

Comentários

Esse método é fornecido para fins de conveniência de codificação. É equivalente a chamar o Add método e passar um Route objeto que é criado usando a PageRouteHandler classe .

Confira também

Aplica-se a

MapPageRoute(String, String, String, Boolean, RouteValueDictionary, RouteValueDictionary, RouteValueDictionary)

Fornece uma maneira de definir rotas para aplicativos Web Forms.

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

Parâmetros

routeName
String

O nome da rota.

routeUrl
String

O padrão de URL para a rota.

physicalFile
String

A URL física para a rota.

checkPhysicalUrlAccess
Boolean

Um valor que indica se o ASP.NET deve validar que o usuário tem autoridade para acessar a URL física (a URL da rota sempre é verificada). Esse parâmetro define a propriedade CheckPhysicalUrlAccess.

defaults
RouteValueDictionary

Valores padrão para os parâmetros de rota.

constraints
RouteValueDictionary

Restrições que devem ser cumpridas por uma solicitação de URL para que ela seja processada como esta rota.

dataTokens
RouteValueDictionary

Valores que são associados com a rota que não são usados para determinar se uma rota corresponde a um padrão de URL.

Retornos

A rota adicionada à coleção de rotas.

Exceções

O parâmetro routeUrl é null.

Exemplos

O exemplo a seguir mostra como definir uma rota usando esse método. Este exemplo faz parte de um exemplo maior que está disponível na visão geral do MapPageRoute método.

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

Comentários

Esse método é fornecido para fins de conveniência de codificação. É equivalente a chamar o Add método e passar um Route objeto que é criado usando a PageRouteHandler classe .

Confira também

Aplica-se a