HttpClient.PostAsync 方法

定义

以异步操作将 POST 请求发送给指定 URI。

重载

PostAsync(String, HttpContent, CancellationToken)

用以异步操作的取消标记发送 POST 请求。

PostAsync(Uri, HttpContent, CancellationToken)

用以异步操作的取消标记发送 POST 请求。

PostAsync(String, HttpContent)

以异步操作将 POST 请求发送给指定 URI。

PostAsync(Uri, HttpContent)

以异步操作将 POST 请求发送给指定 URI。

注解

此操作不会阻止。

PostAsync(String, HttpContent, CancellationToken)

用以异步操作的取消标记发送 POST 请求。

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ PostAsync(System::String ^ requestUri, System::Net::Http::HttpContent ^ content, System::Threading::CancellationToken cancellationToken);
public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PostAsync (string requestUri, System.Net.Http.HttpContent content, System.Threading.CancellationToken cancellationToken);
public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PostAsync (string? requestUri, System.Net.Http.HttpContent content, System.Threading.CancellationToken cancellationToken);
public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PostAsync (string? requestUri, System.Net.Http.HttpContent? content, System.Threading.CancellationToken cancellationToken);
member this.PostAsync : string * System.Net.Http.HttpContent * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>
Public Function PostAsync (requestUri As String, content As HttpContent, cancellationToken As CancellationToken) As Task(Of HttpResponseMessage)

参数

requestUri
String

请求发送到的 URI。

content
HttpContent

发送到服务器的 HTTP 请求内容。

cancellationToken
CancellationToken

可由其他对象或线程用以接收取消通知的取消标记。

返回

Task<HttpResponseMessage>

表示异步操作的任务对象。

例外

requestUri 必须为绝对 URI 或必须设置 BaseAddress

由于基础问题(如网络连接性、DNS 失败、服务器证书验证或超时),请求失败。

仅 .NET Core 和 .NET 5 及更高版本:请求由于超时而失败。

注解

此操作不会阻止。 返回 Task<TResult> 的对象将在读取整个响应 ((包括内容) )后完成。

备注

如果超时,不同的 .NET 实现将引发不同的异常。

适用于

PostAsync(Uri, HttpContent, CancellationToken)

用以异步操作的取消标记发送 POST 请求。

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ PostAsync(Uri ^ requestUri, System::Net::Http::HttpContent ^ content, System::Threading::CancellationToken cancellationToken);
public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PostAsync (Uri requestUri, System.Net.Http.HttpContent content, System.Threading.CancellationToken cancellationToken);
public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PostAsync (Uri? requestUri, System.Net.Http.HttpContent content, System.Threading.CancellationToken cancellationToken);
public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PostAsync (Uri? requestUri, System.Net.Http.HttpContent? content, System.Threading.CancellationToken cancellationToken);
member this.PostAsync : Uri * System.Net.Http.HttpContent * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>
Public Function PostAsync (requestUri As Uri, content As HttpContent, cancellationToken As CancellationToken) As Task(Of HttpResponseMessage)

参数

requestUri
Uri

请求发送到的 URI。

content
HttpContent

发送到服务器的 HTTP 请求内容。

cancellationToken
CancellationToken

可由其他对象或线程用以接收取消通知的取消标记。

返回

Task<HttpResponseMessage>

表示异步操作的任务对象。

例外

requestUri 必须为绝对 URI 或必须设置 BaseAddress

由于基础问题(如网络连接性、DNS 失败、服务器证书验证或超时),请求失败。

仅 .NET Core 和 .NET 5 及更高版本:请求因超时而失败。

注解

此操作不会阻止。 返回 Task<TResult> 的对象将在读取整个响应 ((包括内容) )后完成。

备注

如果超时,不同的 .NET 实现将引发不同的异常。

适用于

PostAsync(String, HttpContent)

以异步操作将 POST 请求发送给指定 URI。

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ PostAsync(System::String ^ requestUri, System::Net::Http::HttpContent ^ content);
public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PostAsync (string requestUri, System.Net.Http.HttpContent content);
public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PostAsync (string? requestUri, System.Net.Http.HttpContent content);
public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PostAsync (string? requestUri, System.Net.Http.HttpContent? content);
member this.PostAsync : string * System.Net.Http.HttpContent -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>
Public Function PostAsync (requestUri As String, content As HttpContent) As Task(Of HttpResponseMessage)

参数

requestUri
String

请求发送到的 URI。

content
HttpContent

发送到服务器的 HTTP 请求内容。

返回

Task<HttpResponseMessage>

表示异步操作的任务对象。

例外

requestUri 必须为绝对 URI 或必须设置 BaseAddress

由于基础问题(如网络连接性、DNS 失败、服务器证书验证或超时),请求失败。

仅 .NET Core 和 .NET 5 及更高版本:请求由于超时而失败。

注解

此操作不会阻止。 返回 Task<TResult> 的对象将在读取整个响应 ((包括内容) )后完成。

备注

如果超时,不同的 .NET 实现将引发不同的异常。

适用于

PostAsync(Uri, HttpContent)

以异步操作将 POST 请求发送给指定 URI。

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ PostAsync(Uri ^ requestUri, System::Net::Http::HttpContent ^ content);
public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PostAsync (Uri requestUri, System.Net.Http.HttpContent content);
public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PostAsync (Uri? requestUri, System.Net.Http.HttpContent content);
public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PostAsync (Uri? requestUri, System.Net.Http.HttpContent? content);
member this.PostAsync : Uri * System.Net.Http.HttpContent -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>
Public Function PostAsync (requestUri As Uri, content As HttpContent) As Task(Of HttpResponseMessage)

参数

requestUri
Uri

请求发送到的 URI。

content
HttpContent

发送到服务器的 HTTP 请求内容。

返回

Task<HttpResponseMessage>

表示异步操作的任务对象。

例外

requestUri 必须为绝对 URI 或必须设置 BaseAddress

由于基础问题(如网络连接性、DNS 失败、服务器证书验证或超时),请求失败。

仅 .NET Core 和 .NET 5 及更高版本:请求由于超时而失败。

注解

此操作不会阻止。 返回 Task<TResult> 的对象将在读取整个响应 ((包括内容) )后完成。

备注

如果超时,不同的 .NET 实现将引发不同的异常。

适用于