RouteCollection.MapPageRoute Metodo

Riferimento

Definizione

Spazio dei nomi:: System.Web.Routing

Assembly:: System.Web.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

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

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

Routing di ASP.NET

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

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

Routing di ASP.NET

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

defaults: RouteValueDictionary

Valori predefiniti per i parametri di route.

Restituisce

Route

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

Routing di ASP.NET

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

defaults: RouteValueDictionary

Valori predefiniti della route.

constraints: RouteValueDictionary

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

Restituisce

Route

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

Routing di ASP.NET

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

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

Route aggiunta all'insieme di route.

Eccezioni

ArgumentNullException

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

Routing di ASP.NET

Si applica a

RouteCollection.MapPageRoute Metodo

Definizione

Overload

Esempio

Commenti

MapPageRoute(String, String, String)

Parametri

Restituisce

Esempio

Commenti

Vedi anche

Si applica a

MapPageRoute(String, String, String, Boolean)

Parametri

Restituisce

Esempio

Commenti

Vedi anche

Si applica a

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

Parametri

Restituisce

Esempio

Commenti

Vedi anche

Si applica a

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

Parametri

Restituisce

Esempio

Commenti

Vedi anche

Si applica a

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

Parametri

Restituisce

Eccezioni

Esempio

Commenti

Vedi anche

Si applica a

Commenti e suggerimenti

Risorse aggiuntive