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``productid和参数category的路由。

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``productid和参数category的路由。

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 路由