RouteCollection.MapPageRoute Método

Referência

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

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

Route

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

Roteamento do 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 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

Route

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

Roteamento do 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 para a rota.

physicalFile: String

A URL física para a rota.

checkPhysicalUrlAccess: Boolean

defaults: RouteValueDictionary

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

Retornos

Route

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

Roteamento do 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 para a rota.

physicalFile: String

A URL física para a rota.

checkPhysicalUrlAccess: Boolean

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

Route

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

Roteamento do 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 para a rota.

physicalFile: String

A URL física para a rota.

checkPhysicalUrlAccess: Boolean

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

Route

A rota adicionada à coleção de rotas.

Exceções

ArgumentNullException

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

Roteamento do ASP.NET

Aplica-se a

Compartilhar via

RouteCollection.MapPageRoute Método

Definição

Sobrecargas

Exemplos

Comentários

MapPageRoute(String, String, String)

Parâmetros

Retornos

Exemplos

Comentários

Confira também

Aplica-se a

MapPageRoute(String, String, String, Boolean)

Parâmetros

Retornos

Exemplos

Comentários

Confira também

Aplica-se a

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

Parâmetros

Retornos

Exemplos

Comentários

Confira também

Aplica-se a

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

Parâmetros

Retornos

Exemplos

Comentários

Confira também

Aplica-se a

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

Parâmetros

Retornos

Exceções

Exemplos

Comentários

Confira também

Aplica-se a

Recursos adicionais