Route Kelas

Definisi

Ruang nama:

System.Web.Routing

Rakitan:

System.Web.dll

Menyediakan properti dan metode untuk menentukan rute dan untuk mendapatkan informasi tentang rute.

public ref class Route : System::Web::Routing::RouteBase

public class Route : System.Web.Routing.RouteBase

type Route = class
    inherit RouteBase

Public Class Route
Inherits RouteBase

Warisan

Object

RouteBase

Route

Turunan

System.ServiceModel.Activation.ServiceRoute

System.Web.DynamicData.DynamicDataRoute

Contoh

Contoh berikut menunjukkan cara membuat Route objek dan menambahkannya ke Routes properti .

void Application_Start(object sender, EventArgs e) 
{
    RegisterRoutes(RouteTable.Routes);
}

public static void RegisterRoutes(RouteCollection routes)
{
    routes.Add(new Route
    (
         "Category/{action}/{categoryName}"
         , new CategoryRouteHandler()
    ));
}

Sub Application_Start(ByVal sender As Object, ByVal e As EventArgs)
    RegisterRoutes(RouteTable.Routes)
End Sub

Shared Sub RegisterRoutes(ByVal routes As RouteCollection)
    Dim urlPattern As String
    Dim categoryRoute As Route
    
    urlPattern = "Category/{action}/{categoryName}"
    
    categoryRoute = New Route(urlPattern, New CategoryRouteHandler)
    
    routes.Add(categoryRoute)
End Sub

Keterangan

Kelas memungkinkan Route Anda menentukan bagaimana perutean diproses dalam aplikasi ASP.NET. Anda membuat Route objek untuk setiap pola URL yang ingin Anda petakan ke kelas yang dapat menangani permintaan yang sesuai dengan pola tersebut. Anda kemudian menambahkan rute ke Routes koleksi. Ketika aplikasi menerima permintaan, ASP.NET perutean berulang melalui rute dalam Routes koleksi untuk menemukan rute pertama yang cocok dengan pola URL.

Atur Url properti ke pola URL. Pola URL terdiri dari segmen yang setelah nama aplikasi dalam permintaan HTTP. Misalnya, di URL http://www.contoso.com/products/show/beverages, pola berlaku untuk products/show/beverages. Pola dengan tiga segmen, seperti {controller}/{action}/{id}, cocok dengan URL http://www.contoso.com/products/show/beverages. Setiap segmen dibatasi oleh / karakter. Ketika segmen diapit kurung kurawal ({ dan }), segmen disebut sebagai parameter URL. ASP.NET perutean mengambil nilai dari permintaan dan menetapkannya ke parameter URL. Dalam contoh sebelumnya, parameter action URL diberi nilai show. Jika segmen tidak diapit kurung kurawal, nilai diperlakukan sebagai nilai harfiah.

Defaults Atur properti ke RouteValueDictionary objek yang menyertakan nilai yang digunakan jika parameter hilang dari URL atau untuk mengatur nilai tambahan yang tidak diparameterkan dalam URL. Atur Constraints properti ke RouteValueDictionary objek yang berisi nilai yang merupakan ekspresi reguler atau IRouteConstraint objek. Nilai-nilai ini digunakan untuk menentukan apakah nilai parameter valid.

Konstruktor

Route(String, IRouteHandler)	Menginisialisasi instans Route baru kelas , dengan menggunakan pola URL dan kelas handler yang ditentukan.
Route(String, RouteValueDictionary, IRouteHandler)	Menginisialisasi instans Route baru kelas , dengan menggunakan pola URL yang ditentukan, nilai parameter default, dan kelas handler.
Route(String, RouteValueDictionary, RouteValueDictionary, IRouteHandler)	Menginisialisasi instans Route baru kelas, dengan menggunakan pola URL yang ditentukan, nilai parameter default, batasan, dan kelas handler.
Route(String, RouteValueDictionary, RouteValueDictionary, RouteValueDictionary, IRouteHandler)	Menginisialisasi instans Route baru kelas, dengan menggunakan pola URL yang ditentukan, nilai parameter default, batasan, nilai kustom, dan kelas handler.

Properti

Constraints	Mendapatkan atau mengatur kamus ekspresi yang menentukan nilai yang valid untuk parameter URL.
DataTokens	Mendapatkan atau mengatur nilai kustom yang diteruskan ke handler rute, tetapi yang tidak digunakan untuk menentukan apakah rute cocok dengan pola URL.
Defaults	Mendapatkan atau mengatur nilai yang akan digunakan jika URL tidak berisi semua parameter.
RouteExistingFiles	Mendapatkan atau menetapkan nilai yang menunjukkan apakah perutean ASP.NET harus menangani URL yang cocok dengan file yang ada. (Diperoleh dari RouteBase)
RouteHandler	Mendapatkan atau mengatur objek yang memproses permintaan untuk rute.
Url	Mendapatkan atau mengatur pola URL untuk rute.

Metode

Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetRouteData(HttpContextBase)	Mengembalikan informasi tentang rute yang diminta.
GetType()	Mendapatkan dari instans Type saat ini. (Diperoleh dari Object)
GetVirtualPath(RequestContext, RouteValueDictionary)	Mengembalikan informasi tentang URL yang terkait dengan rute.
MemberwiseClone()	Membuat salinan dangkal dari saat ini Object. (Diperoleh dari Object)
ProcessConstraint(HttpContextBase, Object, String, RouteValueDictionary, RouteDirection)	Menentukan apakah nilai parameter cocok dengan batasan untuk parameter tersebut.
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)

Lihat juga

• Perutean ASP.NET