HttpServerUtilityWrapper.TransferRequest 方法

定義

命名空間:

System.Web

組件:

System.Web.Abstractions.dll

組件:

System.Web.dll

以非同步方式執行位於指定 URL 的結束點。

多載

TransferRequest(String)	以非同步方式執行位於指定 URL 的結束點。
TransferRequest(String, Boolean)	以非同步方式執行指定 URL 的端點，並指定是否要清除 QueryString 和 Form 集合。
TransferRequest(String, Boolean, String, NameValueCollection)	使用指定的 HTTP 方法和標頭，以非同步方式在指定的 URL 執行端點。
TransferRequest(String, Boolean, String, NameValueCollection, Boolean)	使用指定的 HTTP 方法、標頭、路徑，以及保留表單值和保留使用者識別的選項，執行所指定 URL 的非同步執行。

TransferRequest(String)

以非同步方式執行位於指定 URL 的結束點。

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

public override void TransferRequest (string path);

override this.TransferRequest : string -> unit

Public Overrides Sub TransferRequest (path As String)

參數

path

String

要執行的網頁 URL 或處理常式。

例外狀況

PlatformNotSupportedException

要求需要 IIS 7.0 的整合式管線模式。

HttpException

伺服器無法用來處理要求。

ArgumentNullException

path 參數為 null。

ArgumentException

path 參數無效。

TransferRequest(String, Boolean)

以非同步方式執行指定 URL 的端點，並指定是否要清除 QueryString 和 Form 集合。

public:
 override void TransferRequest(System::String ^ path, bool preserveForm);

public override void TransferRequest (string path, bool preserveForm);

override this.TransferRequest : string * bool -> unit

Public Overrides Sub TransferRequest (path As String, preserveForm As Boolean)

參數

path

String

要執行之頁面的 URL。

preserveForm

Boolean

true 表示保留 QueryString 和 Form 集合； false 表示清除 QueryString 和 Form 集合。

例外狀況

PlatformNotSupportedException

要求需要 IIS 7.0 的整合式管線模式。

HttpException

伺服器無法用來處理要求。

ArgumentNullException

path 參數為 null。

ArgumentException

path 參數無效。

TransferRequest(String, Boolean, String, NameValueCollection)

使用指定的 HTTP 方法和標頭，以非同步方式在指定的 URL 執行端點。

public:
 override void TransferRequest(System::String ^ path, bool preserveForm, System::String ^ method, System::Collections::Specialized::NameValueCollection ^ headers);

public override void TransferRequest (string path, bool preserveForm, string method, System.Collections.Specialized.NameValueCollection headers);

override this.TransferRequest : string * bool * string * System.Collections.Specialized.NameValueCollection -> unit

Public Overrides Sub TransferRequest (path As String, preserveForm As Boolean, method As String, headers As NameValueCollection)

參數

path

String

要執行的網頁 URL 或處理常式。

preserveForm

Boolean

true 表示保留 QueryString 和 Form 集合； false 表示清除 QueryString 和 Form 集合。

method

String

要用於新要求的 HTTP 方法 (GET、POST 等等)。 如果是 null，會使用原始要求的 HTTP 方法。

headers

NameValueCollection

新要求之要求標頭的集合。

例外狀況

PlatformNotSupportedException

要求需要以整合模式執行 IIS 7.0。

HttpException

伺服器無法用來處理要求。

ArgumentNullException

path 參數為 null。

ArgumentException

path 參數無效。

TransferRequest(String, Boolean, String, NameValueCollection, Boolean)

使用指定的 HTTP 方法、標頭、路徑，以及保留表單值和保留使用者識別的選項，執行所指定 URL 的非同步執行。

public:
 override void TransferRequest(System::String ^ path, bool preserveForm, System::String ^ method, System::Collections::Specialized::NameValueCollection ^ headers, bool preserveUser);

public override void TransferRequest (string path, bool preserveForm, string method, System.Collections.Specialized.NameValueCollection headers, bool preserveUser);

override this.TransferRequest : string * bool * string * System.Collections.Specialized.NameValueCollection * bool -> unit

Public Overrides Sub TransferRequest (path As String, preserveForm As Boolean, method As String, headers As NameValueCollection, preserveUser As Boolean)

參數

path

String

路徑。

preserveForm

Boolean

true 表示保留 QueryString 和 Form 集合； false 表示清除 QueryString 和 Form 集合。

method

String

用於新要求的 HTTP 方法。

headers

NameValueCollection

包含新要求之要求標頭的 NameValueCollection 物件。

preserveUser

Boolean

true 表示要保留使用者識別，否則為 false。 這個方法的其他多載會在 preserveUser 參數設定為 true 的情況下，呼叫這個方法多載。

例外狀況

PlatformNotSupportedException

要求需要 IIS 7.0 的整合式管線模式。

HttpException

伺服器無法用來處理要求。

ArgumentNullException

path 參數為 null。

ArgumentException

path 參數無效。