HttpServerUtility.TransferRequest 方法

定义

命名空间:

System.Web

程序集:

System.Web.dll

执行指定 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 的摘要信息，请参阅 版本和依赖项。

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 重载，preserveForm 参数设置为 false，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 参数设置为 null，headers 参数设置为 null，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)中的“备注”部分。