RouteUrlExpressionBuilder 類別

定義

命名空間:

System.Web.Compilation

組件:

System.Web.dll

建立對應至所指定 URL 參數值的 URL。

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

繼承

Object

ExpressionBuilder

RouteUrlExpressionBuilder

範例

下列範例示範如何建立標記，以產生具有路由格式化 URL 的超連結。 路由是使用 http://www.contoso.com/search/{searchterm} 作為 URL 模式來定義。

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

針對這個超連結產生的 URL 會是 http://www.contoso.com/search/Bicycles 。

如果提供給運算式的 RouteUrl URL 參數不足以唯一識別路由，您必須包含路由名稱。 例如，如果 Web 應用程式有兩個路由 searchterm 作為唯一的 URL 參數，則必須使用路由名稱來定義路由，而超連結標記會類似下列範例：

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

備註

類別 RouteUrlExpressionBuilder 可讓您藉由提供 URL 參數值清單，將伺服器控制項的 屬性設定為路由的 URL。

建構函式

RouteUrlExpressionBuilder()

初始化 RouteUrlExpressionBuilder 類別的新執行個體。

屬性

SupportsEvaluate

取得值，這個值表示是否可在未編譯的頁面中評估運算式。

方法

Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
EvaluateExpression(Object, BoundPropertyEntry, Object, ExpressionBuilderContext)	建立對應至所指定 URL 參數值以及路由 URL 格式的 URL。
GetCodeExpression(BoundPropertyEntry, Object, ExpressionBuilderContext)	傳回程式碼運算式，用來在產生的頁面類別中執行屬性指派。
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetRouteUrl(Control, String)	建立 URL，該 URL 對應至路由 URL 格式的指定路由索引鍵。
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
ParseExpression(String, Type, ExpressionBuilderContext)	在衍生類別中覆寫時，傳回表示剖析的運算式之物件。 (繼承來源 ExpressionBuilder)
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)
TryParseRouteExpression(String, RouteValueDictionary, String)	將運算式剖析為路由索引鍵和值的集合，並且選擇性地剖析為路由名稱。

另請參閱

• ASP.NET 路由
• 如何：存取路由頁面中的 URL 參數
• ASP.NET 運算式概觀