RouteCollection.MapPageRoute Méthode

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.

Permet de définir des itinéraires pour les applications Web Forms.

Surcharges

Nom	Description
MapPageRoute(String, String, String)	Permet de définir des itinéraires pour les applications Web Forms.
MapPageRoute(String, String, String, Boolean)	Permet de définir des itinéraires pour les applications Web Forms.
MapPageRoute(String, String, String, Boolean, RouteValueDictionary)	Permet de définir des itinéraires pour les applications Web Forms.
MapPageRoute(String, String, String, Boolean, RouteValueDictionary, RouteValueDictionary)	Permet de définir des itinéraires pour les applications Web Forms.
MapPageRoute(String, String, String, Boolean, RouteValueDictionary, RouteValueDictionary, RouteValueDictionary)	Permet 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 pour MapPageRoute ajouter un itinéraire à l’application. Pour plus d’informations sur la définition d’itinéraires pour les applications Web Forms, consultez Guide pratique pour définir des itinéraires pour les applications 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

Remarques

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

MapPageRoute(String, String, String)

Permet 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 de 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 un itinéraire qui n’a pas de nom. La deuxième instruction définit une route nommée. 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 le codage pratique. Il équivaut à 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)

Permet 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 de l’itinéraire.

physicalFile: String

URL physique de l’itinéraire.

checkPhysicalUrlAccess: Boolean

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

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 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 le codage pratique. Il équivaut à 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)

Permet 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 de l’itinéraire.

physicalFile: String

URL physique de l’itinéraire.

checkPhysicalUrlAccess: Boolean

defaults: RouteValueDictionary

Valeurs par défaut pour les paramètres de routage.

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 le codage pratique. Il équivaut à 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)

Permet 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 de l’itinéraire.

physicalFile: String

URL physique de l’itinéraire.

checkPhysicalUrlAccess: Boolean

defaults: RouteValueDictionary

Valeurs par défaut pour l’itinéraire.

constraints: RouteValueDictionary

Contraintes qu’une demande d’URL doit respecter pour être traitée 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 le codage pratique. Il équivaut à 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)

Permet 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 de l’itinéraire.

physicalFile: String

URL physique de l’itinéraire.

checkPhysicalUrlAccess: Boolean

defaults: RouteValueDictionary

Valeurs par défaut pour les paramètres de routage.

constraints: RouteValueDictionary

Contraintes qu’une demande d’URL doit respecter pour être traitée en tant qu’itinéraire.

dataTokens: RouteValueDictionary

Valeurs associées à l’itinéraire qui ne sont pas 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 routeUrl paramètre est 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 le codage pratique. Il équivaut à appeler la Add méthode et à passer un Route objet créé à l’aide de la PageRouteHandler classe.

Voir aussi

routage ASP.NET

S’applique à

Commentaires

Cette page a-t-elle été utile ?