IHttpFilter.SendRequestAsync(HttpRequestMessage) 方法

定義

命名空間:

Windows.Web.Http.Filters

以非同步作業的方式，在 IHttpFilter 實例上傳送 HTTP 要求。

public:
 IAsyncOperationWithProgress<HttpResponseMessage ^, HttpProgress> ^ SendRequestAsync(HttpRequestMessage ^ request);

/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<HttpResponseMessage, HttpProgress> SendRequestAsync(HttpRequestMessage const& request);

[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperationWithProgress<HttpResponseMessage,HttpProgress> SendRequestAsync(HttpRequestMessage request);

function sendRequestAsync(request)

Public Function SendRequestAsync (request As HttpRequestMessage) As IAsyncOperationWithProgress(Of HttpResponseMessage, HttpProgress)

參數

request

HttpRequestMessage

要傳送的 HTTP 要求訊息。

傳回

IAsyncOperationWithProgress<HttpResponseMessage,HttpProgress>

物件，表示非同步作業。

屬性

RemoteAsyncAttribute

備註

自訂篩選是在 IHttpFilter 介面的 SendRequestAsync 方法中實作。

Windows.Web.Http命名空間中的類別支援根據Windows.Web.Http.Filters命名空間中的類別來使用篩選。 Windows.Web.Http命名空間中的HttpClient類別提供用來傳送 HTTP 要求和接收 HTTP 回應的基類。 篩選準則提供處理常式機制來協助解決常見的 HTTP 服務問題。 簡單的篩選可以依序鏈結在一起，以處理更複雜的 HTTP 服務問題。

HTTP 篩選器是一個黑色方塊，其會接受 HTTP 要求訊息並產生 HTTP 回應訊息。 篩選準則如何取得 HTTP 回應是由篩選開發人員決定。 應用程式可以立即建立回應，它可以透過 TCP 將要求傳送至伺服器，甚至可以將多個要求傳送至伺服器 (或多部伺服器) ，再產生回應訊息。 由於篩選準則如何取得回應訊息，因此篩選準則可以將要求訊息傳遞至另一個篩選 (稱為內部篩選) ，因此將回應訊息的建立委派給內部篩選準則。

篩選通常會新增或變更標頭、處理可能使用 WebAuthenticationBroker) 的授權 (，或根據網路條件允許或不允許要求。 篩選通常會進行變更，然後將要求傳遞至內部篩選，這通常會在建構篩選時設定。

此方法可讓篩選只負責 HTTP 要求執行的特定層面，並將其他層面委派給其他篩選。 篩選準則可以實作快取、驗證、重新導向、Cookie、與伺服器的實際通訊，或這些內容的組合。 最下層 (基底) 篩選器通常是實際與網路進行通訊的篩選。

以下是此函式擲回的一些例外狀況。

E_INVALIDARG

要求參數是 Visual Basic 中Nothing (Null參考) 。

E_ILLEGAL_METHOD_CALL

要求訊息已由 IHttpFilter 實例傳送。