HttpServerUtility.TransferRequest 方法

定義

命名空間:

System.Web

組件:

System.Web.dll

執行指定網址的非同步執行。

多載

名稱	Description
TransferRequest(String)	執行指定網址的非同步執行。
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 框架的摘要資訊，請參見 Versions and Dependencies。

TransferRequest(String)

執行指定網址的非同步執行。

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。 欲了解更多資訊，請參閱 overload 中的 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設為傳入的值，methodnull參數設為 ，headers參數設為 ，參數設為 null，preserveUser參數設為 true。 欲了解更多資訊，請參閱 中的「備註」區塊 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

true保存Form收藏false;清理收藏。Form

method

String

執行新請求時使用的 HTTP 方法。

headers

NameValueCollection

NameValueCollection A 是新請求的請求標頭。

例外狀況

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