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 上的异步执行和选择保留格式值和用户标识。

注解

TransferRequest已在 .NET Framework 版本 3.5 中引入。 有关.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，参数集设置为null``false、method``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

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

例外

PlatformNotSupportedException

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

HttpException

服务器不可用于处理该请求。

ArgumentNullException

path 参数为 null。

ArgumentException

path 参数无效。

注解

此重载调用 TransferRequest 重载， preserveForm 并将参数集设置为传入的值、 method 参数设置为 null的参数 headers 集 null和 preserveUser 参数设置为的值 true。 For more information, see the "Remarks" section in TransferRequest(String, Boolean, String, NameValueCollection).

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

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

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

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

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

method

String

要在新请求中使用的 HTTP 方法。

headers

NameValueCollection

一个包含用于新请求的请求标头的 NameValueCollection 对象。

preserveUser

Boolean

若要保存用户标识，则为 true；否则为 false。 此方法的另一个方法重载调用此重载且将此参数设置为 true。

例外

PlatformNotSupportedException

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

HttpException

服务器不可用于处理该请求。

ArgumentNullException

path 参数为 null。

ArgumentException

path 参数无效。

注解

For more information, see the "Remarks" section in TransferRequest(String, Boolean, String, NameValueCollection).