Control.GetRouteUrl 方法

定義

命名空間:

System.Web.UI

組件:

System.Web.dll

取得 URL，此 URL 對應於一組路由參數，而且會選擇性地對應到路由名稱。

多載

GetRouteUrl(Object)	取得會對應於一組路由參數的 URL。
GetRouteUrl(RouteValueDictionary)	取得會對應於一組路由參數的 URL。
GetRouteUrl(String, Object)	取得 URL，此 URL 對應於一組路由參數及一個路由名稱。
GetRouteUrl(String, RouteValueDictionary)	取得 URL，此 URL 對應於一組路由參數及一個路由名稱。

備註

這個方法可供撰寫程式代碼方便使用。 它相當於呼叫 RouteCollection.GetVirtualPath 方法。

GetRouteUrl(Object)

取得會對應於一組路由參數的 URL。

public:
 System::String ^ GetRouteUrl(System::Object ^ routeParameters);

public string GetRouteUrl (object routeParameters);

member this.GetRouteUrl : obj -> string

Public Function GetRouteUrl (routeParameters As Object) As String

參數

routeParameters

Object

路由參數。

傳回

String

對應於指定之路由參數的 URL。

範例

下列範例示範如何呼叫 Control.GetRouteUrl 方法，以取得具有名為 productid 和 category之參數之路由的 URL。 此範例假設您已建立 HyperLink 名為 的 HyperLink1控制件。

HyperLink1.NavigateUrl = HyperLink1.GetRouteUrl(
  New With {.productid = "1", .category = "widgets"})

HyperLink1.NavigateUrl = HyperLink1.GetRouteUrl(
  new { productid = "1", category = "widgets" });

備註

這個方法可供撰寫程式代碼方便使用。 它相當於呼叫 RouteCollection.GetVirtualPath(RequestContext, RouteValueDictionary) 方法。 這個方法會使用 RouteValueDictionary.RouteValueDictionary(Object) 建構函式，將傳入 routeParameters 的物件轉換成 RouteValueDictionary 物件。

另請參閱

• ASP.NET 路由

GetRouteUrl(RouteValueDictionary)

取得會對應於一組路由參數的 URL。

public:
 System::String ^ GetRouteUrl(System::Web::Routing::RouteValueDictionary ^ routeParameters);

public string GetRouteUrl (System.Web.Routing.RouteValueDictionary routeParameters);

member this.GetRouteUrl : System.Web.Routing.RouteValueDictionary -> string

Public Function GetRouteUrl (routeParameters As RouteValueDictionary) As String

參數

routeParameters

RouteValueDictionary

路由參數。

傳回

String

對應於指定之路由參數的 URL。

範例

下列範例示範如何呼叫這個方法，以取得具有名稱 productid 為 和 category之參數的路由 URL。 此範例假設您已建立 HyperLink 名為 的 HyperLink1控制件。

HyperLink1.NavigateUrl = HyperLink1.GetRouteUrl(
  new RouteValueDictionary {productId="1", category="widgets"})

HyperLink1.NavigateUrl = HyperLink1.GetRouteUrl(
  (new RouteValueDictionary {productId="1", category="widgets"});

備註

這個方法可供撰寫程式代碼方便使用。 它相當於呼叫 RouteCollection.GetVirtualPath(RequestContext, RouteValueDictionary) 方法。

另請參閱

• ASP.NET 路由

GetRouteUrl(String, Object)

取得 URL，此 URL 對應於一組路由參數及一個路由名稱。

public:
 System::String ^ GetRouteUrl(System::String ^ routeName, System::Object ^ routeParameters);

public string GetRouteUrl (string routeName, object routeParameters);

member this.GetRouteUrl : string * obj -> string

Public Function GetRouteUrl (routeName As String, routeParameters As Object) As String

參數

routeName

String

路由的名稱。

routeParameters

Object

路由參數。

傳回

String

對應於指定之路由參數及路由名稱的 URL。

範例

下列範例示範如何呼叫這個方法，以取得名為 Product 的路由URL，並具有名為 productid 和 category的參數。 此範例假設您已建立 HyperLink 名為 的 HyperLink1控制件。

HyperLink1.NavigateUrl = HyperLink1.GetRouteUrl("Product",
  New With {.productid = "1", .category = "widgets"})

HyperLink1.NavigateUrl = HyperLink1.GetRouteUrl("Product",
  new { productid = "1", category = "widgets" });

備註

這個方法可供撰寫程式代碼方便使用。 它相當於呼叫 RouteCollection.GetVirtualPath(RequestContext, String, RouteValueDictionary) 方法。 這個方法會使用 RouteValueDictionary.RouteValueDictionary(Object) 建構函式，將傳入 routeParameters 的物件轉換成 RouteValueDictionary 物件。

另請參閱

• ASP.NET 路由

GetRouteUrl(String, RouteValueDictionary)

取得 URL，此 URL 對應於一組路由參數及一個路由名稱。

public:
 System::String ^ GetRouteUrl(System::String ^ routeName, System::Web::Routing::RouteValueDictionary ^ routeParameters);

public string GetRouteUrl (string routeName, System.Web.Routing.RouteValueDictionary routeParameters);

member this.GetRouteUrl : string * System.Web.Routing.RouteValueDictionary -> string

Public Function GetRouteUrl (routeName As String, routeParameters As RouteValueDictionary) As String

參數

routeName

String

路由的名稱。

routeParameters

RouteValueDictionary

路由參數。

傳回

String

對應於指定之路由參數及路由名稱的 URL。

範例

下列範例示範如何呼叫這個方法，以取得名為 Product 的路由URL，並具有名為 productid 和 category的參數。 此範例假設您已建立 HyperLink 名為 的 HyperLink1控制件。

HyperLink1.NavigateUrl = HyperLink1.GetRouteUrl("Product",
  new RouteValueDictionary {productId="1", category="widgets"})

HyperLink1.NavigateUrl = HyperLink1.GetRouteUrl("Product",
  (new RouteValueDictionary {productId="1", category="widgets"});

備註

這個方法可供撰寫程式代碼方便使用。 它相當於呼叫 RouteCollection.GetVirtualPath(RequestContext, String, RouteValueDictionary) 方法。

另請參閱

• ASP.NET 路由