Route Sınıf

Tanım

Ad Alanı:

System.Web.Routing

Bütünleştirilmiş Kod:

System.Web.dll

Yol tanımlamak ve yol hakkında bilgi almak için özellikler ve yöntemler sağlar.

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

Devralma

Object

RouteBase

Route

Türetilmiş

System.ServiceModel.Activation.ServiceRoute

System.Web.DynamicData.DynamicDataRoute

Örnekler

Aşağıdaki örnekte bir Route nesnenin nasıl oluşturulacağı ve özelliğine Routes nasıl ekleneceği gösterilmektedir.

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

Açıklamalar

sınıfı, Route yönlendirmenin bir ASP.NET uygulamasında nasıl işleneceğini belirtmenize olanak tanır. Her URL deseni için, bu desene karşılık gelen istekleri işleyebilen bir sınıfa eşlemek istediğiniz bir nesne oluşturursunuz Route . Ardından yolu koleksiyona Routes eklersiniz. Uygulama bir istek aldığında ASP.NET yönlendirme, URL'nin deseni ile eşleşen ilk yolu bulmak için koleksiyondaki Routes yollar arasında yinelenir.

Url özelliğini bir URL deseni olarak ayarlayın. URL düzeni, bir HTTP isteğinde uygulama adından sonra gelen segmentlerden oluşur. Örneğin, URL'de http://www.contoso.com/products/show/beveragesdesen için products/show/beveragesgeçerlidir. gibi {controller}/{action}/{id}üç segmentli bir desen URL http://www.contoso.com/products/show/beveragesile eşleşir. Her segment karakterle / sınırlandırılır. Bir segment küme ayraçları ({ ve }) içine alındığında, segment bir URL parametresine başvurur. ASP.NET yönlendirme, değeri istekten alır ve URL parametresine atar. Önceki örnekte URL parametresine action değeri showatanır. Segment ayraç içine alınmamışsa, değer değişmez değer olarak kabul edilir.

URL'de Defaults parametre eksikse kullanılan değerleri içeren bir RouteValueDictionary nesneye veya URL'de parametreleştirilmeyen ek değerler ayarlamak için özelliğini ayarlayın. Constraints özelliğini normal ifadeler veya IRouteConstraint nesneler olan değerleri içeren bir RouteValueDictionary nesne olarak ayarlayın. Bu değerler, bir parametre değerinin geçerli olup olmadığını belirlemek için kullanılır.

Oluşturucular

Route(String, IRouteHandler)	Belirtilen URL desenini ve işleyici sınıfını Route kullanarak sınıfının yeni bir örneğini başlatır.
Route(String, RouteValueDictionary, IRouteHandler)	Belirtilen URL desenini Route , varsayılan parametre değerlerini ve işleyici sınıfını kullanarak sınıfının yeni bir örneğini başlatır.
Route(String, RouteValueDictionary, RouteValueDictionary, IRouteHandler)	Belirtilen URL desenini Route , varsayılan parametre değerlerini, kısıtlamaları ve işleyici sınıfını kullanarak sınıfının yeni bir örneğini başlatır.
Route(String, RouteValueDictionary, RouteValueDictionary, RouteValueDictionary, IRouteHandler)	Belirtilen URL desenini, varsayılan parametre değerlerini, kısıtlamaları, özel değerleri ve işleyici sınıfını kullanarak sınıfının yeni bir örneğini Route başlatır.

Özellikler

Constraints	URL parametresi için geçerli değerler belirten ifadeler sözlüğü alır veya ayarlar.
DataTokens	Yol işleyicisine geçirilen, ancak yolun bir URL deseni ile eşleşip eşleşmediğini belirlemek için kullanılmayan özel değerleri alır veya ayarlar.
Defaults	URL tüm parametreleri içermiyorsa kullanılacak değerleri alır veya ayarlar.
RouteExistingFiles	ASP.NET yönlendirmenin var olan bir dosyayla eşleşen URL'leri işlemesi gerekip gerekmediğini belirten bir değer alır veya ayarlar. (Devralındığı yer: RouteBase)
RouteHandler	Yol için istekleri işleyen nesneyi alır veya ayarlar.
Url	Yol için URL desenini alır veya ayarlar.

Yöntemler

Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetRouteData(HttpContextBase)	İstenen yol hakkındaki bilgileri döndürür.
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
GetVirtualPath(RequestContext, RouteValueDictionary)	Yol ile ilişkili URL hakkındaki bilgileri döndürür.
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
ProcessConstraint(HttpContextBase, Object, String, RouteValueDictionary, RouteDirection)	Parametre değerinin bu parametrenin kısıtlaması ile eşleşip eşleşmediğini belirler.
ToString()	Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object)

Ayrıca bkz.

• ASP.NET Yönlendirme