Control.GetRouteUrl メソッド

定義

名前空間:
System.Web.UI
アセンブリ:
System.Web.dll

ルート パラメーターのセットに対応する URL を取得します。オプションで、ルート名に対応する URL も取得します。Gets the URL that corresponds to a set of route parameters, and optionally to a route name.

オーバーロード

GetRouteUrl(Object)

ルート パラメーターのセットに対応する URL を取得します。Gets the URL that corresponds to a set of route parameters.
GetRouteUrl(RouteValueDictionary)

ルート パラメーターのセットに対応する URL を取得します。Gets the URL that corresponds to a set of route parameters.
GetRouteUrl(String, Object)

ルート パラメーターのセットおよびルート名に対応する URL を取得します。Gets the URL that corresponds to a set of route parameters and a route name.
GetRouteUrl(String, RouteValueDictionary)

ルート パラメーターのセットおよびルート名に対応する URL を取得します。Gets the URL that corresponds to a set of route parameters and a route name.

注釈

このメソッドは、コーディングの便宜を実現するために用意されています。This method is provided for coding convenience. これは、メソッドを呼び出すことと同じです RouteCollection.GetVirtualPath 。It is equivalent to calling the RouteCollection.GetVirtualPath method.

GetRouteUrl(Object)

ルート パラメーターのセットに対応する URL を取得します。Gets the URL that corresponds to a set of route parameters.

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

ルート パラメーター。The route parameters.

戻り値

String

指定されたルート パラメーターに対応する URL。The URL that corresponds to the specified route parameters.

例

次の例は、メソッドを呼び出して、 Control.GetRouteUrl とという名前のパラメーターを持つルートの URL を取得する方法を示して productid category います。The following example shows how to call the Control.GetRouteUrl method to get the URL of a route that has parameters that are named productid and category. この例では、という名前のコントロールが作成されていることを前提としてい HyperLink HyperLink1 ます。This example assumes that you have created a HyperLink control that is named HyperLink1.

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

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

注釈

このメソッドは、コーディングの便宜を実現するために用意されています。This method is provided for coding convenience. これは、メソッドを呼び出すことと同じです RouteCollection.GetVirtualPath(RequestContext, RouteValueDictionary) 。It is equivalent to calling the RouteCollection.GetVirtualPath(RequestContext, RouteValueDictionary) method. このメソッドは、コンストラクターを使用して、渡されたオブジェクト routeParameters をオブジェクトに変換し RouteValueDictionary RouteValueDictionary.RouteValueDictionary(Object) ます。This method converts the object that is passed in routeParameters to a RouteValueDictionary object by using the RouteValueDictionary.RouteValueDictionary(Object) constructor.

適用対象

GetRouteUrl(RouteValueDictionary)

ルート パラメーターのセットに対応する URL を取得します。Gets the URL that corresponds to a set of route parameters.

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

ルート パラメーター。The route parameters.

戻り値

String

指定されたルート パラメーターに対応する URL。The URL that corresponds to the specified route parameters.

例

次の例は、このメソッドを呼び出して、とという名前のパラメーターを持つルートの URL を取得する方法を示して productid category います。The following example shows how to call this method to get the URL of a route that has parameters that are named productid and category. この例では、という名前のコントロールが作成されていることを前提としてい HyperLink HyperLink1 ます。This example assumes that you have created a HyperLink control that is named HyperLink1.

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

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

注釈

このメソッドは、コーディングの便宜を実現するために用意されています。This method is provided for coding convenience. これは、メソッドを呼び出すことと同じです RouteCollection.GetVirtualPath(RequestContext, RouteValueDictionary) 。It is equivalent to calling the RouteCollection.GetVirtualPath(RequestContext, RouteValueDictionary) method.

適用対象

GetRouteUrl(String, Object)

ルート パラメーターのセットおよびルート名に対応する URL を取得します。Gets the URL that corresponds to a set of route parameters and a route name.

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

ルートの名前です。The name of the route.

routeParameters
Object

ルート パラメーター。The route parameters.

戻り値

String

指定したルート パラメーターおよびルート名に対応する URL。The URL that corresponds to the specified route parameters and route name.

例

次の例では、このメソッドを呼び出してという名前のルートの URL を取得し、 Product という名前のパラメーターを持つ方法を示し productid category ます。The following example shows how to call this method to get the URL of a route that is named Product and has parameters that are named productid and category. この例では、という名前のコントロールが作成されていることを前提としてい HyperLink HyperLink1 ます。This example assumes that you have created a HyperLink control that is named HyperLink1.

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

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

注釈

このメソッドは、コーディングの便宜を実現するために用意されています。This method is provided for coding convenience. これは、メソッドを呼び出すことと同じです RouteCollection.GetVirtualPath(RequestContext, String, RouteValueDictionary) 。It is equivalent to calling the RouteCollection.GetVirtualPath(RequestContext, String, RouteValueDictionary) method. このメソッドは、コンストラクターを使用して、渡されたオブジェクト routeParameters をオブジェクトに変換し RouteValueDictionary RouteValueDictionary.RouteValueDictionary(Object) ます。This method converts the object that is passed in routeParameters to a RouteValueDictionary object by using the RouteValueDictionary.RouteValueDictionary(Object) constructor.

適用対象

GetRouteUrl(String, RouteValueDictionary)

ルート パラメーターのセットおよびルート名に対応する URL を取得します。Gets the URL that corresponds to a set of route parameters and a route name.

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

ルートの名前です。The name of the route.

routeParameters
RouteValueDictionary

ルート パラメーター。The route parameters.

戻り値

String

指定したルート パラメーターおよびルート名に対応する URL。The URL that corresponds to the specified route parameters and route name.

例

次の例では、このメソッドを呼び出してという名前のルートの URL を取得し、 Product という名前のパラメーターを持つ方法を示し productid category ます。The following example shows how to call this method to get the URL of a route that is named Product and has parameters that are named productid and category. この例では、という名前のコントロールが作成されていることを前提としてい HyperLink HyperLink1 ます。This example assumes that you have created a HyperLink control that is named HyperLink1.

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

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

注釈

このメソッドは、コーディングの便宜を実現するために用意されています。This method is provided for coding convenience. これは、メソッドを呼び出すことと同じです RouteCollection.GetVirtualPath(RequestContext, String, RouteValueDictionary) 。It is equivalent to calling the RouteCollection.GetVirtualPath(RequestContext, String, RouteValueDictionary) method.

適用対象