Route Třída

Definice

Obor názvů:

System.Web.Routing

Sestavení:

System.Web.Routing.dll

Sestavení:

System.Web.dll

Poskytuje vlastnosti a metody pro definování trasy a 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, jak se směrování zpracovává v aplikaci ASP.NET. Vytvoříte Route objekt pro každý vzor adresy URL, který chcete mapovat na třídu, která může zpracovávat požadavky, které odpovídají danému vzoru. Pak přidáte trasu Routes do kolekce. Když aplikace obdrží požadavek, ASP.NET směrování iteruje přes trasy 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é přicházejí za názvem aplikace v požadavku HTTP. Například v adrese URL http://www.contoso.com/products/show/beveragesse vzor vztahuje na 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ý do složených závorek ({ a }), segment se odkazuje na parametr adresy URL. ASP.NET směrování načte hodnotu z požadavku a přiřadí ji parametru ADRESY URL. V předchozím příkladu je parametr action adresy URL přiřazen hodnotě show. Pokud segment není uzavřen do složených závorek, je hodnota považována za literálovou hodnotu.

Defaults Nastavte vlastnost na RouteValueDictionary objekt, který obsahuje hodnoty, které se používají, pokud parametr chybí v adrese URL nebo k nastavení dalších hodnot, které nejsou parametrizovány v adrese URL. Constraints Vlastnost nastavte na RouteValueDictionary objekt, který obsahuje hodnoty, které jsou regulárními výrazy nebo IRouteConstraint objekty. Tyto hodnoty slouží k určení, jestli 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í hodnoty parametrů, omezení a třídy obslužné rutiny.
Route(String, RouteValueDictionary, RouteValueDictionary, RouteValueDictionary, IRouteHandler)	Inicializuje novou instanci Route třídy pomocí zadaného vzoru adresy URL, výchozí hodnoty parametrů, omezení, vlastní hodnoty 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é se nepoužívají 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ává nebo nastavuje hodnotu, která indikuje, jestli má směrování ASP.NET 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í funkce hash. (Zděděno od Object)
GetRouteData(HttpContextBase)	Vrátí informace o požadované trase.
GetType()	Type Získá aktuální instanci. (Zděděno od Object)
GetVirtualPath(RequestContext, RouteValueDictionary)	Vrátí informace o adrese URL, která je přidružená k trase.
MemberwiseClone()	Vytvoří použádnou kopii aktuálního souboru Object. (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