HttpResponseWrapper.RedirectToRoutePermanent 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
使用指定的路由參數值、路由名稱，或是兩者都使用，執行永遠從要求的 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 -> unitPublic Overrides Sub RedirectToRoutePermanent (routeName As String, routeValues As Object)參數
- routeName
- String
路由的名稱。
- routeValues
- Object
路由參數值。
例外狀況
沒有路由對應到指定的路由參數。
在 HTTP 標頭送出之後嘗試重新導向。
備註
提供這個方法以方便撰寫程序代碼。 這相當於呼叫 方法， RedirectPermanent 並將第二個參數設定為 false。
這個方法會使用 RouteValueDictionary.RouteValueDictionary(Object) 建構函式，將傳入routeValues物件的物件System.Web.Routing.RouteValueDictionary轉換成 物件。
RouteCollection.GetVirtualPath接著會呼叫 方法來判斷 URL。
ASP.NET 傳回 301 HTTP 狀態代碼來執行重新導向。
另請參閱
適用於
RedirectToRoutePermanent(Object)
使用指定的路由參數值，執行永遠從要求的 URL 重新導向至指定的 URL。
public:
override void RedirectToRoutePermanent(System::Object ^ routeValues);public override void RedirectToRoutePermanent (object routeValues);override this.RedirectToRoutePermanent : obj -> unitPublic Overrides Sub RedirectToRoutePermanent (routeValues As Object)參數
- routeValues
- Object
路由參數值。
例外狀況
沒有路由對應到指定的路由參數。
在 HTTP 標頭送出之後嘗試重新導向。
備註
提供這個方法以方便撰寫程序代碼。 這相當於呼叫 方法， RedirectPermanent(String, Boolean) 並將第二個參數設定為 false。
這個方法會使用 RouteValueDictionary.RouteValueDictionary(Object) 建構函式，將傳入routeValues物件的物件System.Web.Routing.RouteValueDictionary轉換成 物件。
RouteCollection.GetVirtualPath接著會呼叫 方法來判斷 URL。
ASP.NET 傳回 301 HTTP 狀態代碼來執行重新導向。
另請參閱
適用於
RedirectToRoutePermanent(String)
使用指定的路由名稱，執行永遠從要求的 URL 重新導向至指定的 URL。
public:
override void RedirectToRoutePermanent(System::String ^ routeName);public override void RedirectToRoutePermanent (string routeName);override this.RedirectToRoutePermanent : string -> unitPublic Overrides Sub RedirectToRoutePermanent (routeName As String)參數
- routeName
- String
路由的名稱。
例外狀況
沒有路由對應至指定的路由名稱。
在 HTTP 標頭送出之後嘗試重新導向。
備註
提供這個方法以方便撰寫程序代碼。 這相當於呼叫 方法， RedirectPermanent(String, Boolean) 並將第二個參數設定為 false。
這個方法會使用 RouteCollection.GetVirtualPath 方法，將傳入 routeName URL 的路由名稱轉換為 URL。
ASP.NET 傳回 301 HTTP 狀態代碼來執行重新導向。
另請參閱
適用於
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 -> unitPublic Overrides Sub RedirectToRoutePermanent (routeValues As RouteValueDictionary)參數
- routeValues
- RouteValueDictionary
路由參數值。
例外狀況
沒有路由對應到指定的路由參數。
在 HTTP 標頭送出之後嘗試重新導向。
備註
提供這個方法以方便撰寫程序代碼。 這相當於呼叫 方法， Redirect(String, Boolean) 並將第二個參數設定為 false。
這個方法會 RouteCollection.GetVirtualPath 呼叫 方法來判斷 URL。
ASP.NET 傳回 301 HTTP 狀態代碼來執行重新導向。
另請參閱
適用於
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 -> unitPublic Overrides Sub RedirectToRoutePermanent (routeName As String, routeValues As RouteValueDictionary)參數
- routeName
- String
路由的名稱。
- routeValues
- RouteValueDictionary
路由參數值。
例外狀況
沒有路由對應到指定的路由參數。
在 HTTP 標頭送出之後嘗試重新導向。
備註
提供這個方法以方便撰寫程序代碼。 這相當於呼叫 方法， Redirect(String, Boolean) 並將第二個參數設定為 false。
這個方法會 RouteCollection.GetVirtualPath 呼叫 方法來判斷 URL。
ASP.NET 傳回 301 HTTP 狀態代碼來執行重新導向。
