HttpServerUtility.TransferRequest 方法

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

public void TransferRequest (string path);

member this.TransferRequest : string -> unit

Public Sub TransferRequest (path As String)

参数

例外

注解

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

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)

参数

例外

注解

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

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

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)

参数

例外

注解

在 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。

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)

参数

例外

注解

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