Route Sınıf

Başvuru

Tanım

Ad Alanı:: System.Web.Routing

Bütünleştirilmiş Kod:: System.Web.Routing.dll

Bütünleştirilmiş Kod:: System.Web.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

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 belirtmenize olanak tanır. Bu desene karşılık gelen istekleri işleyebilen bir sınıfa eşlemek istediğiniz her URL deseni için 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 URL desenine 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}üç 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 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.

URL'de Defaults parametre eksikse kullanılan değerleri içeren bir RouteValueDictionary nesneye veya URL'de parametreleştirilmemiş 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 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

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 mevcut bir dosyayla eşleşen URL 'Leri işlemesinin gerekip gerekmediğini gösteren 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)	Yolla 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)	Bir 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)

Şunlara uygulanır

Ayrıca bkz.

ASP.NET Yönlendirme

Aracılığıyla paylaş