Condividi tramite


RouteCollection.MapPageRoute Metodo

Definizione

Fornisce un modo per definire le route per le applicazioni Web Form.

Overload

MapPageRoute(String, String, String)

Fornisce un modo per definire le route per le applicazioni Web Form.

MapPageRoute(String, String, String, Boolean)

Fornisce un modo per definire le route per le applicazioni Web Form.

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

Fornisce un modo per definire le route per le applicazioni Web Form.

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

Fornisce un modo per definire le route per le applicazioni Web Form.

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

Fornisce un modo per definire le route per le applicazioni Web Form.

Esempio

Nell'esempio seguente viene illustrato come definire le route per un'applicazione Web Forms usando questo metodo. L'esempio mostra un metodo denominato RegisterRoutes chiamato dal Application_Start file Global.asax. Il metodo usa ogni overload di MapPageRoute per aggiungere una route all'applicazione. Per altre informazioni su come definire le route per le applicazioni Web Forms, vedere Procedura: Definire route per le applicazioni 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

Commenti

Questo metodo viene fornito per semplificare la codifica. Equivale a chiamare il Add metodo e passare un Route oggetto creato usando la PageRouteHandler classe .

MapPageRoute(String, String, String)

Fornisce un modo per definire le route per le applicazioni Web Form.

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

Parametri

routeName
String

Nome della route.

routeUrl
String

Modello di URL per la route.

physicalFile
String

URL fisico per la route.

Restituisce

Route aggiunta all'insieme di route.

Esempio

Nell'esempio seguente viene illustrato come definire una route usando questo metodo. La prima istruzione definisce una route che non ha un nome. La seconda istruzione definisce una route denominata. Questo esempio fa parte di un esempio più grande disponibile nella panoramica del MapPageRoute metodo.

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

Commenti

Questo metodo viene fornito per semplificare la codifica. Equivale a chiamare il Add metodo e passare un Route oggetto creato usando la PageRouteHandler classe .

Vedi anche

Si applica a

MapPageRoute(String, String, String, Boolean)

Fornisce un modo per definire le route per le applicazioni Web Form.

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

Parametri

routeName
String

Nome della route.

routeUrl
String

Modello di URL per la route.

physicalFile
String

URL fisico per la route.

checkPhysicalUrlAccess
Boolean

Un valore che indica se ASP.NET deve convalidare che l'utente disponga dell'autorità per accedere all'URL fisico (l'URL della route viene sempre controllato). Questo parametro imposta la proprietà CheckPhysicalUrlAccess.

Restituisce

Route aggiunta all'insieme di route.

Esempio

Nell'esempio seguente viene illustrato come definire una route usando questo metodo. Questo esempio fa parte di un esempio più grande disponibile nella panoramica del MapPageRoute metodo.

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

Commenti

Questo metodo viene fornito per semplificare la codifica. Equivale a chiamare il Add metodo e passare un Route oggetto creato usando la PageRouteHandler classe .

Vedi anche

Si applica a

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

Fornisce un modo per definire le route per le applicazioni Web Form.

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

Parametri

routeName
String

Nome della route.

routeUrl
String

Modello di URL per la route.

physicalFile
String

URL fisico per la route.

checkPhysicalUrlAccess
Boolean

Un valore che indica se ASP.NET deve convalidare che l'utente disponga dell'autorità per accedere all'URL fisico (l'URL della route viene sempre controllato). Questo parametro imposta la proprietà CheckPhysicalUrlAccess.

defaults
RouteValueDictionary

Valori predefiniti per i parametri di route.

Restituisce

Route aggiunta all'insieme di route.

Esempio

Nell'esempio seguente viene illustrato come definire una route usando questo metodo. Questo esempio fa parte di un esempio più grande disponibile nella panoramica del MapPageRoute metodo.

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

Commenti

Questo metodo viene fornito per semplificare la codifica. Equivale a chiamare il Add metodo e passare un Route oggetto creato usando la PageRouteHandler classe .

Vedi anche

Si applica a

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

Fornisce un modo per definire le route per le applicazioni Web Form.

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

Parametri

routeName
String

Nome della route.

routeUrl
String

Modello di URL per la route.

physicalFile
String

URL fisico per la route.

checkPhysicalUrlAccess
Boolean

Un valore che indica se ASP.NET deve convalidare che l'utente disponga dell'autorità per accedere all'URL fisico (l'URL della route viene sempre controllato). Questo parametro imposta la proprietà CheckPhysicalUrlAccess.

defaults
RouteValueDictionary

Valori predefiniti della route.

constraints
RouteValueDictionary

Vincoli che una richiesta URL deve soddisfare per essere elaborata come questa route.

Restituisce

Route aggiunta all'insieme di route.

Esempio

Nell'esempio seguente viene illustrato come definire una route usando questo metodo. Questo esempio fa parte di un esempio più grande disponibile nella panoramica del MapPageRoute metodo.

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

Commenti

Questo metodo viene fornito per semplificare la codifica. Equivale a chiamare il Add metodo e passare un Route oggetto creato usando la PageRouteHandler classe .

Vedi anche

Si applica a

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

Fornisce un modo per definire le route per le applicazioni Web Form.

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

Parametri

routeName
String

Nome della route.

routeUrl
String

Modello di URL per la route.

physicalFile
String

URL fisico per la route.

checkPhysicalUrlAccess
Boolean

Un valore che indica se ASP.NET deve convalidare che l'utente disponga dell'autorità per accedere all'URL fisico (l'URL della route viene sempre controllato). Questo parametro imposta la proprietà CheckPhysicalUrlAccess.

defaults
RouteValueDictionary

Valori predefiniti per i parametri di route.

constraints
RouteValueDictionary

Vincoli che una richiesta URL deve soddisfare per essere elaborata come questa route.

dataTokens
RouteValueDictionary

Valori associati alla route che non vengono utilizzati per determinare se una route corrisponde a un modello di URL.

Restituisce

Route aggiunta all'insieme di route.

Eccezioni

Il valore del parametro routeUrl è null.

Esempio

Nell'esempio seguente viene illustrato come definire una route usando questo metodo. Questo esempio fa parte di un esempio più grande disponibile nella panoramica del MapPageRoute metodo.

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

Commenti

Questo metodo viene fornito per semplificare la codifica. Equivale a chiamare il Add metodo e passare un Route oggetto creato usando la PageRouteHandler classe .

Vedi anche

Si applica a