HttpClient.PostAsync(Uri, IHttpContent) 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
將 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)
參數
- content
- IHttpContent
要傳送至伺服器的 HTTP 要求內容。
傳回
表示非同步作業的 物件。
- 屬性
範例
如需呼叫HttpClient.PostAsync的範例,請參閱HttpClient。
備註
這項作業不會封鎖。 傳回的HttpResponseMessage和HttpProgress (IAsyncOperationWithProgress) 會在讀取整個回應 (之後完成,包括內容) 。
PostAsync 和 PutAsync方法只允許設定有限的 HTTP 內容標頭數目。 相反地, SendRequestAsync 方法允許在要求訊息以及要傳送的 HTTP 內容上設定標頭。
以下是此函式擲回的例外狀況。
E_INVALIDARG
uri參數是 Visual Basic) 中 Nothing的Null參考 (。
例外狀況處理
呼叫此方法時,您必須撰寫程式碼來處理例外狀況。 例外狀況可能是因為參數驗證錯誤、名稱解析失敗和網路錯誤所造成。 網路錯誤 (連線中斷、連線失敗和 HTTP 伺服器失敗的例外狀況,例如,隨時可能會發生) 。 這些錯誤會造成擲出例外狀況。 如果應用程式未處理,例外狀況可能會導致整個應用程式由執行時間終止。 如需如何處理例外狀況的詳細資訊,請參閱 處理網路應用程式中的例外狀況。