RouteCollection.MapPageRoute Methode

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 zum Definieren von Routen für Webanwendungen.

Überlädt

Name	Beschreibung
MapPageRoute(String, String, String)	Bietet eine Möglichkeit zum Definieren von Routen für Webanwendungen.
MapPageRoute(String, String, String, Boolean)	Bietet eine Möglichkeit zum Definieren von Routen für Webanwendungen.
MapPageRoute(String, String, String, Boolean, RouteValueDictionary)	Bietet eine Möglichkeit zum Definieren von Routen für Webanwendungen.
MapPageRoute(String, String, String, Boolean, RouteValueDictionary, RouteValueDictionary)	Bietet eine Möglichkeit zum Definieren von Routen für Webanwendungen.
MapPageRoute(String, String, String, Boolean, RouteValueDictionary, RouteValueDictionary, RouteValueDictionary)	Bietet eine Möglichkeit zum Definieren von Routen für Webanwendungen.

Beispiele

Das folgende Beispiel zeigt, wie Routen für eine Webanwendung mithilfe dieser Methode definiert werden. Das Beispiel zeigt eine Methode mit dem Namen RegisterRoutes , die aus Application_Start der Datei "Global.asax" aufgerufen wird. Die Methode verwendet jede Überladung, MapPageRoute um der Anwendung eine Route hinzuzufügen. Weitere Informationen zum Definieren von Routen für Webanwendungen finden Sie unter How to: Define Routes for Web Forms Applications.

 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. Es 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 zum Definieren von Routen für Webanwendungen.

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

Das folgende Beispiel zeigt, wie Sie eine Route mithilfe dieser Methode definieren. Die erste Anweisung definiert eine Route, die keinen Namen hat. 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 zum Definieren von Routen für Webanwendungen.

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 ASP.NET überprüfen soll, ob der Benutzer über die Berechtigung für den Zugriff auf die physische URL verfügt (die Routen-URL wird immer überprüft). Dieser Parameter legt die CheckPhysicalUrlAccess Eigenschaft fest.

Gibt zurück

Route

Die Route, die der Routenauflistung hinzugefügt wird.

Beispiele

Das folgende Beispiel zeigt, wie Sie eine Route mithilfe dieser Methode definieren. 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 zum Definieren von Routen für Webanwendungen.

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

Das folgende Beispiel zeigt, wie Sie eine Route mithilfe dieser Methode definieren. 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

Weitere Informationen

ASP.NET Routing

Gilt für:

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

Bietet eine Möglichkeit zum Definieren von Routen für Webanwendungen.

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

Das folgende Beispiel zeigt, wie Sie eine Route mithilfe dieser Methode definieren. 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

Weitere Informationen

ASP.NET Routing

Gilt für:

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

Bietet eine Möglichkeit zum Definieren von Routen für Webanwendungen.

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 sind, die nicht verwendet werden, um zu bestimmen, ob eine Route mit einem URL-Muster übereinstimmt.

Gibt zurück

Route

Die Route, die der Routenauflistung hinzugefügt wird.

Ausnahmen

ArgumentNullException

Der routeUrl Parameter ist null.

Beispiele

Das folgende Beispiel zeigt, wie Sie eine Route mithilfe dieser Methode definieren. 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

Weitere Informationen

ASP.NET Routing

Gilt für:

Feedback

War diese Seite hilfreich?