HttpResponseWrapper.RedirectToRoutePermanent 方法

定義

命名空間:

System.Web

組件:

System.Web.dll

使用指定的路由參數值、路由名稱，或是兩者都使用，執行永遠從要求的 URL 重新導向至指定的 URL。

多載

RedirectToRoutePermanent(String, Object)	使用對應至新 URL 的路由名稱及路由參數值，執行永遠從要求的 URL 重新導向至指定的 URL。
RedirectToRoutePermanent(Object)	使用指定的路由參數值，執行永遠從要求的 URL 重新導向至指定的 URL。
RedirectToRoutePermanent(String)	使用指定的路由名稱，執行永遠從要求的 URL 重新導向至指定的 URL。
RedirectToRoutePermanent(RouteValueDictionary)	使用指定的路由參數值，執行永遠從要求的 URL 重新導向至指定的 URL。
RedirectToRoutePermanent(String, RouteValueDictionary)	使用指定的路由名稱及路由參數值，執行永遠從要求的 URL 重新導向至指定的 URL。

RedirectToRoutePermanent(String, Object)

使用對應至新 URL 的路由名稱及路由參數值，執行永遠從要求的 URL 重新導向至指定的 URL。

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

public override void RedirectToRoutePermanent (string routeName, object routeValues);

override this.RedirectToRoutePermanent : string * obj -> unit

Public Overrides Sub RedirectToRoutePermanent (routeName As String, routeValues As Object)

參數

routeName

String

路由的名稱。

routeValues

Object

路由參數值。

例外狀況

InvalidOperationException

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

HttpException

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

備註

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

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

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

另請參閱

• ASP.NET 路由

RedirectToRoutePermanent(Object)

使用指定的路由參數值，執行永遠從要求的 URL 重新導向至指定的 URL。

public:
 override void RedirectToRoutePermanent(System::Object ^ routeValues);

public override void RedirectToRoutePermanent (object routeValues);

override this.RedirectToRoutePermanent : obj -> unit

Public Overrides Sub RedirectToRoutePermanent (routeValues As Object)

參數

routeValues

Object

路由參數值。

例外狀況

InvalidOperationException

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

HttpException

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

備註

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

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

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

另請參閱

• ASP.NET 路由

RedirectToRoutePermanent(String)

使用指定的路由名稱，執行永遠從要求的 URL 重新導向至指定的 URL。

public:
 override void RedirectToRoutePermanent(System::String ^ routeName);

public override void RedirectToRoutePermanent (string routeName);

override this.RedirectToRoutePermanent : string -> unit

Public Overrides Sub RedirectToRoutePermanent (routeName As String)

參數

routeName

String

路由的名稱。

例外狀況

InvalidOperationException

沒有路由對應至指定的路由名稱。

HttpException

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

備註

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

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

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

另請參閱

• ASP.NET 路由

RedirectToRoutePermanent(RouteValueDictionary)

使用指定的路由參數值，執行永遠從要求的 URL 重新導向至指定的 URL。

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

public override void RedirectToRoutePermanent (System.Web.Routing.RouteValueDictionary routeValues);

override this.RedirectToRoutePermanent : System.Web.Routing.RouteValueDictionary -> unit

Public Overrides Sub RedirectToRoutePermanent (routeValues As RouteValueDictionary)

參數

routeValues

RouteValueDictionary

路由參數值。

例外狀況

InvalidOperationException

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

HttpException

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

備註

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

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

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

另請參閱

• ASP.NET 路由

RedirectToRoutePermanent(String, RouteValueDictionary)

使用指定的路由名稱及路由參數值，執行永遠從要求的 URL 重新導向至指定的 URL。

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

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

override this.RedirectToRoutePermanent : string * System.Web.Routing.RouteValueDictionary -> unit

Public Overrides Sub RedirectToRoutePermanent (routeName As String, routeValues As RouteValueDictionary)

參數

routeName

String

路由的名稱。

routeValues

RouteValueDictionary

路由參數值。

例外狀況

InvalidOperationException

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

HttpException

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

備註

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

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

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

另請參閱

• ASP.NET 路由