RouteCollection.MapPageRoute Método

Referencia

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í.

Permite definir rutas para las aplicaciones de formularios Web Forms.

Sobrecargas

MapPageRoute(String, String, String)	Permite definir rutas para las aplicaciones de formularios Web Forms.
MapPageRoute(String, String, String, Boolean)	Permite definir rutas para las aplicaciones de formularios Web Forms.
MapPageRoute(String, String, String, Boolean, RouteValueDictionary)	Permite definir rutas para las aplicaciones de formularios Web Forms.
MapPageRoute(String, String, String, Boolean, RouteValueDictionary, RouteValueDictionary)	Permite definir rutas para las aplicaciones de formularios Web Forms.
MapPageRoute(String, String, String, Boolean, RouteValueDictionary, RouteValueDictionary, RouteValueDictionary)	Permite definir rutas para las aplicaciones de formularios Web Forms.

Ejemplos

En el ejemplo siguiente se muestra cómo definir rutas para una aplicación de Web Forms mediante este método. En el ejemplo se muestra un método denominado RegisterRoutes 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 Web Forms, consulte 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. Equivale a llamar al Add método y pasar un Route objeto creado mediante la PageRouteHandler clase .

MapPageRoute(String, String, String)

Permite definir rutas para las 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 URL de 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. Equivale 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)

Permite definir rutas para las 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 URL de 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 está autorizado para obtener acceso a la dirección URL física (siempre se comprueba la dirección URL de la ruta). Este parámetro establece la propiedad CheckPhysicalUrlAccess.

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. Equivale 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)

Permite definir rutas para las 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 URL de la ruta.

physicalFile: String

Dirección URL física de la ruta.

checkPhysicalUrlAccess: Boolean

defaults: RouteValueDictionary

Valores predeterminados de los parámetros de la 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. Equivale 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)

Permite definir rutas para las 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 URL de la ruta.

physicalFile: String

Dirección URL física de la ruta.

checkPhysicalUrlAccess: Boolean

defaults: RouteValueDictionary

Valores predeterminados de la ruta.

constraints: RouteValueDictionary

Restricciones que una solicitud de dirección URL debe cumplir para que sea procesada 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. Equivale 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)

Permite definir rutas para las 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 URL de la ruta.

physicalFile: String

Dirección URL física de la ruta.

checkPhysicalUrlAccess: Boolean

defaults: RouteValueDictionary

Valores predeterminados de los parámetros de la ruta.

constraints: RouteValueDictionary

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

dataTokens: RouteValueDictionary

Valores que están asociados a la ruta pero que no se utilizan para determinar si la ruta coincide con un modelo de dirección URL.

Devoluciones

Route

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

Excepciones

ArgumentNullException

El parámetro routeUrl 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. Equivale 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

RouteCollection.MapPageRoute Método

Definición

Sobrecargas

Ejemplos

Comentarios

MapPageRoute(String, String, String)

Parámetros

Devoluciones

Ejemplos

Comentarios

Consulte también

Se aplica a

MapPageRoute(String, String, String, Boolean)

Parámetros

Devoluciones

Ejemplos

Comentarios

Consulte también

Se aplica a

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

Parámetros

Devoluciones

Ejemplos

Comentarios

Consulte también

Se aplica a

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

Parámetros

Devoluciones

Ejemplos

Comentarios

Consulte también

Se aplica a

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

Parámetros

Devoluciones

Excepciones

Ejemplos

Comentarios

Consulte también

Se aplica a

Recursos adicionales