RouteUrlExpressionBuilder Class

Reference

Definition

Namespace:: System.Web.Compilation

Assembly:: System.Web.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Creates a URL that corresponds to specified URL parameter values.

public ref class RouteUrlExpressionBuilder : System::Web::Compilation::ExpressionBuilder

public class RouteUrlExpressionBuilder : System.Web.Compilation.ExpressionBuilder

type RouteUrlExpressionBuilder = class
    inherit ExpressionBuilder

Public Class RouteUrlExpressionBuilder
Inherits ExpressionBuilder

Inheritance: Object

ExpressionBuilder
RouteUrlExpressionBuilder

Examples

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>

Remarks

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.

Constructors

RouteUrlExpressionBuilder()

Initializes a new instance of the RouteUrlExpressionBuilder class.

Properties

SupportsEvaluate

Gets a value that indicates whether an expression can be evaluated in a page that is not compiled.

Methods

Equals(Object)	Determines whether the specified object is equal to the current object. (Inherited from Object)
EvaluateExpression(Object, BoundPropertyEntry, Object, ExpressionBuilderContext)	Creates a URL that corresponds to specified URL parameter values and to a route URL format.
GetCodeExpression(BoundPropertyEntry, Object, ExpressionBuilderContext)	Returns a code expression that is used to perform the property assignment in the generated page class.
GetHashCode()	Serves as the default hash function. (Inherited from Object)
GetRouteUrl(Control, String)	Creates a URL that corresponds to specified route keys for a route URL format.
GetType()	Gets the Type of the current instance. (Inherited from Object)
MemberwiseClone()	Creates a shallow copy of the current Object. (Inherited from Object)
ParseExpression(String, Type, ExpressionBuilderContext)	When overridden in a derived class, returns an object that represents the parsed expression. (Inherited from ExpressionBuilder)
ToString()	Returns a string that represents the current object. (Inherited from Object)
TryParseRouteExpression(String, RouteValueDictionary, String)	Parses an expression into a collection of route keys and values, and optionally into a route name.

Applies to