RouteCollection.MapPageRoute Methode

Referenz

Definition

Namespace:: System.Web.Routing

Assembly:: System.Web.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bietet eine Möglichkeit, Routen für Web Forms-Anwendungen zu definieren.

Überlädt

MapPageRoute(String, String, String)	Bietet eine Möglichkeit, Routen für Web Forms-Anwendungen zu definieren.
MapPageRoute(String, String, String, Boolean)	Bietet eine Möglichkeit, Routen für Web Forms-Anwendungen zu definieren.
MapPageRoute(String, String, String, Boolean, RouteValueDictionary)	Bietet eine Möglichkeit, Routen für Web Forms-Anwendungen zu definieren.
MapPageRoute(String, String, String, Boolean, RouteValueDictionary, RouteValueDictionary)	Bietet eine Möglichkeit, Routen für Web Forms-Anwendungen zu definieren.
MapPageRoute(String, String, String, Boolean, RouteValueDictionary, RouteValueDictionary, RouteValueDictionary)	Bietet eine Möglichkeit, Routen für Web Forms-Anwendungen zu definieren.

Beispiele

Im folgenden Beispiel wird gezeigt, wie Routen für eine Web Forms-Anwendung mithilfe dieser Methode definiert werden. Das Beispiel zeigt eine Methode namens RegisterRoutes , die von aus Application_Start in der Datei Global.asax aufgerufen wird. Die -Methode verwendet jede Überladung von, MapPageRoute um der Anwendung eine Route hinzuzufügen. Weitere Informationen zum Definieren von Routen für Web Forms Anwendungen finden Sie unter Vorgehensweise: Definieren von Routen für Web Forms Anwendungen.

 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

Hinweise

Diese Methode wird zur Vereinfachung der Codierung bereitgestellt. Sie entspricht dem Aufrufen der Add -Methode und dem Übergeben eines Route Objekts, das mithilfe der PageRouteHandler -Klasse erstellt wird.

MapPageRoute(String, String, String)

Bietet eine Möglichkeit, Routen für Web Forms-Anwendungen zu definieren.

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

Parameter

routeName: String

Der Name der Route.

routeUrl: String

Das URL-Muster für die Route.

physicalFile: String

Die physische URL für die Route.

Gibt zurück

Route

Die Route, die der Routenauflistung hinzugefügt wird.

Beispiele

Im folgenden Beispiel wird gezeigt, wie eine Route mithilfe dieser Methode definiert wird. Die erste Anweisung definiert eine Route ohne Namen. Die zweite Anweisung definiert eine benannte Route. Dieses Beispiel ist Teil eines größeren Beispiels, das in der MapPageRoute Methodenübersicht verfügbar ist.

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

Hinweise

Weitere Informationen

ASP.NET-Routing

Gilt für:

MapPageRoute(String, String, String, Boolean)

Bietet eine Möglichkeit, Routen für Web Forms-Anwendungen zu definieren.

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

Parameter

routeName: String

Der Name der Route.

routeUrl: String

Das URL-Muster für die Route.

physicalFile: String

Die physische URL für die Route.

checkPhysicalUrlAccess: Boolean

Ein Wert, der angibt, ob von ASP.NET überprüft werden sollte, ob der Benutzer über die Berechtigung verfügt, auf die physische URL (die Routen-URL wird immer überprüft) zuzugreifen. Dieser Parameter legt die CheckPhysicalUrlAccess-Eigenschaft fest.

Gibt zurück

Route

Die Route, die der Routenauflistung hinzugefügt wird.

Beispiele

Im folgenden Beispiel wird gezeigt, wie eine Route mithilfe dieser Methode definiert wird. Dieses Beispiel ist Teil eines größeren Beispiels, das in der MapPageRoute Methodenübersicht verfügbar ist.

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

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

Hinweise

Weitere Informationen

ASP.NET-Routing

Gilt für:

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

Bietet eine Möglichkeit, Routen für Web Forms-Anwendungen zu definieren.

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

Parameter

routeName: String

Der Name der Route.

routeUrl: String

Das URL-Muster für die Route.

physicalFile: String

Die physische URL für die Route.

checkPhysicalUrlAccess: Boolean

defaults: RouteValueDictionary

Standardwerte für die Routenparameter.

Gibt zurück

Route

Die Route, die der Routenauflistung hinzugefügt wird.

Beispiele

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

Hinweise

Weitere Informationen

ASP.NET-Routing

Gilt für:

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

Bietet eine Möglichkeit, Routen für Web Forms-Anwendungen zu definieren.

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

Parameter

routeName: String

Der Name der Route.

routeUrl: String

Das URL-Muster für die Route.

physicalFile: String

Die physische URL für die Route.

checkPhysicalUrlAccess: Boolean

defaults: RouteValueDictionary

Standardwerte für die Route.

constraints: RouteValueDictionary

Einschränkungen, die eine URL-Anforderung erfüllen muss, um als diese Route verarbeitet zu werden.

Gibt zurück

Route

Die Route, die der Routenauflistung hinzugefügt wird.

Beispiele

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

Hinweise

Weitere Informationen

ASP.NET-Routing

Gilt für:

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

Bietet eine Möglichkeit, Routen für Web Forms-Anwendungen zu definieren.

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

Parameter

routeName: String

Der Name der Route.

routeUrl: String

Das URL-Muster für die Route.

physicalFile: String

Die physische URL für die Route.

checkPhysicalUrlAccess: Boolean

defaults: RouteValueDictionary

Standardwerte für die Routenparameter.

constraints: RouteValueDictionary

Einschränkungen, die eine URL-Anforderung erfüllen muss, um als diese Route verarbeitet zu werden.

dataTokens: RouteValueDictionary

Werte, die der Route zugeordnet werden und anhand denen nicht bestimmt wird, ob eine Route einem URL-Muster entspricht.

Gibt zurück

Route

Die Route, die der Routenauflistung hinzugefügt wird.

Ausnahmen

ArgumentNullException

Der routeUrl-Parameter ist null.

Beispiele

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

Hinweise

Weitere Informationen

ASP.NET-Routing

Gilt für:

RouteCollection.MapPageRoute Methode

Definition

Überlädt

Beispiele

Hinweise

MapPageRoute(String, String, String)

Parameter

Gibt zurück

Beispiele

Hinweise

Weitere Informationen

Gilt für:

MapPageRoute(String, String, String, Boolean)

Parameter

Gibt zurück

Beispiele

Hinweise

Weitere Informationen

Gilt für:

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

Parameter

Gibt zurück

Beispiele

Hinweise

Weitere Informationen

Gilt für:

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

Parameter

Gibt zurück

Beispiele

Hinweise

Weitere Informationen

Gilt für:

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

Parameter

Gibt zurück

Ausnahmen

Beispiele

Hinweise

Weitere Informationen

Gilt für:

Feedback

Zusätzliche Ressourcen