RouteCollection.MapPageRoute Método

Definição

Espaço de Nomes:: System.Web.Routing

Assemblagem:: System.Web.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Fornece uma forma de definir rotas para aplicações Web Forms.

Sobrecargas

Name	Description
MapPageRoute(String, String, String)	Fornece uma forma de definir rotas para aplicações Web Forms.
MapPageRoute(String, String, String, Boolean)	Fornece uma forma de definir rotas para aplicações Web Forms.
MapPageRoute(String, String, String, Boolean, RouteValueDictionary)	Fornece uma forma de definir rotas para aplicações Web Forms.
MapPageRoute(String, String, String, Boolean, RouteValueDictionary, RouteValueDictionary)	Fornece uma forma de definir rotas para aplicações Web Forms.
MapPageRoute(String, String, String, Boolean, RouteValueDictionary, RouteValueDictionary, RouteValueDictionary)	Fornece uma forma de definir rotas para aplicações Web Forms.

Exemplos

O exemplo seguinte mostra como definir rotas para uma aplicação Web Forms usando este método. O exemplo mostra um método chamado RegisterRoutes que é chamado from Application_Start no ficheiro Global.asax. O método utiliza cada overload de MapPageRoute para adicionar uma rota à aplicação. Para mais informações sobre como definir rotas para aplicações Web Forms, veja Como: Definir Rotas para Aplicações 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

Observações

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

MapPageRoute(String, String, String)

Fornece uma forma de definir rotas para aplicações 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 URL da rota.

physicalFile: String

O URL físico da rota.

Devoluções

Route

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

Exemplos

O exemplo seguinte mostra como definir uma rota usando este método. A primeira afirmação define uma rota que não tem nome. A segunda afirmação define uma rota nomeada. Este exemplo faz parte de um exemplo mais amplo que está disponível na MapPageRoute visão geral do 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")

Observações

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

Ver também

Roteamento ASP.NET

Aplica-se a

MapPageRoute(String, String, String, Boolean)

Fornece uma forma de definir rotas para aplicações 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 URL da rota.

physicalFile: String

O URL físico da rota.

checkPhysicalUrlAccess: Boolean

Um valor que indica se o ASP.NET deve validar que o utilizador tem autoridade para aceder à URL física (a URL da rota está sempre assinalada). Este parâmetro define a CheckPhysicalUrlAccess propriedade.

Devoluções

Route

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

Exemplos

O exemplo seguinte mostra como definir uma rota usando este método. Este exemplo faz parte de um exemplo mais amplo que está disponível na MapPageRoute visão geral do método.

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

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

Observações

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

Ver também

Roteamento ASP.NET

Aplica-se a

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

Fornece uma forma de definir rotas para aplicações 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 URL da rota.

physicalFile: String

O URL físico da rota.

checkPhysicalUrlAccess: Boolean

defaults: RouteValueDictionary

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

Devoluções

Route

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

Exemplos

O exemplo seguinte mostra como definir uma rota usando este método. Este exemplo faz parte de um exemplo mais amplo que está disponível na MapPageRoute visão geral do 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()}))

Observações

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

Ver também

Roteamento ASP.NET

Aplica-se a

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

Fornece uma forma de definir rotas para aplicações 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 URL da rota.

physicalFile: String

O URL físico da rota.

checkPhysicalUrlAccess: Boolean

defaults: RouteValueDictionary

Valores padrão para a rota.

constraints: RouteValueDictionary

Restrições que um pedido URL deve cumprir para ser processado como esta rota.

Devoluções

Route

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

Exemplos

O exemplo seguinte mostra como definir uma rota usando este método. Este exemplo faz parte de um exemplo mais amplo que está disponível na MapPageRoute visão geral do 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}" }))

Observações

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

Ver também

Roteamento ASP.NET

Aplica-se a

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

Fornece uma forma de definir rotas para aplicações 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 URL da rota.

physicalFile: String

O URL físico da rota.

checkPhysicalUrlAccess: Boolean

defaults: RouteValueDictionary

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

constraints: RouteValueDictionary

Restrições que um pedido URL deve cumprir para ser processado como esta rota.

dataTokens: RouteValueDictionary

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

Devoluções

Route

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

Exceções

ArgumentNullException

O routeUrl parâmetro é null.

Exemplos

O exemplo seguinte mostra como definir uma rota usando este método. Este exemplo faz parte de um exemplo mais amplo que está disponível na MapPageRoute visão geral do 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" }))

Observações

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

Ver também

Roteamento ASP.NET

Aplica-se a

Comentários

Esta página foi útil?