RouteUrlExpressionBuilder Class

.NET Framework (current version)

The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

Creates a URL that corresponds to specified URL parameter values.

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


public class RouteUrlExpressionBuilder : ExpressionBuilder


Initializes a new instance of the RouteUrlExpressionBuilder class.


Gets a value that indicates whether an expression can be evaluated in a page that is not compiled.(Overrides ExpressionBuilder.SupportsEvaluate.)


Determines whether the specified object is equal to the current object.(Inherited from Object.)

System_CAPS_pubmethodEvaluateExpression(Object, BoundPropertyEntry, Object, ExpressionBuilderContext)

Creates a URL that corresponds to specified URL parameter values and to a route URL format.(Overrides ExpressionBuilder.EvaluateExpression(Object, BoundPropertyEntry, Object, ExpressionBuilderContext).)


Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.(Inherited from Object.)

System_CAPS_pubmethodGetCodeExpression(BoundPropertyEntry, Object, ExpressionBuilderContext)

Returns a code expression that is used to perform the property assignment in the generated page class.(Overrides ExpressionBuilder.GetCodeExpression(BoundPropertyEntry, Object, ExpressionBuilderContext).)


Serves as the default hash function. (Inherited from Object.)

System_CAPS_pubmethodSystem_CAPS_staticGetRouteUrl(Control, String)

Creates a URL that corresponds to specified route keys for a route URL format.


Gets the Type of the current instance.(Inherited from Object.)


Creates a shallow copy of the current Object.(Inherited from Object.)

System_CAPS_pubmethodParseExpression(String, Type, ExpressionBuilderContext)

When overridden in a derived class, returns an object that represents the parsed expression.(Inherited from ExpressionBuilder.)


Returns a string that represents the current object.(Inherited from Object.)

System_CAPS_pubmethodSystem_CAPS_staticTryParseRouteExpression(String, RouteValueDictionary, String)

Parses an expression into a collection of route keys and values, and optionally into a route name.

The RouteUrlExpressionBuilder class makes it possible to set the property of a server control to the URL of a route by providing a list of URL parameter values.

The following example shows how to create markup that generates a hyperlink with a URL that is formatted for a route. The route is defined by using{searchterm} as the URL pattern.

<asp:HyperLink ID="HyperLink1" runat="server"
               NavigateUrl="<%$ RouteUrl:searchterm=Bicycles %>">
  Search for Bicycles

The URL generated for this hyperlink would be

If the URL parameters provided to the RouteUrl expression are not sufficient to uniquely identify a route, you must include the route name. For example, if a Web application has two routes with searchterm as the sole URL parameter, the routes would have to be defined by using route names, and the hyperlink markup would resemble the following example:

<asp:HyperLink ID="HyperLink1" runat="server"
               NavigateUrl="<%$ RouteUrl:searchterm=Bicycles,
               routename=BasicSearchRoute %>">
  Search for Bicycles

.NET Framework
Available since 4.0

Any public static ( Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

Return to top