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 且具有名为 和 category的参数的productid路由。

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

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

注解

提供此方法是为了方便编码。 它等效于调用 方法， RedirectPermanent 并将第二个参数设置为 false。

此方法使用 RouteValueDictionary.RouteValueDictionary(Object) 构造函数将传入routeValuesSystem.Web.Routing.RouteValueDictionary的对象转换为 对象。 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 标头之后尝试进行重定向。

示例

以下示例演示如何调用此方法以重定向到具有名为 productid 和 category的参数的路由。

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

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

注解

提供此方法是为了方便编码。 它等效于调用 方法， RedirectPermanent(String, Boolean) 并将第二个参数设置为 false。

此方法使用 RouteValueDictionary.RouteValueDictionary(Object) 构造函数将传入routeValuesSystem.Web.Routing.RouteValueDictionary的对象转换为 对象。 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");

注解

提供此方法是为了方便编码。 它等效于调用 方法， RedirectPermanent(String, Boolean) 并将第二个参数设置为 false。

此方法使用 RouteCollection.GetVirtualPath 方法将传入routeName的路由名称转换为 URL。

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 标头之后尝试进行重定向。

示例

以下示例演示如何调用此方法以重定向到具有名为 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 通过返回 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 且具有名为 和 category的参数的productid路由。

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 通过返回 301 HTTP 状态代码来执行重定向。

另请参阅

• ASP.NET 路由