RouteUrlExpressionBuilder Class

Creates a URL that corresponds to specified URL parameter values.

System.Object
  System.Web.Compilation.ExpressionBuilder
    System.Web.Compilation.RouteUrlExpressionBuilder

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

public class RouteUrlExpressionBuilder : ExpressionBuilder

The RouteUrlExpressionBuilder type exposes the following members.

  NameDescription
Public methodRouteUrlExpressionBuilderInitializes a new instance of the RouteUrlExpressionBuilder class.
Top

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

  NameDescription
Public methodEquals(Object)Determines whether the specified object is equal to the current object. (Inherited from Object.)
Public methodEvaluateExpressionCreates a URL that corresponds to specified URL parameter values and to a route URL format. (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 memberGetRouteUrlCreates a URL that corresponds to specified route keys for a route URL format.
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.)
Public methodStatic memberTryParseRouteExpressionParses an expression into a collection of route keys and values, and optionally into a route name.
Top

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 http://www.contoso.com/search/{searchterm} as the URL pattern.

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

The URL generated for this hyperlink would be http://www.contoso.com/search/Bicycles.

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
</asp:HyperLink>

.NET Framework

Supported in: 4.5, 4

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

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

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft