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.

Этот метод преобразует переданный объект в routeValuesSystem.Web.Routing.RouteValueDictionary объект с помощью конструктора RouteValueDictionary.RouteValueDictionary(Object) . Затем RouteCollection.GetVirtualPath вызывается метод для определения URL-адреса.

ASP.NET выполняет перенаправление, возвращая код состояния HTTP 301.

См. также раздел

• Маршрутизация 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.

Этот метод преобразует переданный объект в routeValuesSystem.Web.Routing.RouteValueDictionary объект с помощью конструктора RouteValueDictionary.RouteValueDictionary(Object) . Затем RouteCollection.GetVirtualPath вызывается метод для определения URL-адреса.

ASP.NET выполняет перенаправление, возвращая код состояния HTTP 301.

См. также раздел

• Маршрутизация 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.

Этот метод преобразует передаваемое имя маршрута в routeName URL-адрес с помощью RouteCollection.GetVirtualPath метода .

ASP.NET выполняет перенаправление, возвращая код состояния HTTP 301.

См. также раздел

• Маршрутизация 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 выполняет перенаправление, возвращая код состояния HTTP 301.

См. также раздел

• Маршрутизация 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 выполняет перенаправление, возвращая код состояния HTTP 301.

См. также раздел

• Маршрутизация ASP.NET