RouteCollection.MapPageRoute Methode

Definitie

Naamruimte:: System.Web.Routing

Assembly:: System.Web.dll

Belangrijk

Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.

Biedt een manier om routes voor Web Forms-toepassingen te definiëren.

Overloads

Name	Description
MapPageRoute(String, String, String)	Biedt een manier om routes voor Web Forms-toepassingen te definiëren.
MapPageRoute(String, String, String, Boolean)	Biedt een manier om routes voor Web Forms-toepassingen te definiëren.
MapPageRoute(String, String, String, Boolean, RouteValueDictionary)	Biedt een manier om routes voor Web Forms-toepassingen te definiëren.
MapPageRoute(String, String, String, Boolean, RouteValueDictionary, RouteValueDictionary)	Biedt een manier om routes voor Web Forms-toepassingen te definiëren.
MapPageRoute(String, String, String, Boolean, RouteValueDictionary, RouteValueDictionary, RouteValueDictionary)	Biedt een manier om routes voor Web Forms-toepassingen te definiëren.

Voorbeelden

In het volgende voorbeeld ziet u hoe u routes definieert voor een Web Forms-toepassing met behulp van deze methode. In het voorbeeld ziet u een methode met de naam RegisterRoutes die wordt aangeroepen Application_Start in het bestand Global.asax. De methode gebruikt elke overbelasting van het toevoegen van MapPageRoute een route aan de toepassing. Zie Routes voor Web Forms-toepassingen definiëren voor meer informatie over het definiëren van routes voor Web Forms-toepassingen.

 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

Opmerkingen

Deze methode is beschikbaar voor het gemak van codering. Het is gelijk aan het aanroepen van de Add methode en het doorgeven van een Route object dat is gemaakt met behulp van de PageRouteHandler klasse.

MapPageRoute(String, String, String)

Biedt een manier om routes voor Web Forms-toepassingen te definiëren.

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

Parameters

routeName: String

De naam van de route.

routeUrl: String

Het URL-patroon voor de route.

physicalFile: String

De fysieke URL voor de route.

Retouren

Route

De route die wordt toegevoegd aan de routeverzameling.

Voorbeelden

In het volgende voorbeeld ziet u hoe u een route definieert met behulp van deze methode. De eerste instructie definieert een route die geen naam heeft. Met de tweede instructie wordt een benoemde route gedefinieerd. Dit voorbeeld maakt deel uit van een groter voorbeeld dat beschikbaar is in het MapPageRoute methodeoverzicht.

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

Opmerkingen

Zie ook

ASP.NET-routering

Van toepassing op

MapPageRoute(String, String, String, Boolean)

Biedt een manier om routes voor Web Forms-toepassingen te definiëren.

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

Parameters

routeName: String

De naam van de route.

routeUrl: String

Het URL-patroon voor de route.

physicalFile: String

De fysieke URL voor de route.

checkPhysicalUrlAccess: Boolean

Een waarde die aangeeft of ASP.NET moet valideren dat de gebruiker gemachtigd is om toegang te krijgen tot de fysieke URL (de route-URL wordt altijd gecontroleerd). Met deze parameter wordt de CheckPhysicalUrlAccess eigenschap ingesteld.

Retouren

Route

De route die wordt toegevoegd aan de routeverzameling.

Voorbeelden

In het volgende voorbeeld ziet u hoe u een route definieert met behulp van deze methode. Dit voorbeeld maakt deel uit van een groter voorbeeld dat beschikbaar is in het MapPageRoute methodeoverzicht.

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

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

Opmerkingen

Zie ook

ASP.NET-routering

Van toepassing op

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

Biedt een manier om routes voor Web Forms-toepassingen te definiëren.

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

Parameters

routeName: String

De naam van de route.

routeUrl: String

Het URL-patroon voor de route.

physicalFile: String

De fysieke URL voor de route.

checkPhysicalUrlAccess: Boolean

defaults: RouteValueDictionary

Standaardwaarden voor de routeparameters.

Retouren

Route

De route die wordt toegevoegd aan de routeverzameling.

Voorbeelden

In het volgende voorbeeld ziet u hoe u een route definieert met behulp van deze methode. Dit voorbeeld maakt deel uit van een groter voorbeeld dat beschikbaar is in het MapPageRoute methodeoverzicht.

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

Opmerkingen

Zie ook

ASP.NET-routering

Van toepassing op

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

Biedt een manier om routes voor Web Forms-toepassingen te definiëren.

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

Parameters

routeName: String

De naam van de route.

routeUrl: String

Het URL-patroon voor de route.

physicalFile: String

De fysieke URL voor de route.

checkPhysicalUrlAccess: Boolean

defaults: RouteValueDictionary

Standaardwaarden voor de route.

constraints: RouteValueDictionary

Beperkingen waaraan een URL-aanvraag moet voldoen om te worden verwerkt als deze route.

Retouren

Route

De route die wordt toegevoegd aan de routeverzameling.

Voorbeelden

In het volgende voorbeeld ziet u hoe u een route definieert met behulp van deze methode. Dit voorbeeld maakt deel uit van een groter voorbeeld dat beschikbaar is in het MapPageRoute methodeoverzicht.

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

Opmerkingen

Zie ook

ASP.NET-routering

Van toepassing op

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

Biedt een manier om routes voor Web Forms-toepassingen te definiëren.

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

Parameters

routeName: String

De naam van de route.

routeUrl: String

Het URL-patroon voor de route.

physicalFile: String

De fysieke URL voor de route.

checkPhysicalUrlAccess: Boolean

defaults: RouteValueDictionary

Standaardwaarden voor de routeparameters.

constraints: RouteValueDictionary

Beperkingen waaraan een URL-aanvraag moet voldoen om te worden verwerkt als deze route.

dataTokens: RouteValueDictionary

Waarden die zijn gekoppeld aan de route die niet worden gebruikt om te bepalen of een route overeenkomt met een URL-patroon.

Retouren

Route

De route die wordt toegevoegd aan de routeverzameling.

Uitzonderingen

ArgumentNullException

De routeUrl parameter is null.

Voorbeelden

In het volgende voorbeeld ziet u hoe u een route definieert met behulp van deze methode. Dit voorbeeld maakt deel uit van een groter voorbeeld dat beschikbaar is in het MapPageRoute methodeoverzicht.

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

Opmerkingen

Zie ook

ASP.NET-routering

Van toepassing op

Feedback

Is deze pagina nuttig?