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のパラメーターを持つルートにリダイレクトするcategoryproductid方法を示します。

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

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

注釈

このメソッドは、コーディングの利便性を高める目的で提供されます。 これは、2 番目のパラメーターを にfalse設定して RedirectPermanent メソッドを呼び出すことと同じです。

このメソッドは、 コンストラクターを使用して オブジェクトにSystem.Web.Routing.RouteValueDictionary渡されるrouteValuesオブジェクトをRouteValueDictionary.RouteValueDictionary(Object)変換します。 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 ヘッダーが送信された後にリダイレクトしようとしました。

例

次の例では、このメソッドを呼び出して、 および categoryという名前productidのパラメーターを持つルートにリダイレクトする方法を示します。

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

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

注釈

このメソッドは、コーディングの利便性を高める目的で提供されます。 これは、2 番目のパラメーターを にfalse設定して RedirectPermanent(String, Boolean) メソッドを呼び出すことと同じです。

このメソッドは、 コンストラクターを使用して オブジェクトにSystem.Web.Routing.RouteValueDictionary渡されるrouteValuesオブジェクトをRouteValueDictionary.RouteValueDictionary(Object)変換します。 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");

注釈

このメソッドは、コーディングの利便性を高める目的で提供されます。 これは、2 番目のパラメーターを にfalse設定して RedirectPermanent(String, Boolean) メソッドを呼び出すことと同じです。

このメソッドは、 メソッドを使用して URL に渡される routeName ルート名を RouteCollection.GetVirtualPath 変換します。

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 ヘッダーが送信された後にリダイレクトしようとしました。

例

次の例では、このメソッドを呼び出して、 および categoryという名前productidのパラメーターを持つルートにリダイレクトする方法を示します。

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

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

注釈

このメソッドは、コーディングの利便性を高める目的で提供されます。 これは、2 番目のパラメーターを にfalse設定して Redirect(String, Boolean) メソッドを呼び出すことと同じです。

このメソッドは、 メソッドを 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のパラメーターを持つルートにリダイレクトするcategoryproductid方法を示します。

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

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

注釈

このメソッドは、コーディングの利便性を高める目的で提供されます。 これは、2 番目のパラメーターを にfalse設定して Redirect(String, Boolean) メソッドを呼び出すことと同じです。

このメソッドは、 メソッドを RouteCollection.GetVirtualPath 呼び出して URL を決定します。

ASP.NET は、301 HTTP 状態コードを返すことによってリダイレクトを実行します。

こちらもご覧ください

• ASP.NET ルーティング