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 -> unit
Public 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 -> unit
Public 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 -> unit
Public 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 -> unit
Public 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 -> unit
Public 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 狀態代碼來執行重新導向。
另請參閱
適用於
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應