Partager via


RouteCollection.MapPageRoute Méthode

Définition

Offre un moyen de définir des itinéraires pour les applications Web Forms.

Surcharges

MapPageRoute(String, String, String)

Offre un moyen de définir des itinéraires pour les applications Web Forms.

MapPageRoute(String, String, String, Boolean)

Offre un moyen de définir des itinéraires pour les applications Web Forms.

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

Offre un moyen de définir des itinéraires pour les applications Web Forms.

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

Offre un moyen de définir des itinéraires pour les applications Web Forms.

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

Offre un moyen de définir des itinéraires pour les applications Web Forms.

Exemples

L’exemple suivant montre comment définir des itinéraires pour une application Web Forms à l’aide de cette méthode. L’exemple montre une méthode nommée RegisterRoutes qui est appelée à partir du Application_Start fichier Global.asax. La méthode utilise chaque surcharge de MapPageRoute pour ajouter un itinéraire à l’application. Pour plus d’informations sur la définition d’itinéraires pour les applications Web Forms, consultez 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

Remarques

Cette méthode est fournie pour faciliter le codage. Cela revient à appeler la Add méthode et à passer un Route objet créé à l’aide de la PageRouteHandler classe .

MapPageRoute(String, String, String)

Offre un moyen de définir des itinéraires pour les applications 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

Paramètres

routeName
String

Nom de l’itinéraire.

routeUrl
String

Modèle d’URL pour l’itinéraire.

physicalFile
String

URL physique de l'itinéraire.

Retours

Itinéraire ajouté à la collection d'itinéraires.

Exemples

L’exemple suivant montre comment définir un itinéraire à l’aide de cette méthode. La première instruction définit un itinéraire qui n’a pas de nom. La deuxième instruction définit un itinéraire nommé. Cet exemple fait partie d’un exemple plus large disponible dans la vue d’ensemble de la MapPageRoute méthode.

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

Remarques

Cette méthode est fournie pour faciliter le codage. Cela revient à appeler la Add méthode et à passer un Route objet créé à l’aide de la PageRouteHandler classe .

Voir aussi

S’applique à

MapPageRoute(String, String, String, Boolean)

Offre un moyen de définir des itinéraires pour les applications 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

Paramètres

routeName
String

Nom de l’itinéraire.

routeUrl
String

Modèle d’URL pour l’itinéraire.

physicalFile
String

URL physique de l'itinéraire.

checkPhysicalUrlAccess
Boolean

Valeur qui indique si ASP.NET doit valider que l'utilisateur a autorité pour accéder à l'URL physique (l'URL de routage est toujours vérifiée). Ce paramètre définit la propriété CheckPhysicalUrlAccess.

Retours

Itinéraire ajouté à la collection d'itinéraires.

Exemples

L’exemple suivant montre comment définir un itinéraire à l’aide de cette méthode. Cet exemple fait partie d’un exemple plus large disponible dans la vue d’ensemble de la MapPageRoute méthode.

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

Remarques

Cette méthode est fournie pour faciliter le codage. Cela revient à appeler la Add méthode et à passer un Route objet créé à l’aide de la PageRouteHandler classe .

Voir aussi

S’applique à

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

Offre un moyen de définir des itinéraires pour les applications 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

Paramètres

routeName
String

Nom de l’itinéraire.

routeUrl
String

Modèle d’URL pour l’itinéraire.

physicalFile
String

URL physique de l'itinéraire.

checkPhysicalUrlAccess
Boolean

Valeur qui indique si ASP.NET doit valider que l'utilisateur a autorité pour accéder à l'URL physique (l'URL de routage est toujours vérifiée). Ce paramètre définit la propriété CheckPhysicalUrlAccess.

defaults
RouteValueDictionary

Valeurs par défaut pour les paramètres d'itinéraire.

Retours

Itinéraire ajouté à la collection d'itinéraires.

Exemples

L’exemple suivant montre comment définir un itinéraire à l’aide de cette méthode. Cet exemple fait partie d’un exemple plus large disponible dans la vue d’ensemble de la MapPageRoute méthode.

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

Remarques

Cette méthode est fournie pour faciliter le codage. Cela revient à appeler la Add méthode et à passer un Route objet créé à l’aide de la PageRouteHandler classe .

Voir aussi

S’applique à

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

Offre un moyen de définir des itinéraires pour les applications 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

Paramètres

routeName
String

Nom de l’itinéraire.

routeUrl
String

Modèle d’URL pour l’itinéraire.

physicalFile
String

URL physique de l'itinéraire.

checkPhysicalUrlAccess
Boolean

Valeur qui indique si ASP.NET doit valider que l'utilisateur a autorité pour accéder à l'URL physique (l'URL de routage est toujours vérifiée). Ce paramètre définit la propriété CheckPhysicalUrlAccess.

defaults
RouteValueDictionary

Valeurs par défaut de l'itinéraire.

constraints
RouteValueDictionary

Contraintes qu'une requête d'URL doit satisfaire pour qu'elles soient traitées en tant qu'itinéraire.

Retours

Itinéraire ajouté à la collection d'itinéraires.

Exemples

L’exemple suivant montre comment définir un itinéraire à l’aide de cette méthode. Cet exemple fait partie d’un exemple plus large disponible dans la vue d’ensemble de la MapPageRoute méthode.

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

Remarques

Cette méthode est fournie pour faciliter le codage. Cela revient à appeler la Add méthode et à passer un Route objet créé à l’aide de la PageRouteHandler classe .

Voir aussi

S’applique à

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

Offre un moyen de définir des itinéraires pour les applications 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

Paramètres

routeName
String

Nom de l’itinéraire.

routeUrl
String

Modèle d’URL pour l’itinéraire.

physicalFile
String

URL physique de l'itinéraire.

checkPhysicalUrlAccess
Boolean

Valeur qui indique si ASP.NET doit valider que l'utilisateur a autorité pour accéder à l'URL physique (l'URL de routage est toujours vérifiée). Ce paramètre définit la propriété CheckPhysicalUrlAccess.

defaults
RouteValueDictionary

Valeurs par défaut pour les paramètres d'itinéraire.

constraints
RouteValueDictionary

Contraintes qu'une requête d'URL doit satisfaire pour qu'elles soient traitées en tant qu'itinéraire.

dataTokens
RouteValueDictionary

Valeurs associées à l'itinéraire et non utilisées pour déterminer si un itinéraire correspond à un modèle d'URL.

Retours

Itinéraire ajouté à la collection d'itinéraires.

Exceptions

Le paramètre routeUrl a la valeur null.

Exemples

L’exemple suivant montre comment définir un itinéraire à l’aide de cette méthode. Cet exemple fait partie d’un exemple plus large disponible dans la vue d’ensemble de la MapPageRoute méthode.

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

Remarques

Cette méthode est fournie pour faciliter le codage. Cela revient à appeler la Add méthode et à passer un Route objet créé à l’aide de la PageRouteHandler classe .

Voir aussi

S’applique à