HttpResponse.RedirectToRoute メソッド

定義

名前空間:

System.Web

アセンブリ:

System.Web.dll

ルートのパラメーター値とルート名の両方またはいずれかを使用して、新しい URL に要求をリダイレクトします。

オーバーロード

RedirectToRoute(Object)	ルートのパラメーター値を使用して、新しい URL に要求をリダイレクトします。
RedirectToRoute(String)	ルート名を使用して、新しい URL に要求をリダイレクトします。
RedirectToRoute(RouteValueDictionary)	ルートのパラメーター値を使用して、新しい URL に要求をリダイレクトします。
RedirectToRoute(String, Object)	ルートのパラメーター値とルート名を使用して、新しい URL に要求をリダイレクトします。
RedirectToRoute(String, RouteValueDictionary)	ルートのパラメーター値とルート名を使用して、新しい URL に要求をリダイレクトします。

RedirectToRoute(Object)

ルートのパラメーター値を使用して、新しい URL に要求をリダイレクトします。

public:
 void RedirectToRoute(System::Object ^ routeValues);

public void RedirectToRoute (object routeValues);

member this.RedirectToRoute : obj -> unit

Public Sub RedirectToRoute (routeValues As Object)

パラメーター

routeValues

Object

ルートのパラメーター値。

例外

InvalidOperationException

指定されたルート パラメーターに対応するルートがありません。

HttpException

HTTP ヘッダーが送信された後にリダイレクトしようとしました。

例

次の例では、このメソッドを呼び出して、 および categoryという名前productidのパラメーターを持つルートにリダイレクトする方法を示します。

Response.RedirectToRoute(
  New With {.productid = "1", .category = "widgets"})

Response.RedirectToRoute(
  new { productid = "1", category = "widgets" });

注釈

このメソッドは、コーディングの利便性を高める目的で提供されます。 これは、2 番目のパラメーターを にfalse設定して Redirect(String, Boolean) メソッドを呼び出すことと同じです。

このメソッドは、 コンストラクターを使用して オブジェクトにSystem.Web.Routing.RouteValueDictionary渡されるrouteValuesオブジェクトをRouteValueDictionary.RouteValueDictionary(Object)変換します。 RouteCollection.GetVirtualPathその後、 メソッドが呼び出され、URL が決定されます。

ASP.NET は、302 HTTP 状態コードを返すことによってリダイレクトを実行します。

こちらもご覧ください

• ASP.NET ルーティング

RedirectToRoute(String)

ルート名を使用して、新しい URL に要求をリダイレクトします。

public:
 void RedirectToRoute(System::String ^ routeName);

public void RedirectToRoute (string routeName);

member this.RedirectToRoute : string -> unit

Public Sub RedirectToRoute (routeName As String)

パラメーター

routeName

String

ルートの名前。

例外

InvalidOperationException

指定されたルート パラメーターに対応するルートがありません。

HttpException

HTTP ヘッダーが送信された後にリダイレクトしようとしました。

例

次の例では、このメソッドを呼び出して、 という名前 Productsのルートにリダイレクトする方法を示します。

Response.RedirectToRoute("Products")

Response.RedirectToRoute("Products");

注釈

このメソッドは、コーディングの利便性を高める目的で提供されます。 これは、2 番目のパラメーターを にfalse設定して Redirect(String, Boolean) メソッドを呼び出すことと同じです。

このメソッドは、 メソッドを使用して URL に渡される routeName ルート名を RouteCollection.GetVirtualPath 変換します。

ASP.NET は、302 HTTP 状態コードを返すことによってリダイレクトを実行します。

こちらもご覧ください

• ASP.NET ルーティング

RedirectToRoute(RouteValueDictionary)

ルートのパラメーター値を使用して、新しい URL に要求をリダイレクトします。

public:
 void RedirectToRoute(System::Web::Routing::RouteValueDictionary ^ routeValues);

public void RedirectToRoute (System.Web.Routing.RouteValueDictionary routeValues);

member this.RedirectToRoute : System.Web.Routing.RouteValueDictionary -> unit

Public Sub RedirectToRoute (routeValues As RouteValueDictionary)

パラメーター

routeValues

RouteValueDictionary

ルートのパラメーター値。

例外

InvalidOperationException

指定されたルート パラメーターに対応するルートがありません。

HttpException

HTTP ヘッダーが送信された後にリダイレクトしようとしました。

例

次の例では、このメソッドを呼び出して、 および categoryという名前productidのパラメーターを持つルートにリダイレクトする方法を示します。

Response.RedirectToRoute(
  new RouteValueDictionary {productId="1", category="widgets"})

Response.RedirectToRoute(
  (new RouteValueDictionary {productId="1", category="widgets"});

注釈

このメソッドは、コーディングの利便性を高める目的で提供されます。 これは、2 番目のパラメーターを にfalse設定して Redirect(String, Boolean) メソッドを呼び出すことと同じです。

このメソッドは、 メソッドを RouteCollection.GetVirtualPath 呼び出して URL を決定します。

ASP.NET は、302 HTTP 状態コードを返すことによってリダイレクトを実行します。

こちらもご覧ください

• ASP.NET ルーティング

RedirectToRoute(String, Object)

ルートのパラメーター値とルート名を使用して、新しい URL に要求をリダイレクトします。

public:
 void RedirectToRoute(System::String ^ routeName, System::Object ^ routeValues);

public void RedirectToRoute (string routeName, object routeValues);

member this.RedirectToRoute : string * obj -> unit

Public Sub RedirectToRoute (routeName As String, routeValues As Object)

パラメーター

routeName

String

ルートの名前。

routeValues

Object

ルートのパラメーター値。

例外

InvalidOperationException

指定されたルート パラメーターに対応するルートがありません。

HttpException

HTTP ヘッダーが送信された後にリダイレクトしようとしました。

例

次の例では、このメソッドを呼び出して、 および という名前Productのパラメーターを持つルートにリダイレクトするcategoryproductid方法を示します。

Response.RedirectToRoute("Product",
  New With {.productid = "1", .category = "widgets"})

Response.RedirectToRoute("Product",
  new { productid = "1", category = "widgets" });

注釈

このメソッドは、コーディングの利便性を高める目的で提供されます。 これは、2 番目のパラメーターを にfalse設定して Redirect(String, Boolean) メソッドを呼び出すことと同じです。

このメソッドは、 コンストラクターを使用して オブジェクトにSystem.Web.Routing.RouteValueDictionary渡されるrouteValuesオブジェクトをRouteValueDictionary.RouteValueDictionary(Object)変換します。 RouteCollection.GetVirtualPathその後、 メソッドが呼び出され、URL が決定されます。

ASP.NET は、302 HTTP 状態コードを返すことによってリダイレクトを実行します。

こちらもご覧ください

• ASP.NET ルーティング

RedirectToRoute(String, RouteValueDictionary)

ルートのパラメーター値とルート名を使用して、新しい URL に要求をリダイレクトします。

public:
 void RedirectToRoute(System::String ^ routeName, System::Web::Routing::RouteValueDictionary ^ routeValues);

public void RedirectToRoute (string routeName, System.Web.Routing.RouteValueDictionary routeValues);

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

Public Sub RedirectToRoute (routeName As String, routeValues As RouteValueDictionary)

パラメーター

routeName

String

ルートの名前。

routeValues

RouteValueDictionary

ルートのパラメーター値。

例外

InvalidOperationException

指定されたルート パラメーターに対応するルートがありません。

HttpException

HTTP ヘッダーが送信された後にリダイレクトしようとしました。

例

次の例では、このメソッドを呼び出して、 および という名前Productのパラメーターを持つルートにリダイレクトするcategoryproductid方法を示します。

Response.RedirectToRoute("Product",
  new RouteValueDictionary {productId="1", category="widgets"})

Response.RedirectToRoute("Product",
  (new RouteValueDictionary {productId="1", category="widgets"});

注釈

このメソッドは、コーディングの利便性を高める目的で提供されます。 これは、2 番目のパラメーターを にfalse設定して Redirect(String, Boolean) メソッドを呼び出すことと同じです。

メソッドが RouteCollection.GetVirtualPath 呼び出され、URL が決定されます。

ASP.NET は、302 HTTP 状態コードを返すことによってリダイレクトを実行します。

こちらもご覧ください

• ASP.NET ルーティング