HttpResponse.RedirectToRoutePermanent メソッド

リファレンス

定義

名前空間:: System.Web

アセンブリ:: System.Web.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 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:
 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) メソッドを呼び出すことと同じです。

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");

注釈

このメソッドは、メソッドを使用して 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"});

注釈

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

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

こちらもご覧ください

ASP.NET ルーティング

適用対象

次の方法で共有

HttpResponse.RedirectToRoutePermanent メソッド

定義

オーバーロード

RedirectToRoutePermanent(String, Object)

パラメーター

例外

例

注釈

こちらもご覧ください

適用対象

RedirectToRoutePermanent(Object)

パラメーター

例外

例

注釈

こちらもご覧ください

適用対象

RedirectToRoutePermanent(String)

パラメーター

例外

例

注釈

こちらもご覧ください

適用対象

RedirectToRoutePermanent(RouteValueDictionary)

パラメーター

例外

例

注釈

こちらもご覧ください

適用対象

RedirectToRoutePermanent(String, RouteValueDictionary)

パラメーター

例外

例

注釈

こちらもご覧ください

適用対象

その他のリソース