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 -> unitPublic 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 -> unitPublic 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 -> unitPublic 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 -> unitPublic 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 -> unitPublic 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.
