HttpClient.PostAsync(Uri, IHttpContent) 方法

  • 参考

定义

命名空间:
Windows.Web.Http
编辑

将 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 请求内容。

返回

IAsyncOperationWithProgress<HttpResponseMessage,HttpProgress>

表示异步操作的 对象。

属性
RemoteAsyncAttribute

示例

有关调用 HttpClient.PostAsync 的示例，请参阅 HttpClient。

注解

此操作不会阻止。 HttpResponseMessage 和 HttpProgress) 返回的 IAsyncOperationWithProgress (在读取包括内容) 在内的整个响应 (完成。

PostAsync 和 PutAsync 方法仅允许设置有限数量的 HTTP 内容标头。 相比之下， SendRequestAsync 方法允许在请求消息和要发送的 HTTP 内容上设置标头。

下面是此函数引发的异常。

E_INVALIDARG

uri 参数是一个 null 引用， (Visual Basic) 中无任何内容。

异常处理

调用此方法时，必须编写代码来处理异常。 异常可能是参数验证错误、名称解析失败和网络错误导致的。 网络错误 (连接丢失、连接故障和 HTTP 服务器故障（例如，随时可能发生) ）的异常。 这些错误将引发异常。 如果应用未处理，则异常可能会导致整个应用被运行时终止。 有关如何处理异常的详细信息，请参阅 处理网络应用中的异常。

适用于

另请参阅