RouteCollection.MapPageRoute Méthode

Référence

Définition

Espace de noms:: System.Web.Routing

Assembly:: System.Web.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

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 à 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 Web Forms applications, 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

Route

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 une route qui n’a pas de nom. La deuxième instruction définit une route nommée. Cet exemple fait partie d’un exemple plus vaste 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

Routage ASP.NET

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

Route

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 vaste 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

Routage ASP.NET

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

defaults: RouteValueDictionary

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

Retours

Route

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

Exemples

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

Routage ASP.NET

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

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

Route

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

Exemples

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

Routage ASP.NET

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

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

Route

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

Exceptions

ArgumentNullException

Le paramètre routeUrl a la valeur null.

Exemples

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

Routage ASP.NET

S’applique à

Share via

RouteCollection.MapPageRoute Méthode

Définition

Surcharges

Exemples

Remarques

MapPageRoute(String, String, String)

Paramètres

Retours

Exemples

Remarques

Voir aussi

S’applique à

MapPageRoute(String, String, String, Boolean)

Paramètres

Retours

Exemples

Remarques

Voir aussi

S’applique à

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

Paramètres

Retours

Exemples

Remarques

Voir aussi

S’applique à

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

Paramètres

Retours

Exemples

Remarques

Voir aussi

S’applique à

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

Paramètres

Retours

Exceptions

Exemples

Remarques

Voir aussi

S’applique à

Commentaires

Ressources supplémentaires