Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
RouteValueExpressionBuilder Class

RouteValueExpressionBuilder Class

.NET Framework 4.6 and 4.5

Retrieves the value that corresponds to a specified URL parameter in a routed page.


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

public class RouteValueExpressionBuilder : ExpressionBuilder

The RouteValueExpressionBuilder type exposes the following members.

Public methodRouteValueExpressionBuilderInitializes a new instance of the RouteValueExpressionBuilder class.

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

Public methodEquals(Object)Determines whether the specified object is equal to the current object. (Inherited from Object.)
Public methodEvaluateExpressionRetrieves the value that corresponds to a specified route key. (Overrides ExpressionBuilder.EvaluateExpression(Object, BoundPropertyEntry, Object, ExpressionBuilderContext).)
Protected methodFinalizeAllows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
Public methodGetCodeExpressionReturns a code expression that is used to perform the property assignment in the generated page class. (Overrides ExpressionBuilder.GetCodeExpression(BoundPropertyEntry, Object, ExpressionBuilderContext).)
Public methodGetHashCodeServes as the default hash function. (Inherited from Object.)
Public methodStatic memberGetRouteValueRetrieves the value that corresponds to the specified URL parameter.
Public methodGetTypeGets the Type of the current instance. (Inherited from Object.)
Protected methodMemberwiseCloneCreates a shallow copy of the current Object. (Inherited from Object.)
Public methodParseExpressionWhen overridden in a derived class, returns an object that represents the parsed expression. (Inherited from ExpressionBuilder.)
Public methodToStringReturns a string that represents the current object. (Inherited from Object.)

The RouteValueExpressionBuilder class makes it possible to use markup to set the property of a server control to the value of one of the URL parameters in a routed page.

The following example shows how to use markup to display the value of the URL parameter searchterm. The route is defined by using http://www.contoso.com/search/{searchterm} as the URL pattern.

<asp:Label ID="Label1" runat="server"
    text="<%$ RouteValue:searchterm %>">

If the page is requested with the URL http://www.contoso.com/search/Bicycles, the Label control displays "Bicycles".

.NET Framework

Supported in: 4.6, 4.5, 4

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