RouteCollection.MapPageRoute Metoda

Reference

Definice

Obor názvů:: System.Web.Routing

Sestavení:: System.Web.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Poskytuje způsob, jak definovat trasy pro aplikace webových formulářů.

Přetížení

MapPageRoute(String, String, String)	Poskytuje způsob, jak definovat trasy pro aplikace webových formulářů.
MapPageRoute(String, String, String, Boolean)	Poskytuje způsob, jak definovat trasy pro aplikace webových formulářů.
MapPageRoute(String, String, String, Boolean, RouteValueDictionary)	Poskytuje způsob, jak definovat trasy pro aplikace webových formulářů.
MapPageRoute(String, String, String, Boolean, RouteValueDictionary, RouteValueDictionary)	Poskytuje způsob, jak definovat trasy pro aplikace webových formulářů.
MapPageRoute(String, String, String, Boolean, RouteValueDictionary, RouteValueDictionary, RouteValueDictionary)	Poskytuje způsob, jak definovat trasy pro aplikace webových formulářů.

Příklady

Následující příklad ukazuje, jak definovat trasy pro aplikaci webových formulářů pomocí této metody. Příklad ukazuje metodu s názvem RegisterRoutes , která je volána z Application_Start v souboru Global.asax. Metoda používá každé přetížení MapPageRoute k přidání trasy do aplikace. Další informace o definování tras pro aplikace webových formulářů naleznete v tématu Postupy: Definování tras pro aplikace webových formulářů.

 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

Poznámky

Tato metoda je k dispozici pro usnadnění kódování. Je ekvivalentní volání Add metody a předání objektu Route , který je vytvořen pomocí PageRouteHandler třídy .

MapPageRoute(String, String, String)

Poskytuje způsob, jak definovat trasy pro aplikace webových formulářů.

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

Parametry

routeName: String

Název trasy.

routeUrl: String

Vzor adresy URL pro trasu.

physicalFile: String

Fyzická adresa URL trasy.

Návraty

Route

Trasa, která je přidána do kolekce tras.

Příklady

Následující příklad ukazuje, jak definovat trasu pomocí této metody. První příkaz definuje trasu, která nemá název. Druhý příkaz definuje pojmenovanou trasu. Tento příklad je součástí většího příkladu, který je k dispozici v přehledu MapPageRoute metody.

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

Poznámky

Tato metoda je k dispozici pro usnadnění kódování. Je ekvivalentní volání Add metody a předání objektu Route , který je vytvořen pomocí PageRouteHandler třídy .

Viz také

směrování ASP.NET

Platí pro

MapPageRoute(String, String, String, Boolean)

Poskytuje způsob, jak definovat trasy pro aplikace webových formulářů.

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

Parametry

routeName: String

Název trasy.

routeUrl: String

Vzor adresy URL pro trasu.

physicalFile: String

Fyzická adresa URL trasy.

checkPhysicalUrlAccess: Boolean

Hodnota, která určuje, jestli ASP.NET ověřit, jestli má uživatel oprávnění pro přístup k fyzické adrese URL (adresa URL trasy je vždy zaškrtnutá). Tento parametr nastaví CheckPhysicalUrlAccess vlastnost .

Návraty

Route

Trasa, která je přidána do kolekce tras.

Příklady

Následující příklad ukazuje, jak definovat trasu pomocí této metody. Tento příklad je součástí většího příkladu, který je k dispozici v přehledu MapPageRoute metody.

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

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

Poznámky

Tato metoda je k dispozici pro usnadnění kódování. Je ekvivalentní volání Add metody a předání objektu Route , který je vytvořen pomocí PageRouteHandler třídy .

Viz také

směrování ASP.NET

Platí pro

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

Poskytuje způsob, jak definovat trasy pro aplikace webových formulářů.

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

Parametry

routeName: String

Název trasy.

routeUrl: String

Vzor adresy URL pro trasu.

physicalFile: String

Fyzická adresa URL trasy.

checkPhysicalUrlAccess: Boolean

defaults: RouteValueDictionary

Výchozí hodnoty parametrů trasy.

Návraty

Route

Trasa, která je přidána do kolekce tras.

Příklady

Následující příklad ukazuje, jak definovat trasu pomocí této metody. Tento příklad je součástí většího příkladu, který je k dispozici v přehledu MapPageRoute metody.

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

Poznámky

Tato metoda je k dispozici pro usnadnění kódování. Je ekvivalentní volání Add metody a předání objektu Route , který je vytvořen pomocí PageRouteHandler třídy .

Viz také

směrování ASP.NET

Platí pro

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

Poskytuje způsob, jak definovat trasy pro aplikace webových formulářů.

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

Parametry

routeName: String

Název trasy.

routeUrl: String

Vzor adresy URL pro trasu.

physicalFile: String

Fyzická adresa URL trasy.

checkPhysicalUrlAccess: Boolean

defaults: RouteValueDictionary

Výchozí hodnoty pro trasu

constraints: RouteValueDictionary

Omezení, která musí požadavek adresy URL splnit, aby mohl být zpracován jako tato trasa.

Návraty

Route

Trasa, která je přidána do kolekce tras.

Příklady

Následující příklad ukazuje, jak definovat trasu pomocí této metody. Tento příklad je součástí většího příkladu, který je k dispozici v přehledu MapPageRoute metody.

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

Poznámky

Tato metoda je k dispozici pro usnadnění kódování. Je ekvivalentní volání Add metody a předání objektu Route , který je vytvořen pomocí PageRouteHandler třídy .

Viz také

směrování ASP.NET

Platí pro

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

Poskytuje způsob, jak definovat trasy pro aplikace webových formulářů.

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

Parametry

routeName: String

Název trasy.

routeUrl: String

Vzor adresy URL pro trasu.

physicalFile: String

Fyzická adresa URL trasy.

checkPhysicalUrlAccess: Boolean

defaults: RouteValueDictionary

Výchozí hodnoty parametrů trasy.

constraints: RouteValueDictionary

Omezení, která musí požadavek adresy URL splnit, aby mohl být zpracován jako tato trasa.

dataTokens: RouteValueDictionary

Hodnoty přidružené k trase, které se nepoužívají k určení, zda trasa odpovídá vzoru adresy URL.

Návraty

Route

Trasa, která je přidána do kolekce tras.

Výjimky

ArgumentNullException

Parametr routeUrl je null.

Příklady

Následující příklad ukazuje, jak definovat trasu pomocí této metody. Tento příklad je součástí většího příkladu, který je k dispozici v přehledu MapPageRoute metody.

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

Poznámky

Tato metoda je k dispozici pro usnadnění kódování. Je ekvivalentní volání Add metody a předání objektu Route , který je vytvořen pomocí PageRouteHandler třídy .

Viz také

směrování ASP.NET

Platí pro

Sdílet prostřednictvím

RouteCollection.MapPageRoute Metoda

Definice

Přetížení

Příklady

Poznámky

MapPageRoute(String, String, String)

Parametry

Návraty

Příklady

Poznámky

Viz také

Platí pro

MapPageRoute(String, String, String, Boolean)

Parametry

Návraty

Příklady

Poznámky

Viz také

Platí pro

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

Parametry

Návraty

Příklady

Poznámky

Viz také

Platí pro

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

Parametry

Návraty

Příklady

Poznámky

Viz také

Platí pro

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

Parametry

Návraty

Výjimky

Příklady

Poznámky

Viz také

Platí pro

Další materiály