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 並將 method 參數設定 null 為 false 、 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) 節。

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。

例外狀況

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