Route Třída

Definice

Obor názvů:

System.Web.Routing

Sestavení:

System.Web.dll

Poskytuje vlastnosti a metody pro definování trasy a pro získání informací o trase.

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

Dědičnost

Object

RouteBase

Route

Odvozené

System.ServiceModel.Activation.ServiceRoute

System.Web.DynamicData.DynamicDataRoute

Příklady

Následující příklad ukazuje, jak vytvořit Route objekt a přidat ho Routes do vlastnosti .

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

Poznámky

Třída Route umožňuje určit způsob zpracování směrování v aplikaci ASP.NET. Pro každý vzor adresy URL vytvoříte Route objekt, který chcete mapovat na třídu, která může zpracovávat požadavky, které ho odpovídají. Pak přidáte trasu do Routes kolekce. Když aplikace obdrží požadavek, ASP.NET směrování iteruje trasami v Routes kolekci a najde první trasu, která odpovídá vzoru adresy URL.

Url Nastavte vlastnost na vzor adresy URL. Vzor adresy URL se skládá ze segmentů, které jsou za názvem aplikace v požadavku HTTP. Například v adrese URL http://www.contoso.com/products/show/beveragesvzor platí pro products/show/beverages. Vzor se třemi segmenty, například {controller}/{action}/{id}, odpovídá adrese URL http://www.contoso.com/products/show/beverages. Každý segment je oddělený znakem / . Pokud je segment uzavřený ve složených závorkách ({ a }), odkazuje se na segment na parametr adresy URL. ASP.NET směrování načte hodnotu z požadavku a přiřadí ji k parametru adresy URL. V předchozím příkladu je parametru action adresy URL přiřazena hodnota show. Pokud segment není uzavřený ve složených závorkách, je hodnota považována za hodnotu literálu.

Defaults Nastavte vlastnost na RouteValueDictionary objekt, který obsahuje hodnoty, které se použijí, pokud v adrese URL chybí parametr, nebo pokud chcete nastavit další hodnoty, které nejsou parametrizovány v adrese URL. Constraints Nastavte vlastnost na RouteValueDictionary objekt, který obsahuje hodnoty, které jsou buď regulárními výrazy, nebo IRouteConstraint objekty. Tyto hodnoty se používají k určení, zda je hodnota parametru platná.

Konstruktory

Route(String, IRouteHandler)	Inicializuje novou instanci Route třídy pomocí zadaného vzoru adresy URL a třídy obslužné rutiny.
Route(String, RouteValueDictionary, IRouteHandler)	Inicializuje novou instanci Route třídy pomocí zadaného vzoru adresy URL, výchozích hodnot parametrů a třídy obslužné rutiny.
Route(String, RouteValueDictionary, RouteValueDictionary, IRouteHandler)	Inicializuje novou instanci Route třídy pomocí zadaného vzoru adresy URL, výchozích hodnot parametrů, omezení a třídy obslužné rutiny.
Route(String, RouteValueDictionary, RouteValueDictionary, RouteValueDictionary, IRouteHandler)	Inicializuje novou instanci třídy pomocí zadaného Route vzoru adresy URL, výchozích hodnot parametrů, omezení, vlastních hodnot a třídy obslužné rutiny.

Vlastnosti

Constraints	Získá nebo nastaví slovník výrazů, které určují platné hodnoty pro parametr adresy URL.
DataTokens	Získá nebo nastaví vlastní hodnoty, které jsou předány obslužné rutině trasy, ale které nejsou použity k určení, zda trasa odpovídá vzoru adresy URL.
Defaults	Získá nebo nastaví hodnoty, které se mají použít, pokud adresa URL neobsahuje všechny parametry.
RouteExistingFiles	Získá nebo nastaví hodnotu, která označuje, zda by ASP.NET směrování mělo zpracovávat adresy URL, které odpovídají existujícímu souboru. (Zděděno od RouteBase)
RouteHandler	Získá nebo nastaví objekt, který zpracovává požadavky na trasu.
Url	Získá nebo nastaví vzor adresy URL pro trasu.

Metody

Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetRouteData(HttpContextBase)	Vrátí informace o požadované trase.
GetType()	Type Získá z aktuální instance. (Zděděno od Object)
GetVirtualPath(RequestContext, RouteValueDictionary)	Vrátí informace o adrese URL, která je přidružena k trase.
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
ProcessConstraint(HttpContextBase, Object, String, RouteValueDictionary, RouteDirection)	Určuje, zda hodnota parametru odpovídá omezení pro tento parametr.
ToString()	Vrátí řetězec, který představuje aktuální objekt. (Zděděno od Object)

Viz také

• směrování ASP.NET