共用方式為


HttpClient.PostAsync(Uri, IHttpContent) 方法

定義

將 POST 要求傳送至指定的 URI 做為非同步作業。 如需 HttpClient 類別的程式設計指引和程式碼範例,請參閱 HttpClient 概念性主題。

public:
 virtual IAsyncOperationWithProgress<HttpResponseMessage ^, HttpProgress> ^ PostAsync(Uri ^ uri, IHttpContent ^ content) = PostAsync;
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<HttpResponseMessage, HttpProgress> PostAsync(Uri const& uri, IHttpContent const& content);
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperationWithProgress<HttpResponseMessage,HttpProgress> PostAsync(System.Uri uri, IHttpContent content);
function postAsync(uri, content)
Public Function PostAsync (uri As Uri, content As IHttpContent) As IAsyncOperationWithProgress(Of HttpResponseMessage, HttpProgress)

參數

uri
Uri Uri

傳送要求的目的 URI。

content
IHttpContent

要傳送至伺服器的 HTTP 要求內容。

傳回

表示非同步作業的 物件。

屬性

範例

如需呼叫HttpClient.PostAsync的範例,請參閱HttpClient

備註

這項作業不會封鎖。 傳回的HttpResponseMessageHttpProgress (IAsyncOperationWithProgress) 會在讀取整個回應 (之後完成,包括內容) 。

PostAsync 和 PutAsync方法只允許設定有限的 HTTP 內容標頭數目。 相反地, SendRequestAsync 方法允許在要求訊息以及要傳送的 HTTP 內容上設定標頭。

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

E_INVALIDARG

uri參數是 Visual Basic) 中 NothingNull參考 (。

例外狀況處理

呼叫此方法時,您必須撰寫程式碼來處理例外狀況。 例外狀況可能是因為參數驗證錯誤、名稱解析失敗和網路錯誤所造成。 網路錯誤 (連線中斷、連線失敗和 HTTP 伺服器失敗的例外狀況,例如,隨時可能會發生) 。 這些錯誤會造成擲出例外狀況。 如果應用程式未處理,例外狀況可能會導致整個應用程式由執行時間終止。 如需如何處理例外狀況的詳細資訊,請參閱 處理網路應用程式中的例外狀況。

適用於

另請參閱