RouteCollection.MapPageRoute Metode

Referensi

Definisi

Ruang nama:: System.Web.Routing

Rakitan:: System.Web.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Menyediakan cara untuk menentukan rute untuk aplikasi Formulir Web.

Overload

MapPageRoute(String, String, String)	Menyediakan cara untuk menentukan rute untuk aplikasi Formulir Web.
MapPageRoute(String, String, String, Boolean)	Menyediakan cara untuk menentukan rute untuk aplikasi Formulir Web.
MapPageRoute(String, String, String, Boolean, RouteValueDictionary)	Menyediakan cara untuk menentukan rute untuk aplikasi Formulir Web.
MapPageRoute(String, String, String, Boolean, RouteValueDictionary, RouteValueDictionary)	Menyediakan cara untuk menentukan rute untuk aplikasi Formulir Web.
MapPageRoute(String, String, String, Boolean, RouteValueDictionary, RouteValueDictionary, RouteValueDictionary)	Menyediakan cara untuk menentukan rute untuk aplikasi Formulir Web.

Contoh

Contoh berikut menunjukkan cara menentukan rute untuk aplikasi Formulir Web dengan menggunakan metode ini. Contoh menunjukkan metode bernama RegisterRoutes yang dipanggil dari Application_Start dalam file Global.asax. Metode ini menggunakan setiap kelebihan beban MapPageRoute untuk menambahkan rute ke aplikasi. Untuk informasi selengkapnya tentang cara menentukan rute untuk aplikasi Formulir Web, lihat Cara: Menentukan Rute untuk Aplikasi Formulir Web.

 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

Keterangan

Metode ini disediakan untuk kenyamanan pengodean. Ini setara dengan memanggil Add metode dan meneruskan Route objek yang dibuat dengan menggunakan PageRouteHandler kelas .

MapPageRoute(String, String, String)

Menyediakan cara untuk menentukan rute untuk aplikasi Formulir Web.

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

Nama rute.

routeUrl: String

Pola URL untuk rute.

physicalFile: String

URL fisik untuk rute.

Mengembalikan

Route

Rute yang ditambahkan ke koleksi rute.

Contoh

Contoh berikut menunjukkan cara menentukan rute dengan menggunakan metode ini. Pernyataan pertama mendefinisikan rute yang tidak memiliki nama. Pernyataan kedua mendefinisikan rute bernama. Contoh ini adalah bagian dari contoh yang lebih besar yang tersedia dalam gambaran MapPageRoute umum metode.

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

Keterangan

Metode ini disediakan untuk kenyamanan pengodean. Ini setara dengan memanggil Add metode dan meneruskan Route objek yang dibuat dengan menggunakan PageRouteHandler kelas .

Lihat juga

Perutean ASP.NET

Berlaku untuk

MapPageRoute(String, String, String, Boolean)

Menyediakan cara untuk menentukan rute untuk aplikasi Formulir Web.

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

Nama rute.

routeUrl: String

Pola URL untuk rute.

physicalFile: String

URL fisik untuk rute.

checkPhysicalUrlAccess: Boolean

Nilai yang menunjukkan apakah ASP.NET harus memvalidasi bahwa pengguna memiliki otoritas untuk mengakses URL fisik (URL rute selalu diperiksa). Parameter ini mengatur CheckPhysicalUrlAccess properti .

Mengembalikan

Route

Rute yang ditambahkan ke koleksi rute.

Contoh

Contoh berikut menunjukkan cara menentukan rute dengan menggunakan metode ini. Contoh ini adalah bagian dari contoh yang lebih besar yang tersedia dalam gambaran MapPageRoute umum metode.

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

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

Keterangan

Metode ini disediakan untuk kenyamanan pengodean. Ini setara dengan memanggil Add metode dan meneruskan Route objek yang dibuat dengan menggunakan PageRouteHandler kelas .

Lihat juga

Perutean ASP.NET

Berlaku untuk

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

Menyediakan cara untuk menentukan rute untuk aplikasi Formulir Web.

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

Nama rute.

routeUrl: String

Pola URL untuk rute.

physicalFile: String

URL fisik untuk rute.

checkPhysicalUrlAccess: Boolean

defaults: RouteValueDictionary

Nilai default untuk parameter rute.

Mengembalikan

Route

Rute yang ditambahkan ke koleksi rute.

Contoh

Contoh berikut menunjukkan cara menentukan rute dengan menggunakan metode ini. Contoh ini adalah bagian dari contoh yang lebih besar yang tersedia dalam gambaran MapPageRoute umum metode.

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

Keterangan

Metode ini disediakan untuk kenyamanan pengodean. Ini setara dengan memanggil Add metode dan meneruskan Route objek yang dibuat dengan menggunakan PageRouteHandler kelas .

Lihat juga

Perutean ASP.NET

Berlaku untuk

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

Menyediakan cara untuk menentukan rute untuk aplikasi Formulir Web.

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

Nama rute.

routeUrl: String

Pola URL untuk rute.

physicalFile: String

URL fisik untuk rute.

checkPhysicalUrlAccess: Boolean

defaults: RouteValueDictionary

Nilai default untuk rute.

constraints: RouteValueDictionary

Batasan yang harus dipenuhi permintaan URL agar dapat diproses sebagai rute ini.

Mengembalikan

Route

Rute yang ditambahkan ke koleksi rute.

Contoh

Contoh berikut menunjukkan cara menentukan rute dengan menggunakan metode ini. Contoh ini adalah bagian dari contoh yang lebih besar yang tersedia dalam gambaran MapPageRoute umum metode.

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

Keterangan

Metode ini disediakan untuk kenyamanan pengodean. Ini setara dengan memanggil Add metode dan meneruskan Route objek yang dibuat dengan menggunakan PageRouteHandler kelas .

Lihat juga

Perutean ASP.NET

Berlaku untuk

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

Menyediakan cara untuk menentukan rute untuk aplikasi Formulir Web.

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

Nama rute.

routeUrl: String

Pola URL untuk rute.

physicalFile: String

URL fisik untuk rute.

checkPhysicalUrlAccess: Boolean

defaults: RouteValueDictionary

Nilai default untuk parameter rute.

constraints: RouteValueDictionary

Batasan yang harus dipenuhi permintaan URL agar dapat diproses sebagai rute ini.

dataTokens: RouteValueDictionary

Nilai yang terkait dengan rute yang tidak digunakan untuk menentukan apakah rute cocok dengan pola URL.

Mengembalikan

Route

Rute yang ditambahkan ke koleksi rute.

Pengecualian

ArgumentNullException

Parameternya routeUrl adalah null.

Contoh

Contoh berikut menunjukkan cara menentukan rute dengan menggunakan metode ini. Contoh ini adalah bagian dari contoh yang lebih besar yang tersedia dalam gambaran MapPageRoute umum metode.

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

Keterangan

Metode ini disediakan untuk kenyamanan pengodean. Ini setara dengan memanggil Add metode dan meneruskan Route objek yang dibuat dengan menggunakan PageRouteHandler kelas .

Lihat juga

Perutean ASP.NET

Berlaku untuk

Bagikan melalui

RouteCollection.MapPageRoute Metode

Definisi

Overload

Contoh

Keterangan

MapPageRoute(String, String, String)

Parameter

Mengembalikan

Contoh

Keterangan

Lihat juga

Berlaku untuk

MapPageRoute(String, String, String, Boolean)

Parameter

Mengembalikan

Contoh

Keterangan

Lihat juga

Berlaku untuk

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

Parameter

Mengembalikan

Contoh

Keterangan

Lihat juga

Berlaku untuk

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

Parameter

Mengembalikan

Contoh

Keterangan

Lihat juga

Berlaku untuk

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

Parameter

Mengembalikan

Pengecualian

Contoh

Keterangan

Lihat juga

Berlaku untuk

Saran dan Komentar

Sumber Daya Tambahan: