HttpServerUtility.TransferRequest 方法

定义

命名空间:: System.Web

程序集:: System.Web.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

执行指定 URL 的异步执行。

重载

名称	说明
TransferRequest(String)	执行指定 URL 的异步执行。
TransferRequest(String, Boolean)	执行指定 URL 的异步执行并保留查询字符串参数。
TransferRequest(String, Boolean, String, NameValueCollection)	使用指定的 HTTP 方法和标头执行指定的 URL 的异步执行。
TransferRequest(String, Boolean, String, NameValueCollection, Boolean)	使用指定的 HTTP 方法、标头和路径执行指定 URL 的异步执行，并选择性地保留表单值和用户标识。

注解

.NET Framework 版本 3.5 中引入了 TransferRequest。有关 .NET Framework 的摘要信息，请参阅 Versions 和 Dependencies。

TransferRequest(String)

执行指定 URL 的异步执行。

public:
 void TransferRequest(System::String ^ path);

public void TransferRequest(string path);

member this.TransferRequest : string -> unit

Public Sub TransferRequest (path As String)

参数

path: String

要执行的服务器上新页面的 URL 路径。

例外

PlatformNotSupportedException

请求需要 IIS 7.0 的集成管道模式。

HttpException

服务器无法处理请求。

ArgumentNullException

参数 path 为 null.

ArgumentException

参数 path 无效。

注解

此方法重载调用TransferRequest参数设置为false的重载preserveForm、method参数设置为null、headers参数设置为null和preserveUser参数设置为。true 有关详细信息，请参阅重载中的 TransferRequest(String, Boolean, String, NameValueCollection) “备注”部分。

适用于

TransferRequest(String, Boolean)

执行指定 URL 的异步执行并保留查询字符串参数。

public:
 void TransferRequest(System::String ^ path, bool preserveForm);

public void TransferRequest(string path, bool preserveForm);

member this.TransferRequest : string * bool -> unit

Public Sub TransferRequest (path As String, preserveForm As Boolean)

参数

path: String

要执行的服务器上新页面的 URL 路径。

preserveForm: Boolean

true 若要保留 Form 集合， false 则为清除 Form 集合。

例外

PlatformNotSupportedException

请求需要 IIS 7.0 的集成管道模式。

HttpException

服务器无法处理请求。

ArgumentNullException

参数 path 为 null.

ArgumentException

参数 path 无效。

注解

此重载调用TransferRequest参数集为传入的值的重载preserveForm、method参数集设置为nullnull、headers参数设置为和preserveUser参数设置为true的值。有关详细信息，请参阅中的 TransferRequest(String, Boolean, String, NameValueCollection)“备注”部分。

.NET Framework 版本 3.5 中引入了 TransferRequest。有关详细信息，请参阅版本和依赖项。

适用于

TransferRequest(String, Boolean, String, NameValueCollection)

使用指定的 HTTP 方法和标头执行指定的 URL 的异步执行。

public:
 void TransferRequest(System::String ^ path, bool preserveForm, System::String ^ method, System::Collections::Specialized::NameValueCollection ^ headers);

public void TransferRequest(string path, bool preserveForm, string method, System.Collections.Specialized.NameValueCollection headers);

member this.TransferRequest : string * bool * string * System.Collections.Specialized.NameValueCollection -> unit

Public Sub TransferRequest (path As String, preserveForm As Boolean, method As String, headers As NameValueCollection)

参数

path: String

要执行的服务器上新页面的 URL 路径。

preserveForm: Boolean

true 若要保留 Form 集合， false 则为清除 Form 集合。

method: String

用于执行新请求的 HTTP 方法。

headers: NameValueCollection

NameValueCollection新请求的请求标头。

例外

PlatformNotSupportedException

请求要求在集成模式下运行的 IIS 7.0。

HttpException

服务器无法处理请求。

ArgumentNullException

参数 path 为 null.

ArgumentException

参数 path 无效。

注解

在 IIS 7.0 中通过集成管道模式运行时，使用此方法允许使用正确的请求上下文执行目标请求时，将请求处理从一个资源类型传输到另一个资源类型。例如，可以使用该方法 TransferRequest 将 ASPX 页的请求传输到 XML 页的请求。

该方法 TransferRequest 使用以下条件执行指定 URL 的异步子执行：

path如果参数指定查询字符串，它将用作新的查询字符串。如果未包含查询字符串，将重新使用请求的查询字符串。
如果指定了参数 method ，将使用此参数。 null如果是，将使用原始请求的 HTTP 方法。
preserveForm如果参数为true，则请求的当前实体正文将可用于目标请求。这允许传输表单帖子和上传。
如果当前在原始请求上设置了用户标识，该标识将传输到新请求。这允许经过身份验证的请求重新使用新请求的身份验证结果。如果不希望转移用户，请在转移前将用户设置为 null 原始请求。
如果指定了参数 headers ，则新请求将使用指定的标头执行。这可用于修改新请求的请求标头和 Cookie，或添加一个特殊标头，指定原始请求的接收位置。

此方法调用 TransferRequest(String, Boolean, String, NameValueCollection, Boolean) 方法重载， preserveUser 并将参数设置为 true.

适用于

TransferRequest(String, Boolean, String, NameValueCollection, Boolean)

使用指定的 HTTP 方法、标头和路径执行指定 URL 的异步执行，并选择性地保留表单值和用户标识。

public:
 void TransferRequest(System::String ^ path, bool preserveForm, System::String ^ method, System::Collections::Specialized::NameValueCollection ^ headers, bool preserveUser);

public void TransferRequest(string path, bool preserveForm, string method, System.Collections.Specialized.NameValueCollection headers, bool preserveUser);

member this.TransferRequest : string * bool * string * System.Collections.Specialized.NameValueCollection * bool -> unit

Public Sub TransferRequest (path As String, preserveForm As Boolean, method As String, headers As NameValueCollection, preserveUser As Boolean)

参数

path: String

路径。

preserveForm: Boolean

true 若要保留 Form 集合， false 则为清除 Form 集合。

method: String

新请求中使用的 HTTP 方法。

headers: NameValueCollection

包含 NameValueCollection 新请求的请求标头的对象。

preserveUser: Boolean

true 保留用户标识;否则，为 false. 此方法的其他方法重载调用此重载，此参数设置为 true。

例外

PlatformNotSupportedException

请求需要 IIS 7.0 的集成管道模式。

HttpException

服务器无法处理请求。

ArgumentNullException

参数 path 为 null.

ArgumentException

参数 path 无效。

注解

有关详细信息，请参阅中的 TransferRequest(String, Boolean, String, NameValueCollection)“备注”部分。

适用于

反馈

此页面是否有帮助？