Route Klas

Definitie

Naamruimte:
System.Web.Routing
Assembly:
System.Web.Routing.dll
Assembly:
System.Web.dll

Biedt eigenschappen en methoden voor het definiëren van een route en voor het verkrijgen van informatie over de route.

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
Overname
Object
RouteBase
Route
Afgeleid

Voorbeelden

In het volgende voorbeeld ziet u hoe u een Route object maakt en aan de Routes eigenschap toevoegt.

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

Opmerkingen

Met de klasse Route kunt u opgeven hoe routering wordt verwerkt in een ASP.NET toepassing. U maakt een Route object voor elk URL-patroon dat u wilt toewijzen aan een klasse die aanvragen kan verwerken die overeenkomen met dat patroon. Vervolgens voegt u de route toe aan de Routes verzameling. Wanneer de toepassing een aanvraag ontvangt, ASP.NET routering doorloopt via de routes in de verzameling Routes om de eerste route te vinden die overeenkomt met het patroon van de URL.

Stel de Url eigenschap in op een URL-patroon. Het URL-patroon bestaat uit segmenten die achter de naam van de toepassing in een HTTP-aanvraag komen. In de URL http://www.contoso.com/products/show/beveragesis het patroon bijvoorbeeld van products/show/beveragestoepassing op . Een patroon met drie segmenten, zoals {controller}/{action}/{id}, komt overeen met de URL http://www.contoso.com/products/show/beverages. Elk segment wordt gescheiden door het / teken. Wanneer een segment tussen accolades ({ en }) staat, wordt het segment naar een URL-parameter verwezen. ASP.NET routering haalt de waarde op uit de aanvraag en wijst deze toe aan de URL-parameter. In het vorige voorbeeld wordt aan de URL-parameter action de waarde showtoegewezen. Als het segment niet tussen accolades staat, wordt de waarde beschouwd als een letterlijke waarde.

Stel de Defaults eigenschap in op een RouteValueDictionary object dat waarden bevat die worden gebruikt als een parameter ontbreekt in de URL of om extra waarden in te stellen die niet in de URL worden geparameteriseerd. Stel de Constraints eigenschap in op een RouteValueDictionary object dat waarden bevat die reguliere expressies of IRouteConstraint objecten zijn. Deze waarden worden gebruikt om te bepalen of een parameterwaarde geldig is.

Constructors

Name Description
Route(String, IRouteHandler)

Initialiseert een nieuw exemplaar van de Route klasse met behulp van het opgegeven URL-patroon en de handlerklasse.
Route(String, RouteValueDictionary, IRouteHandler)

Initialiseert een nieuw exemplaar van de Route klasse met behulp van het opgegeven URL-patroon, de standaardparameterwaarden en de handlerklasse.
Route(String, RouteValueDictionary, RouteValueDictionary, IRouteHandler)

Initialiseert een nieuw exemplaar van de Route klasse met behulp van het opgegeven URL-patroon, standaardparameterwaarden, beperkingen en handlerklasse.
Route(String, RouteValueDictionary, RouteValueDictionary, RouteValueDictionary, IRouteHandler)

Initialiseert een nieuw exemplaar van de Route klasse met behulp van het opgegeven URL-patroon, standaardparameterwaarden, beperkingen, aangepaste waarden en handlerklasse.

Eigenschappen

Name Description
Constraints

Hiermee wordt een woordenlijst met expressies opgehaald of ingesteld waarmee geldige waarden voor een URL-parameter worden opgegeven.
DataTokens

Hiermee worden aangepaste waarden opgehaald of ingesteld die worden doorgegeven aan de route-handler, maar die niet worden gebruikt om te bepalen of de route overeenkomt met een URL-patroon.
Defaults

Hiermee worden de waarden opgehaald of ingesteld die moeten worden gebruikt als de URL niet alle parameters bevat.
RouteExistingFiles

Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of ASP.NET routering URL's moet verwerken die overeenkomen met een bestaand bestand.

(Overgenomen van RouteBase)
RouteHandler

Hiermee wordt het object opgehaald of ingesteld waarmee aanvragen voor de route worden verwerkt.
Url

Hiermee haalt u het URL-patroon voor de route op of stelt u dit in.

Methoden

Name Description
Equals(Object)

Bepaalt of het opgegeven object gelijk is aan het huidige object.

(Overgenomen van Object)
GetHashCode()

Fungeert als de standaardhashfunctie.

(Overgenomen van Object)
GetRouteData(HttpContextBase)

Retourneert informatie over de aangevraagde route.
GetType()

Hiermee haalt u de Type huidige instantie op.

(Overgenomen van Object)
GetVirtualPath(RequestContext, RouteValueDictionary)

Retourneert informatie over de URL die is gekoppeld aan de route.
MemberwiseClone()

Hiermee maakt u een ondiepe kopie van de huidige Object.

(Overgenomen van Object)
ProcessConstraint(HttpContextBase, Object, String, RouteValueDictionary, RouteDirection)

Bepaalt of een parameterwaarde overeenkomt met de beperking voor die parameter.
ToString()

Retourneert een tekenreeks die het huidige object vertegenwoordigt.

(Overgenomen van Object)

Van toepassing op

Zie ook