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 nasıl ekleneceği gösterilmektedir Routes .

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 belirtmenizi sağlar. Bu desene karşılık gelen istekleri işleyebilen bir sınıfa eşlemek istediğiniz her URL deseni için bir Route nesne oluşturursunuz. 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 düzenine ayarlayın. URL düzeni, bir HTTP isteğinde uygulama adından sonra gelen segmentlerden oluşur. Örneğin, URL'sinde http://www.contoso.com/products/show/beveragesdesen için products/show/beveragesgeçerlidir. gibi {controller}/{action}/{id}üç kesimli bir desen URL http://www.contoso.com/products/show/beveragesile eşleşir. Her segment karakterle / sınırlandırılır. Bir segment ayraç ({ ve }) içine alındığında, segment bir URL parametresine başvurulur. ASP.NET yönlendirme, isteğin değerini 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.

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

Oluşturucular

Name	Description
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 Route , 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 başlatır.

Özellikler

Name	Description
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şleyip işlemeyeceğ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

Name	Description
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()	Geçerli örneğin Type alır. (Devralındığı yer: Object)
GetVirtualPath(RequestContext, RouteValueDictionary)	Yol ile ilişkili URL hakkında bilgi döndürür.
MemberwiseClone()	Geçerli Objectbasit 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 bir dize döndürür. (Devralındığı yer: Object)

Ayrıca bkz.

• ASP.NET Yönlendirme