RouteCollection.MapPageRoute Método

Definición

Espacio de nombres:: System.Web.Routing

Ensamblado:: System.Web.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Proporciona una manera de definir rutas para aplicaciones de Formularios Web Forms.

Sobrecargas

Nombre	Description
MapPageRoute(String, String, String)	Proporciona una manera de definir rutas para aplicaciones de Formularios Web Forms.
MapPageRoute(String, String, String, Boolean)	Proporciona una manera de definir rutas para aplicaciones de Formularios Web Forms.
MapPageRoute(String, String, String, Boolean, RouteValueDictionary)	Proporciona una manera de definir rutas para aplicaciones de Formularios Web Forms.
MapPageRoute(String, String, String, Boolean, RouteValueDictionary, RouteValueDictionary)	Proporciona una manera de definir rutas para aplicaciones de Formularios Web Forms.
MapPageRoute(String, String, String, Boolean, RouteValueDictionary, RouteValueDictionary, RouteValueDictionary)	Proporciona una manera de definir rutas para aplicaciones de Formularios Web Forms.

Ejemplos

En el ejemplo siguiente se muestra cómo definir rutas para una aplicación de Formularios Web Forms mediante este método. En el ejemplo se muestra un método denominado RegisterRoutes que se llama desde Application_Start en el archivo Global.asax. El método usa cada sobrecarga de MapPageRoute para agregar una ruta a la aplicación. Para obtener más información sobre cómo definir rutas para aplicaciones de Formularios Web Forms, vea How to: Define Routes for Web Forms Applications.

 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

Comentarios

Este método se proporciona para facilitar la codificación. Es equivalente a llamar al Add método y pasar un Route objeto creado mediante la PageRouteHandler clase .

MapPageRoute(String, String, String)

Proporciona una manera de definir rutas para aplicaciones de Formularios 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

Nombre de la ruta.

routeUrl: String

Patrón de dirección URL para la ruta.

physicalFile: String

Dirección URL física de la ruta.

Devoluciones

Route

Ruta que se agrega a la colección de rutas.

Ejemplos

En el ejemplo siguiente se muestra cómo definir una ruta mediante este método. La primera instrucción define una ruta que no tiene un nombre. La segunda instrucción define una ruta con nombre. Este ejemplo forma parte de un ejemplo más grande que está disponible en la información general del 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")

Comentarios

Este método se proporciona para facilitar la codificación. Es equivalente a llamar al Add método y pasar un Route objeto creado mediante la PageRouteHandler clase .

Consulte también

enrutamiento de ASP.NET

Se aplica a

MapPageRoute(String, String, String, Boolean)

Proporciona una manera de definir rutas para aplicaciones de Formularios 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

Nombre de la ruta.

routeUrl: String

Patrón de dirección URL para la ruta.

physicalFile: String

Dirección URL física de la ruta.

checkPhysicalUrlAccess: Boolean

Valor que indica si ASP.NET debe validar que el usuario tiene autoridad para acceder a la dirección URL física (la dirección URL de ruta siempre está activada). Este parámetro establece la CheckPhysicalUrlAccess propiedad .

Devoluciones

Route

Ruta que se agrega a la colección de rutas.

Ejemplos

En el ejemplo siguiente se muestra cómo definir una ruta mediante este método. Este ejemplo forma parte de un ejemplo más grande que está disponible en la información general del MapPageRoute método.

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

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

Comentarios

Este método se proporciona para facilitar la codificación. Es equivalente a llamar al Add método y pasar un Route objeto creado mediante la PageRouteHandler clase .

Consulte también

enrutamiento de ASP.NET

Se aplica a

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

Proporciona una manera de definir rutas para aplicaciones de Formularios 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

Nombre de la ruta.

routeUrl: String

Patrón de dirección URL para la ruta.

physicalFile: String

Dirección URL física de la ruta.

checkPhysicalUrlAccess: Boolean

defaults: RouteValueDictionary

Valores predeterminados para los parámetros de ruta.

Devoluciones

Route

Ruta que se agrega a la colección de rutas.

Ejemplos

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

Comentarios

Este método se proporciona para facilitar la codificación. Es equivalente a llamar al Add método y pasar un Route objeto creado mediante la PageRouteHandler clase .

Consulte también

enrutamiento de ASP.NET

Se aplica a

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

Proporciona una manera de definir rutas para aplicaciones de Formularios 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

Nombre de la ruta.

routeUrl: String

Patrón de dirección URL para la ruta.

physicalFile: String

Dirección URL física de la ruta.

checkPhysicalUrlAccess: Boolean

defaults: RouteValueDictionary

Valores predeterminados para la ruta.

constraints: RouteValueDictionary

Restricciones que debe cumplir una solicitud de dirección URL para poder procesarse como esta ruta.

Devoluciones

Route

Ruta que se agrega a la colección de rutas.

Ejemplos

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

Comentarios

Este método se proporciona para facilitar la codificación. Es equivalente a llamar al Add método y pasar un Route objeto creado mediante la PageRouteHandler clase .

Consulte también

enrutamiento de ASP.NET

Se aplica a

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

Proporciona una manera de definir rutas para aplicaciones de Formularios 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

Nombre de la ruta.

routeUrl: String

Patrón de dirección URL para la ruta.

physicalFile: String

Dirección URL física de la ruta.

checkPhysicalUrlAccess: Boolean

defaults: RouteValueDictionary

Valores predeterminados para los parámetros de ruta.

constraints: RouteValueDictionary

Restricciones que debe cumplir una solicitud de dirección URL para poder procesarse como esta ruta.

dataTokens: RouteValueDictionary

Valores asociados a la ruta que no se usan para determinar si una ruta coincide con un patrón de dirección URL.

Devoluciones

Route

Ruta que se agrega a la colección de rutas.

Excepciones

ArgumentNullException

El routeUrl parámetro es null.

Ejemplos

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

Comentarios

Este método se proporciona para facilitar la codificación. Es equivalente a llamar al Add método y pasar un Route objeto creado mediante la PageRouteHandler clase .

Consulte también

enrutamiento de ASP.NET

Se aplica a

Comentarios

¿Le ha resultado útil esta página?