RouteCollection.MapPageRoute Metodo

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.

Consente di definire route per le applicazioni Web Form.

Overload

Nome	Descrizione
MapPageRoute(String, String, String)	Consente di definire route per le applicazioni Web Form.
MapPageRoute(String, String, String, Boolean)	Consente di definire route per le applicazioni Web Form.
MapPageRoute(String, String, String, Boolean, RouteValueDictionary)	Consente di definire route per le applicazioni Web Form.
MapPageRoute(String, String, String, Boolean, RouteValueDictionary, RouteValueDictionary)	Consente di definire route per le applicazioni Web Form.
MapPageRoute(String, String, String, Boolean, RouteValueDictionary, RouteValueDictionary, RouteValueDictionary)	Consente di definire route per le applicazioni Web Form.

Esempio

Nell'esempio seguente viene illustrato come definire le route per un'applicazione Web Form usando questo metodo. Nell'esempio viene illustrato un metodo denominato RegisterRoutes da Application_Start nel 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 Form, vedere Procedura: Definire route per applicazioni Web Form.

 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 praticità per la codifica. Equivale a chiamare il Add metodo e passare un Route oggetto creato usando la PageRouteHandler classe .

MapPageRoute(String, String, String)

Consente di definire 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.

Valori restituiti

Route

Route aggiunta alla raccolta 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ù ampio 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 praticità per la codifica. Equivale a chiamare il Add metodo e passare un Route oggetto creato usando la PageRouteHandler classe .

Vedi anche

ASP.NET Routing

Si applica a

MapPageRoute(String, String, String, Boolean)

Consente di definire 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

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

Valori restituiti

Route

Route aggiunta alla raccolta di route.

Esempio

Nell'esempio seguente viene illustrato come definire una route usando questo metodo. Questo esempio fa parte di un esempio più ampio 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 praticità per la codifica. Equivale a chiamare il Add metodo e passare un Route oggetto creato usando la PageRouteHandler classe .

Vedi anche

ASP.NET Routing

Si applica a

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

Consente di definire 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.

Valori restituiti

Route

Route aggiunta alla raccolta di route.

Esempio

Nell'esempio seguente viene illustrato come definire una route usando questo metodo. Questo esempio fa parte di un esempio più ampio 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 praticità per la codifica. Equivale a chiamare il Add metodo e passare un Route oggetto creato usando la PageRouteHandler classe .

Vedi anche

ASP.NET Routing

Si applica a

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

Consente di definire 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 per la route.

constraints: RouteValueDictionary

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

Valori restituiti

Route

Route aggiunta alla raccolta di route.

Esempio

Nell'esempio seguente viene illustrato come definire una route usando questo metodo. Questo esempio fa parte di un esempio più ampio 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 praticità per la codifica. Equivale a chiamare il Add metodo e passare un Route oggetto creato usando la PageRouteHandler classe .

Vedi anche

ASP.NET Routing

Si applica a

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

Consente di definire 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 poter essere elaborata come route.

dataTokens: RouteValueDictionary

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

Valori restituiti

Route

Route aggiunta alla raccolta di route.

Eccezioni

ArgumentNullException

Il routeUrl parametro è null.

Esempio

Nell'esempio seguente viene illustrato come definire una route usando questo metodo. Questo esempio fa parte di un esempio più ampio 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 praticità per la codifica. Equivale a chiamare il Add metodo e passare un Route oggetto creato usando la PageRouteHandler classe .

Vedi anche

ASP.NET Routing

Si applica a

Commenti e suggerimenti

Questa pagina è stata utile?