HttpResponse.RedirectToRoute 方法

定义

命名空间:

System.Web

程序集:

System.Web.dll

使用路由参数值和/或路由名称将请求重定向到新 URL。

重载

RedirectToRoute(Object)	使用路由参数值将请求重定向到新 URL。
RedirectToRoute(String)	使用路由名称将请求重定向到新 URL。
RedirectToRoute(RouteValueDictionary)	使用路由参数值将请求重定向到新 URL。
RedirectToRoute(String, Object)	使用路由参数值和路由名称将请求重定向到新 URL。
RedirectToRoute(String, RouteValueDictionary)	使用路由参数值和路由名称将请求重定向到新 URL。

RedirectToRoute(Object)

使用路由参数值将请求重定向到新 URL。

public:
 void RedirectToRoute(System::Object ^ routeValues);

public void RedirectToRoute (object routeValues);

member this.RedirectToRoute : obj -> unit

Public Sub RedirectToRoute (routeValues As Object)

参数

routeValues

Object

路由参数值。

例外

InvalidOperationException

没有与指定路由参数对应的路由。

HttpException

在发送 HTTP 标头之后尝试进行重定向。

示例

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

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

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

注解

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

此方法使用 RouteValueDictionary.RouteValueDictionary(Object) 构造函数将传入routeValuesSystem.Web.Routing.RouteValueDictionary的对象转换为 对象。 RouteCollection.GetVirtualPath然后调用 方法来确定 URL。

ASP.NET 通过返回 302 HTTP 状态代码来执行重定向。

另请参阅

• ASP.NET 路由

RedirectToRoute(String)

使用路由名称将请求重定向到新 URL。

public:
 void RedirectToRoute(System::String ^ routeName);

public void RedirectToRoute (string routeName);

member this.RedirectToRoute : string -> unit

Public Sub RedirectToRoute (routeName As String)

参数

routeName

String

路由的名称。

例外

InvalidOperationException

没有与指定路由参数对应的路由。

HttpException

在发送 HTTP 标头之后尝试进行重定向。

示例

以下示例演示如何调用此方法以重定向到名为 的 Products路由。

Response.RedirectToRoute("Products")

Response.RedirectToRoute("Products");

注解

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

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

ASP.NET 通过返回 302 HTTP 状态代码来执行重定向。

另请参阅

• ASP.NET 路由

RedirectToRoute(RouteValueDictionary)

使用路由参数值将请求重定向到新 URL。

public:
 void RedirectToRoute(System::Web::Routing::RouteValueDictionary ^ routeValues);

public void RedirectToRoute (System.Web.Routing.RouteValueDictionary routeValues);

member this.RedirectToRoute : System.Web.Routing.RouteValueDictionary -> unit

Public Sub RedirectToRoute (routeValues As RouteValueDictionary)

参数

routeValues

RouteValueDictionary

路由参数值。

例外

InvalidOperationException

没有与指定路由参数对应的路由。

HttpException

在发送 HTTP 标头之后尝试进行重定向。

示例

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

Response.RedirectToRoute(
  new RouteValueDictionary {productId="1", category="widgets"})

Response.RedirectToRoute(
  (new RouteValueDictionary {productId="1", category="widgets"});

注解

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

此方法调用 RouteCollection.GetVirtualPath 方法以确定 URL。

ASP.NET 通过返回 302 HTTP 状态代码来执行重定向。

另请参阅

• ASP.NET 路由

RedirectToRoute(String, Object)

使用路由参数值和路由名称将请求重定向到新 URL。

public:
 void RedirectToRoute(System::String ^ routeName, System::Object ^ routeValues);

public void RedirectToRoute (string routeName, object routeValues);

member this.RedirectToRoute : string * obj -> unit

Public Sub RedirectToRoute (routeName As String, routeValues As Object)

参数

routeName

String

路由的名称。

routeValues

Object

路由参数值。

例外

InvalidOperationException

没有与指定路由参数对应的路由。

HttpException

在发送 HTTP 标头之后尝试进行重定向。

示例

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

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

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

注解

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

此方法使用 RouteValueDictionary.RouteValueDictionary(Object) 构造函数将传入routeValuesSystem.Web.Routing.RouteValueDictionary的对象转换为 对象。 RouteCollection.GetVirtualPath然后调用 方法来确定 URL。

ASP.NET 通过返回 302 HTTP 状态代码来执行重定向。

另请参阅

• ASP.NET 路由

RedirectToRoute(String, RouteValueDictionary)

使用路由参数值和路由名称将请求重定向到新 URL。

public:
 void RedirectToRoute(System::String ^ routeName, System::Web::Routing::RouteValueDictionary ^ routeValues);

public void RedirectToRoute (string routeName, System.Web.Routing.RouteValueDictionary routeValues);

member this.RedirectToRoute : string * System.Web.Routing.RouteValueDictionary -> unit

Public Sub RedirectToRoute (routeName As String, routeValues As RouteValueDictionary)

参数

routeName

String

路由的名称。

routeValues

RouteValueDictionary

路由参数值。

例外

InvalidOperationException

没有与指定路由参数对应的路由。

HttpException

在发送 HTTP 标头之后尝试进行重定向。

示例

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

Response.RedirectToRoute("Product",
  new RouteValueDictionary {productId="1", category="widgets"})

Response.RedirectToRoute("Product",
  (new RouteValueDictionary {productId="1", category="widgets"});

注解

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

RouteCollection.GetVirtualPath调用 方法以确定 URL。

ASP.NET 通过返回 302 HTTP 状态代码来执行重定向。

另请参阅

• ASP.NET 路由