RouteCollection.MapPageRoute Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Web.Routing

Zestaw:: System.Web.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Umożliwia definiowanie tras dla aplikacji Web Forms.

Przeciążenia

MapPageRoute(String, String, String)	Umożliwia definiowanie tras dla aplikacji Web Forms.
MapPageRoute(String, String, String, Boolean)	Umożliwia definiowanie tras dla aplikacji Web Forms.
MapPageRoute(String, String, String, Boolean, RouteValueDictionary)	Umożliwia definiowanie tras dla aplikacji Web Forms.
MapPageRoute(String, String, String, Boolean, RouteValueDictionary, RouteValueDictionary)	Umożliwia definiowanie tras dla aplikacji Web Forms.
MapPageRoute(String, String, String, Boolean, RouteValueDictionary, RouteValueDictionary, RouteValueDictionary)	Umożliwia definiowanie tras dla aplikacji Web Forms.

Przykłady

W poniższym przykładzie pokazano, jak zdefiniować trasy dla aplikacji Web Forms przy użyciu tej metody. W przykładzie pokazano metodę o nazwie , RegisterRoutes która jest wywoływana z Application_Start pliku Global.asax. Metoda używa każdego przeciążenia elementu MapPageRoute , aby dodać trasę do aplikacji. Aby uzyskać więcej informacji na temat definiowania tras dla aplikacji Web Forms, zobacz How to: Define Routes for Web Forms Applications (Jak definiować trasy dla aplikacji web forms).

 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

Uwagi

Ta metoda jest udostępniana dla wygody kodowania. Jest to odpowiednik wywoływania Add metody i przekazywania Route obiektu, który jest tworzony przy użyciu PageRouteHandler klasy .

MapPageRoute(String, String, String)

Umożliwia definiowanie tras dla aplikacji Web Forms.

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

Nazwa trasy.

routeUrl: String

Wzorzec adresu URL dla trasy.

physicalFile: String

Fizyczny adres URL trasy.

Zwraca

Route

Trasa dodawana do kolekcji tras.

Przykłady

W poniższym przykładzie pokazano, jak zdefiniować trasę przy użyciu tej metody. Pierwsza instrukcja definiuje trasę, która nie ma nazwy. Druga instrukcja definiuje nazwaną trasę. Ten przykład jest częścią większego przykładu, który jest dostępny w przeglądzie 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")

Uwagi

Ta metoda jest udostępniana dla wygody kodowania. Jest to odpowiednik wywoływania Add metody i przekazywania Route obiektu, który jest tworzony przy użyciu PageRouteHandler klasy .

Zobacz też

ASP.NET Routing

Dotyczy

MapPageRoute(String, String, String, Boolean)

Umożliwia definiowanie tras dla aplikacji Web Forms.

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

Nazwa trasy.

routeUrl: String

Wzorzec adresu URL dla trasy.

physicalFile: String

Fizyczny adres URL trasy.

checkPhysicalUrlAccess: Boolean

Wartość wskazująca, czy ASP.NET sprawdzić, czy użytkownik ma uprawnienia dostępu do fizycznego adresu URL (adres URL trasy jest zawsze sprawdzany). Ten parametr ustawia CheckPhysicalUrlAccess właściwość .

Zwraca

Route

Trasa dodawana do kolekcji tras.

Przykłady

W poniższym przykładzie pokazano, jak zdefiniować trasę przy użyciu tej metody. Ten przykład jest częścią większego przykładu, który jest dostępny w przeglądzie MapPageRoute metody.

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

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

Uwagi

Ta metoda jest udostępniana dla wygody kodowania. Jest to odpowiednik wywoływania Add metody i przekazywania Route obiektu, który jest tworzony przy użyciu PageRouteHandler klasy .

Zobacz też

ASP.NET Routing

Dotyczy

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

Umożliwia definiowanie tras dla aplikacji Web Forms.

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

Nazwa trasy.

routeUrl: String

Wzorzec adresu URL dla trasy.

physicalFile: String

Fizyczny adres URL trasy.

checkPhysicalUrlAccess: Boolean

defaults: RouteValueDictionary

Wartości domyślne parametrów trasy.

Zwraca

Route

Trasa dodawana do kolekcji tras.

Przykłady

W poniższym przykładzie pokazano, jak zdefiniować trasę przy użyciu tej metody. Ten przykład jest częścią większego przykładu, który jest dostępny w przeglądzie 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()}))

Uwagi

Ta metoda jest udostępniana dla wygody kodowania. Jest to odpowiednik wywoływania Add metody i przekazywania Route obiektu, który jest tworzony przy użyciu PageRouteHandler klasy .

Zobacz też

ASP.NET Routing

Dotyczy

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

Umożliwia definiowanie tras dla aplikacji Web Forms.

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

Nazwa trasy.

routeUrl: String

Wzorzec adresu URL dla trasy.

physicalFile: String

Fizyczny adres URL trasy.

checkPhysicalUrlAccess: Boolean

defaults: RouteValueDictionary

Wartości domyślne trasy.

constraints: RouteValueDictionary

Ograniczenia, które żądanie adresu URL musi spełniać, aby można je było przetworzyć jako tę trasę.

Zwraca

Route

Trasa dodawana do kolekcji tras.

Przykłady

W poniższym przykładzie pokazano, jak zdefiniować trasę przy użyciu tej metody. Ten przykład jest częścią większego przykładu, który jest dostępny w przeglądzie 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}" }))

Uwagi

Ta metoda jest udostępniana dla wygody kodowania. Jest to odpowiednik wywoływania Add metody i przekazywania Route obiektu, który jest tworzony przy użyciu PageRouteHandler klasy .

Zobacz też

ASP.NET Routing

Dotyczy

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

Umożliwia definiowanie tras dla aplikacji Web Forms.

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

Nazwa trasy.

routeUrl: String

Wzorzec adresu URL dla trasy.

physicalFile: String

Fizyczny adres URL trasy.

checkPhysicalUrlAccess: Boolean

defaults: RouteValueDictionary

Wartości domyślne parametrów trasy.

constraints: RouteValueDictionary

Ograniczenia, które żądanie adresu URL musi spełniać, aby można je było przetworzyć jako tę trasę.

dataTokens: RouteValueDictionary

Wartości skojarzone z trasą, które nie są używane do określania, czy trasa jest zgodna ze wzorcem adresu URL.

Zwraca

Route

Trasa dodawana do kolekcji tras.

Wyjątki

ArgumentNullException

Parametr routeUrl ma wartość null.

Przykłady

W poniższym przykładzie pokazano, jak zdefiniować trasę przy użyciu tej metody. Ten przykład jest częścią większego przykładu, który jest dostępny w przeglądzie 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" }))

Uwagi

Ta metoda jest udostępniana dla wygody kodowania. Jest to odpowiednik wywoływania Add metody i przekazywania Route obiektu, który jest tworzony przy użyciu PageRouteHandler klasy .

Zobacz też

ASP.NET Routing

Dotyczy

Udostępnij za pośrednictwem

RouteCollection.MapPageRoute Metoda

Definicja

Przeciążenia

Przykłady

Uwagi

MapPageRoute(String, String, String)

Parametry

Zwraca

Przykłady

Uwagi

Zobacz też

Dotyczy

MapPageRoute(String, String, String, Boolean)

Parametry

Zwraca

Przykłady

Uwagi

Zobacz też

Dotyczy

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

Parametry

Zwraca

Przykłady

Uwagi

Zobacz też

Dotyczy

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

Parametry

Zwraca

Przykłady

Uwagi

Zobacz też

Dotyczy

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

Parametry

Zwraca

Wyjątki

Przykłady

Uwagi

Zobacz też

Dotyczy

Dodatkowe zasoby