HttpResponse.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:
 void RedirectToRoutePermanent(System::String ^ routeName, System::Object ^ routeValues);

public void RedirectToRoutePermanent (string routeName, object routeValues);

member this.RedirectToRoutePermanent : string * obj -> unit

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

參數

routeName

String

路由的名稱。

routeValues

Object

路由參數值。

例外狀況

InvalidOperationException

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

HttpException

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

範例

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

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

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

備註

這個方法可供撰寫程式代碼方便使用。 它相當於呼叫 方法， RedirectPermanent 並將第二個參數設定為 false。

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

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

另請參閱

• ASP.NET 路由

RedirectToRoutePermanent(Object)

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

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

public void RedirectToRoutePermanent (object routeValues);

member this.RedirectToRoutePermanent : obj -> unit

Public Sub RedirectToRoutePermanent (routeValues As Object)

參數

routeValues

Object

路由參數值。

例外狀況

InvalidOperationException

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

HttpException

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

範例

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

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

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

備註

這個方法可供撰寫程式代碼方便使用。 它相當於呼叫 方法， 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:
 void RedirectToRoutePermanent(System::String ^ routeName);

public void RedirectToRoutePermanent (string routeName);

member this.RedirectToRoutePermanent : string -> unit

Public Sub RedirectToRoutePermanent (routeName As String)

參數

routeName

String

路由的名稱。

例外狀況

InvalidOperationException

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

HttpException

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

範例

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

Response.RedirectToRoutePermanent("Products")

Response.RedirectToRoutePermanent("Products");

備註

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

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

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

另請參閱

• ASP.NET 路由

RedirectToRoutePermanent(RouteValueDictionary)

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

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

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

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

Public Sub RedirectToRoutePermanent (routeValues As RouteValueDictionary)

參數

routeValues

RouteValueDictionary

路由參數值。

例外狀況

InvalidOperationException

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

HttpException

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

範例

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

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

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

備註

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

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

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

另請參閱

• ASP.NET 路由

RedirectToRoutePermanent(String, RouteValueDictionary)

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

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

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

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

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

參數

routeName

String

路由的名稱。

routeValues

RouteValueDictionary

路由參數值。

例外狀況

InvalidOperationException

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

HttpException

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

範例

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

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

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

備註

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

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

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

另請參閱

• ASP.NET 路由