This documentation is archived and is not being maintained.

IRouteConstraint::Match Method

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

Namespace:  System.Web.Routing
Assembly:  System.Web.Routing (in System.Web.Routing.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.

Windows 7, Windows Vista, Windows XP SP2, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

.NET Framework

Supported in: 3.5 SP1
Show: