RouteCollection.MapPageRoute Método

Definição

Namespace:: System.Web.Routing

Assembly:: System.Web.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Fornece uma maneira de definir rotas para aplicativos Web Forms.

Sobrecargas

Nome	Description
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 RegisterRoutesApplication_Start no arquivo Global.asax. O método usa cada sobrecarga para MapPageRoute 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 a 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 da rota.

physicalFile: String

A URL física da rota.

Retornos

Route

A rota que é 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 a 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

Roteamento de ASP.NET

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 da rota.

physicalFile: String

A URL física da rota.

checkPhysicalUrlAccess: Boolean

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

Retornos

Route

A rota que é 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 a 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

Roteamento de ASP.NET

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 da rota.

physicalFile: String

A URL física da rota.

checkPhysicalUrlAccess: Boolean

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

defaults: RouteValueDictionary

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

Retornos

Route

A rota que é 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 a 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

Roteamento de ASP.NET

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 da rota.

physicalFile: String

A URL física da rota.

checkPhysicalUrlAccess: Boolean

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

defaults: RouteValueDictionary

Valores padrão para a rota.

constraints: RouteValueDictionary

Restrições que uma solicitação de URL deve atender para ser processada como essa rota.

Retornos

Route

A rota que é 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 a 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

Roteamento de ASP.NET

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 da rota.

physicalFile: String

A URL física da rota.

checkPhysicalUrlAccess: Boolean

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

defaults: RouteValueDictionary

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

constraints: RouteValueDictionary

Restrições que uma solicitação de URL deve atender para ser processada como essa rota.

dataTokens: RouteValueDictionary

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

Retornos

Route

A rota que é adicionada à coleção de rotas.

Exceções

ArgumentNullException

O routeUrl parâmetro é 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 a 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

Roteamento de ASP.NET

Aplica-se a

Comentários

Esta página foi útil?