Export (0) Print
Expand All

IRouteConstraint.Match Method

Determines whether the URL parameter contains a valid value for this constraint.

Namespace:  System.Web.Routing
Assembly:  System.Web (in System.Web.dll)

bool Match(
	HttpContextBase httpContext,
	Route route,
	string parameterName,
	RouteValueDictionary values,
	RouteDirection routeDirection
)

Parameters

httpContext
Type: System.Web.HttpContextBase

An object that encapsulates information about the HTTP request.

route
Type: System.Web.Routing.Route

The object that this constraint belongs to.

parameterName
Type: System.String

The name of the parameter that is being checked.

values
Type: System.Web.Routing.RouteValueDictionary

An object that contains the parameters for the URL.

routeDirection
Type: System.Web.Routing.RouteDirection

An object that indicates whether the constraint check is being performed when an incoming request is being handled or when a URL is being generated.

Return Value

Type: System.Boolean
true if the URL parameter contains a valid value; otherwise, false.

You use the Match method to add validation logic for the constraint. This method is called by the routing framework when an incoming request is processed and when a URL is constructed. You can determine the current scenario by examining the routeDirection parameter.

When a request is processed, the routing framework determines whether the pattern and values of the incoming request match the pattern and constraints of the route. When a URL is constructed, the routing framework determines whether the values supplied when the GetVirtualPath method is called match the pattern and constraints of the route.

.NET Framework

Supported in: 4.6, 4.5, 4, 3.5 SP1
Show:
© 2015 Microsoft