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。

C#

public void RedirectToRoute (object routeValues);

參數

routeValues

Object

路由參數值。

例外狀況

InvalidOperationException

沒有路由對應到指定的路由參數。

HttpException

在 HTTP 標頭送出之後嘗試重新導向。

範例

下列範例示範如何呼叫這個方法，以重新導向至具有具名 productid 和 category參數的路由。

C#

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

備註

提供這個方法以方便撰寫程序代碼。 這相當於呼叫 方法， Redirect(String, Boolean) 並將第二個參數設定為 false。

這個方法會使用 RouteValueDictionary.RouteValueDictionary(Object) 建構函式，將傳入routeValues物件的物件System.Web.Routing.RouteValueDictionary轉換成 物件。 RouteCollection.GetVirtualPath接著會呼叫 方法來判斷 URL。

ASP.NET 傳回 302 HTTP 狀態代碼來執行重新導向。

另請參閱

• ASP.NET 路由

RedirectToRoute(String)

使用路由名稱，將要求重新導向至新的 URL。

C#

public void RedirectToRoute (string routeName);

參數

routeName

String

路由的名稱。

例外狀況

InvalidOperationException

沒有路由對應到指定的路由參數。

HttpException

在 HTTP 標頭送出之後嘗試重新導向。

範例

下列範例示範如何呼叫這個方法，以重新導向至名為 Products的路由。

C#

Response.RedirectToRoute("Products");

備註

提供這個方法以方便撰寫程序代碼。 這相當於呼叫 方法， Redirect(String, Boolean) 並將第二個參數設定為 false。

這個方法會使用 RouteCollection.GetVirtualPath 方法，將傳入 routeName URL 的路由名稱轉換為 URL。

ASP.NET 傳回 302 HTTP 狀態代碼來執行重新導向。

另請參閱

• ASP.NET 路由

RedirectToRoute(RouteValueDictionary)

使用路由參數值，將要求重新導向至新的 URL。

C#

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

參數

routeValues

RouteValueDictionary

路由參數值。

例外狀況

InvalidOperationException

沒有路由對應到指定的路由參數。

HttpException

在 HTTP 標頭送出之後嘗試重新導向。

範例

下列範例示範如何呼叫這個方法，以重新導向至具有具名 productid 和 category參數的路由。

C#

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

備註

提供這個方法以方便撰寫程序代碼。 這相當於呼叫 方法， Redirect(String, Boolean) 並將第二個參數設定為 false。

這個方法會 RouteCollection.GetVirtualPath 呼叫 方法來判斷 URL。

ASP.NET 傳回 302 HTTP 狀態代碼來執行重新導向。

另請參閱

• ASP.NET 路由

RedirectToRoute(String, Object)

使用路由參數值及路由名稱，將要求重新導向至新的 URL。

C#

public void RedirectToRoute (string routeName, object routeValues);

參數

routeName

String

路由的名稱。

routeValues

Object

路由參數值。

例外狀況

InvalidOperationException

沒有路由對應到指定的路由參數。

HttpException

在 HTTP 標頭送出之後嘗試重新導向。

範例

下列範例示範如何呼叫這個方法，以重新導向至名為 Product 的路由，以及具有名為 productid 和 category的參數。

C#

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

備註

提供這個方法以方便撰寫程序代碼。 這相當於呼叫 方法， Redirect(String, Boolean) 並將第二個參數設定為 false。

這個方法會使用 RouteValueDictionary.RouteValueDictionary(Object) 建構函式，將傳入routeValues物件的物件System.Web.Routing.RouteValueDictionary轉換成 物件。 RouteCollection.GetVirtualPath接著會呼叫 方法來判斷 URL。

ASP.NET 傳回 302 HTTP 狀態代碼來執行重新導向。

另請參閱

• ASP.NET 路由

RedirectToRoute(String, RouteValueDictionary)

使用路由參數值及路由名稱，將要求重新導向至新的 URL。

C#

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

參數

routeName

String

路由的名稱。

routeValues

RouteValueDictionary

路由參數值。

例外狀況

InvalidOperationException

沒有路由對應到指定的路由參數。

HttpException

在 HTTP 標頭送出之後嘗試重新導向。

範例

下列範例示範如何呼叫這個方法，以重新導向至名為 Product 的路由，以及具有名為 productid 和 category的參數。

C#

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

備註

提供這個方法以方便撰寫程序代碼。 這相當於呼叫 方法， Redirect(String, Boolean) 並將第二個參數設定為 false。

系統會 RouteCollection.GetVirtualPath 呼叫 方法來判斷 URL。

ASP.NET 傳回 302 HTTP 狀態代碼來執行重新導向。

另請參閱

• ASP.NET 路由