RouteCollection.MapPageRoute Methode

Definition

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

Das folgende Beispiel zeigt, 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

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

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.

Weitere Informationen

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

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

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.

Weitere Informationen

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

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.

defaults
RouteValueDictionary

Standardwerte für die Routenparameter.

Gibt zurück

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

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.

Weitere Informationen

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

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.

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

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

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.

Weitere Informationen

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

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.

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

Die Route, die der Routenauflistung hinzugefügt wird.

Ausnahmen

Der routeUrl-Parameter ist null.

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

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.

Weitere Informationen

Gilt für: