Поделиться через


HttpResponse.RedirectToRoutePermanent Метод

Определение

Выполняет постоянное перенаправление запроса с запрошенного 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

Значения параметров маршрута.

Исключения

Ни один маршрут не соответствует указанным параметрам маршрута.

Была предпринята попытка перенаправления после отправки заголовков 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.

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

Применяется к

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

Значения параметров маршрута.

Исключения

Ни один маршрут не соответствует указанным параметрам маршрута.

Была предпринята попытка перенаправления после отправки заголовков 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.

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

Применяется к

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

Имя маршрута.

Исключения

Ни один маршрут не соответствует указанным параметрам маршрута.

Была предпринята попытка перенаправления после отправки заголовков HTTP.

Примеры

В следующем примере показано, как вызвать этот метод для перенаправления на маршрут с именем Products.

Response.RedirectToRoutePermanent("Products")
Response.RedirectToRoutePermanent("Products");

Комментарии

Этот метод предоставляется для удобства написания кода. Это эквивалентно вызову RedirectPermanent(String, Boolean) метода со вторым параметром, равным false.

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

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

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

Применяется к

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

Значения параметров маршрута.

Исключения

Ни один маршрут не соответствует указанным параметрам маршрута.

Была предпринята попытка перенаправления после отправки заголовков 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.

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

Применяется к

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

Значения параметров маршрута.

Исключения

Ни один маршрут не соответствует указанным параметрам маршрута.

Была предпринята попытка перенаправления после отправки заголовков 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.

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

Применяется к