Språk

Route Klass

Definition

Namnområde:
System.Web.Routing
Sammansättning:
System.Web.Routing.dll
Sammansättning:
System.Web.dll

Innehåller egenskaper och metoder för att definiera en väg och för att hämta information om vägen.

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
Arv
Object
RouteBase
Route
Härledda

Exempel

I följande exempel visas hur du skapar ett Route objekt och lägger till det i Routes egenskapen .

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

Kommentarer

Med klassen Route kan du ange hur routning bearbetas i ett ASP.NET program. Du skapar ett Route objekt för varje URL-mönster som du vill mappa till en klass som kan hantera begäranden som motsvarar det mönstret. Sedan lägger du till vägen i Routes samlingen. När programmet tar emot en begäran ASP.NET routning itererar genom vägarna i samlingen Routes för att hitta den första vägen som matchar URL-mönstret.

Url Ange egenskapen till ett URL-mönster. URL-mönstret består av segment som kommer efter programnamnet i en HTTP-begäran. I URL:en http://www.contoso.com/products/show/beveragesgäller till exempel mönstret för products/show/beverages. Ett mönster med tre segment, till exempel {controller}/{action}/{id}, matchar URL:en http://www.contoso.com/products/show/beverages. Varje segment avgränsas av / tecknet. När ett segment omges av klammerparenteser ({ och }), refereras segmentet till en URL-parameter. ASP.NET routning hämtar värdet från begäran och tilldelar det till URL-parametern. I föregående exempel tilldelas URL-parametern action värdet show. Om segmentet inte omges av klammerparenteser behandlas värdet som ett literalvärde.

Ange egenskapen Defaults till ett RouteValueDictionary objekt som innehåller värden som används om en parameter saknas i URL:en eller för att ange ytterligare värden som inte är parametriserade i URL:en. Ange egenskapen Constraints till ett RouteValueDictionary objekt som innehåller värden som antingen är reguljära uttryck eller IRouteConstraint objekt. Dessa värden används för att avgöra om ett parametervärde är giltigt.

Konstruktorer

Name Description
Route(String, IRouteHandler)

Initierar en ny instans av Route klassen med hjälp av det angivna URL-mönstret och hanterarklassen.
Route(String, RouteValueDictionary, IRouteHandler)

Initierar en ny instans av Route klassen med hjälp av det angivna URL-mönstret, standardparametervärdena och hanterarklassen.
Route(String, RouteValueDictionary, RouteValueDictionary, IRouteHandler)

Initierar en ny instans av Route klassen med hjälp av det angivna URL-mönstret, standardparametervärden, begränsningar och hanterarklass.
Route(String, RouteValueDictionary, RouteValueDictionary, RouteValueDictionary, IRouteHandler)

Initierar en ny instans av Route klassen med hjälp av det angivna URL-mönstret, standardparametervärden, begränsningar, anpassade värden och hanterarklass.

Egenskaper

Name Description
Constraints

Hämtar eller anger en ordlista med uttryck som anger giltiga värden för en URL-parameter.
DataTokens

Hämtar eller anger anpassade värden som skickas till väghanteraren, men som inte används för att avgöra om vägen matchar ett URL-mönster.
Defaults

Hämtar eller anger de värden som ska användas om URL:en inte innehåller alla parametrar.
RouteExistingFiles

Hämtar eller anger ett värde som anger om ASP.NET routning ska hantera URL:er som matchar en befintlig fil.

(Ärvd från RouteBase)
RouteHandler

Hämtar eller anger det objekt som bearbetar begäranden för vägen.
Url

Hämtar eller anger URL-mönstret för vägen.

Metoder

Name Description
Equals(Object)

Avgör om det angivna objektet är lika med det aktuella objektet.

(Ärvd från Object)
GetHashCode()

Fungerar som standard-hash-funktion.

(Ärvd från Object)
GetRouteData(HttpContextBase)

Returnerar information om den begärda vägen.
GetType()

Hämtar den aktuella instansen Type .

(Ärvd från Object)
GetVirtualPath(RequestContext, RouteValueDictionary)

Returnerar information om url:en som är associerad med vägen.
MemberwiseClone()

Skapar en ytlig kopia av den aktuella Object.

(Ärvd från Object)
ProcessConstraint(HttpContextBase, Object, String, RouteValueDictionary, RouteDirection)

Avgör om ett parametervärde matchar villkoret för parametern.
ToString()

Returnerar en sträng som representerar det aktuella objektet.

(Ärvd från Object)

Gäller för

Se även