RouteCollection.MapPageRoute Metod

Definition

Namnområde:: System.Web.Routing

Sammansättning:: System.Web.dll

Viktigt

En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.

Ger ett sätt att definiera vägar för webbformulärprogram.

Överlagringar

Name	Description
MapPageRoute(String, String, String)	Ger ett sätt att definiera vägar för webbformulärprogram.
MapPageRoute(String, String, String, Boolean)	Ger ett sätt att definiera vägar för webbformulärprogram.
MapPageRoute(String, String, String, Boolean, RouteValueDictionary)	Ger ett sätt att definiera vägar för webbformulärprogram.
MapPageRoute(String, String, String, Boolean, RouteValueDictionary, RouteValueDictionary)	Ger ett sätt att definiera vägar för webbformulärprogram.
MapPageRoute(String, String, String, Boolean, RouteValueDictionary, RouteValueDictionary, RouteValueDictionary)	Ger ett sätt att definiera vägar för webbformulärprogram.

Exempel

I följande exempel visas hur du definierar vägar för ett webbformulärprogram med hjälp av den här metoden. Exemplet visar en metod med namnet RegisterRoutes som anropas från Application_Start i filen Global.asax. Metoden använder varje överlagring av MapPageRoute för att lägga till en väg till programmet. Mer information om hur du definierar vägar för webbformulärprogram finns i Så här definierar du vägar för webbformulärprogram.

 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

Kommentarer

Den här metoden tillhandahålls för att underlätta kodning. Det motsvarar att anropa Add metoden och skicka ett Route objekt som skapas med hjälp PageRouteHandler av klassen.

MapPageRoute(String, String, String)

Ger ett sätt att definiera vägar för webbformulärprogram.

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

Parametrar

routeName: String

Namnet på rutten.

routeUrl: String

URL-mönstret för vägen.

physicalFile: String

Den fysiska URL:en för vägen.

Returer

Route

Den väg som läggs till i vägsamlingen.

Exempel

I följande exempel visas hur du definierar en väg med hjälp av den här metoden. Den första instruktionen definierar en väg som inte har något namn. Den andra instruktionen definierar en namngiven väg. Det här exemplet är en del av ett större exempel som är tillgängligt i metodöversikten MapPageRoute .

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

Kommentarer

Den här metoden tillhandahålls för att underlätta kodning. Det motsvarar att anropa Add metoden och skicka ett Route objekt som skapas med hjälp PageRouteHandler av klassen.

Se även

ASP.NET routning

Gäller för

MapPageRoute(String, String, String, Boolean)

Ger ett sätt att definiera vägar för webbformulärprogram.

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

Parametrar

routeName: String

Namnet på rutten.

routeUrl: String

URL-mönstret för vägen.

physicalFile: String

Den fysiska URL:en för vägen.

checkPhysicalUrlAccess: Boolean

Ett värde som anger om ASP.NET ska verifiera att användaren har behörighet att komma åt den fysiska URL:en (routnings-URL:en är alltid markerad). Den här parametern anger egenskapen CheckPhysicalUrlAccess .

Returer

Route

Den väg som läggs till i vägsamlingen.

Exempel

I följande exempel visas hur du definierar en väg med hjälp av den här metoden. Det här exemplet är en del av ett större exempel som är tillgängligt i metodöversikten MapPageRoute .

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

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

Kommentarer

Den här metoden tillhandahålls för att underlätta kodning. Det motsvarar att anropa Add metoden och skicka ett Route objekt som skapas med hjälp PageRouteHandler av klassen.

Se även

ASP.NET routning

Gäller för

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

Ger ett sätt att definiera vägar för webbformulärprogram.

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

Parametrar

routeName: String

Namnet på rutten.

routeUrl: String

URL-mönstret för vägen.

physicalFile: String

Den fysiska URL:en för vägen.

checkPhysicalUrlAccess: Boolean

defaults: RouteValueDictionary

Standardvärden för routningsparametrarna.

Returer

Route

Den väg som läggs till i vägsamlingen.

Exempel

I följande exempel visas hur du definierar en väg med hjälp av den här metoden. Det här exemplet är en del av ett större exempel som är tillgängligt i metodöversikten MapPageRoute .

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

Kommentarer

Den här metoden tillhandahålls för att underlätta kodning. Det motsvarar att anropa Add metoden och skicka ett Route objekt som skapas med hjälp PageRouteHandler av klassen.

Se även

ASP.NET routning

Gäller för

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

Ger ett sätt att definiera vägar för webbformulärprogram.

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

Parametrar

routeName: String

Namnet på rutten.

routeUrl: String

URL-mönstret för vägen.

physicalFile: String

Den fysiska URL:en för vägen.

checkPhysicalUrlAccess: Boolean

defaults: RouteValueDictionary

Standardvärden för vägen.

constraints: RouteValueDictionary

Begränsningar som en URL-begäran måste uppfylla för att kunna bearbetas som den här vägen.

Returer

Route

Den väg som läggs till i vägsamlingen.

Exempel

I följande exempel visas hur du definierar en väg med hjälp av den här metoden. Det här exemplet är en del av ett större exempel som är tillgängligt i metodöversikten MapPageRoute .

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

Kommentarer

Den här metoden tillhandahålls för att underlätta kodning. Det motsvarar att anropa Add metoden och skicka ett Route objekt som skapas med hjälp PageRouteHandler av klassen.

Se även

ASP.NET routning

Gäller för

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

Ger ett sätt att definiera vägar för webbformulärprogram.

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

Parametrar

routeName: String

Namnet på rutten.

routeUrl: String

URL-mönstret för vägen.

physicalFile: String

Den fysiska URL:en för vägen.

checkPhysicalUrlAccess: Boolean

defaults: RouteValueDictionary

Standardvärden för routningsparametrarna.

constraints: RouteValueDictionary

Begränsningar som en URL-begäran måste uppfylla för att kunna bearbetas som den här vägen.

dataTokens: RouteValueDictionary

Värden som är associerade med den väg som inte används för att avgöra om en väg matchar ett URL-mönster.

Returer

Route

Den väg som läggs till i vägsamlingen.

Undantag

ArgumentNullException

Parametern routeUrl är null.

Exempel

I följande exempel visas hur du definierar en väg med hjälp av den här metoden. Det här exemplet är en del av ett större exempel som är tillgängligt i metodöversikten MapPageRoute .

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

Kommentarer

Den här metoden tillhandahålls för att underlätta kodning. Det motsvarar att anropa Add metoden och skicka ett Route objekt som skapas med hjälp PageRouteHandler av klassen.

Se även

ASP.NET routning

Gäller för

Feedback

Var den här sidan till hjälp?