HttpClient.TryPostAsync(Uri, IHttpContent) Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Sends a POST request to the specified Uri as an asynchronous operation. For programming guidance for the HttpClient class, and code examples, see the HttpClient conceptual topic.
public:
virtual IAsyncOperationWithProgress<HttpRequestResult ^, HttpProgress> ^ TryPostAsync(Uri ^ uri, IHttpContent ^ content) = TryPostAsync;/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<HttpRequestResult, HttpProgress> TryPostAsync(Uri const& uri, IHttpContent const& content);[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperationWithProgress<HttpRequestResult,HttpProgress> TryPostAsync(System.Uri uri, IHttpContent content);function tryPostAsync(uri, content)Public Function TryPostAsync (uri As Uri, content As IHttpContent) As IAsyncOperationWithProgress(Of HttpRequestResult, HttpProgress)Parameters
- content
- IHttpContent
The HTTP request content to send to the server.
Returns
The object representing the asynchronous operation.
- Attributes
Windows requirements
| Device family |
Windows 10, version 1903 (introduced in 10.0.18362.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (introduced in v8.0)
|
Remarks
This operation will not throw an exception on network errors. Instead you should examine the HttpRequestResult to learn about the original HTTP request, the resulting HTTP response (if any) and error (if any). This operation will throw when the operation is canceled.
This operation will not block. The returned IAsyncOperationWithProgress (of HttpRequestResult and HttpProgress) completes after the whole response (including content) is read.
The TryPutAsync and TryPostAsync methods only allow setting a limited number of HTTP content headers. In contrast, the TrySendRequestAsync method allows setting headers on the request message as well as on the HTTP content to be sent.