Route Třída

Definice

Obor názvů:

System.Web.Routing

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 namapovat na třídu, která může zpracovávat požadavky odpovídající danému vzoru. Pak přidáte trasu Routes do kolekce. Když aplikace obdrží požadavek, ASP.NET směrování iteruje trasami v Routes kolekci a vyhledá 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ý ve složených závorkách ({ a }), segment se odkazuje 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 parametr action adresy URL přiřazen hodnotě show. Pokud segment není uzavřený ve složených závorkách, je hodnota považována za literálovou hodnotu.

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

Konstruktory

Name	Description
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í hodnoty 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 třídy pomocí zadaného Route vzoru adresy URL, výchozí hodnoty parametrů, omezení, vlastní hodnoty a třídy obslužné rutiny.

Vlastnosti

Name	Description
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á nebo nastaví hodnotu, která určuje, zda má směrování ASP.NET zpracovat 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

Name	Description
Equals(Object)	Určuje, zda je zadaný objekt roven 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()	Získá Type aktuální instance. (Zděděno od Object)
GetVirtualPath(RequestContext, RouteValueDictionary)	Vrátí informace o adrese URL, která je přidružená k trase.
MemberwiseClone()	Vytvoří mělkou kopii aktuálního 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