HttpClient.PutAsync 方法

参考

定义

命名空间:: System.Net.Http

程序集:: System.Net.Http.dll

程序集:: netstandard.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

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

重载

PutAsync(String, HttpContent)	以异步操作将 PUT 请求发送给指定 URI。
PutAsync(Uri, HttpContent)	以异步操作将 PUT 请求发送给指定 URI。
PutAsync(String, HttpContent, CancellationToken)	用以异步操作的取消标记发送 PUT 请求。
PutAsync(Uri, HttpContent, CancellationToken)	用以异步操作的取消标记发送 PUT 请求。

注解

此操作不会阻止。

PutAsync(String, HttpContent)

Source:: HttpClient.cs

Source:: HttpClient.cs

Source:: HttpClient.cs

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

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ PutAsync(System::String ^ requestUri, System::Net::Http::HttpContent ^ content);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PutAsync (string requestUri, System.Net.Http.HttpContent content);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PutAsync (string? requestUri, System.Net.Http.HttpContent content);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PutAsync (string? requestUri, System.Net.Http.HttpContent? content);

member this.PutAsync : string * System.Net.Http.HttpContent -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>

Public Function PutAsync (requestUri As String, content As HttpContent) As Task(Of HttpResponseMessage)

参数

requestUri: String

请求发送到的 URI。

content: HttpContent

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

Task<HttpResponseMessage>

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

例外

InvalidOperationException

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

HttpRequestException

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

TaskCanceledException

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

UriFormatException

提供的请求 URI 是无效的相对 URI 或绝对 URI。

注解

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

注意

如果出现超时，则会在不同的 .NET 实现上引发不同的异常。

HttpRequestException在所有适用的 .NET Framework 版本上引发。
TaskCanceledException 不会在所有适用的 .NET Core 版本上引发任何内部异常。
TaskCanceledException 在 .NET 5 及更高版本上引发嵌套 TimeoutException 的。

适用于

PutAsync(Uri, HttpContent)

Source:: HttpClient.cs

Source:: HttpClient.cs

Source:: HttpClient.cs

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

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ PutAsync(Uri ^ requestUri, System::Net::Http::HttpContent ^ content);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PutAsync (Uri requestUri, System.Net.Http.HttpContent content);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PutAsync (Uri? requestUri, System.Net.Http.HttpContent content);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PutAsync (Uri? requestUri, System.Net.Http.HttpContent? content);

member this.PutAsync : Uri * System.Net.Http.HttpContent -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>

Public Function PutAsync (requestUri As Uri, content As HttpContent) As Task(Of HttpResponseMessage)

参数

requestUri: Uri

请求发送到的 URI。

content: HttpContent

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

Task<HttpResponseMessage>

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

例外

InvalidOperationException

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

HttpRequestException

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

TaskCanceledException

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

注解

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

注意

如果出现超时，则会在不同的 .NET 实现上引发不同的异常。

HttpRequestException在所有适用的 .NET Framework 版本上引发。
TaskCanceledException 不会在所有适用的 .NET Core 版本上引发任何内部异常。
TaskCanceledException 在 .NET 5 及更高版本上引发嵌套 TimeoutException 的。

适用于

PutAsync(String, HttpContent, CancellationToken)

Source:: HttpClient.cs

Source:: HttpClient.cs

Source:: HttpClient.cs

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

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ PutAsync(System::String ^ requestUri, System::Net::Http::HttpContent ^ content, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PutAsync (string requestUri, System.Net.Http.HttpContent content, System.Threading.CancellationToken cancellationToken);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PutAsync (string? requestUri, System.Net.Http.HttpContent content, System.Threading.CancellationToken cancellationToken);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PutAsync (string? requestUri, System.Net.Http.HttpContent? content, System.Threading.CancellationToken cancellationToken);

member this.PutAsync : string * System.Net.Http.HttpContent * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>

Public Function PutAsync (requestUri As String, content As HttpContent, cancellationToken As CancellationToken) As Task(Of HttpResponseMessage)

参数

requestUri: String

请求发送到的 URI。

content: HttpContent

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

cancellationToken: CancellationToken

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

Task<HttpResponseMessage>

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

例外

InvalidOperationException

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

HttpRequestException

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

TaskCanceledException

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

UriFormatException

提供的请求 URI 是无效的相对 URI 或绝对 URI。

OperationCanceledException

取消令牌已取消。此异常存储在返回的任务中。

注解

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

注意

如果出现超时，则会在不同的 .NET 实现上引发不同的异常。

HttpRequestException在所有适用的 .NET Framework 版本上引发。
TaskCanceledException 不会在所有适用的 .NET Core 版本上引发任何内部异常。
TaskCanceledException 在 .NET 5 及更高版本上引发嵌套 TimeoutException 的。

适用于

PutAsync(Uri, HttpContent, CancellationToken)

Source:: HttpClient.cs

Source:: HttpClient.cs

Source:: HttpClient.cs

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

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ PutAsync(Uri ^ requestUri, System::Net::Http::HttpContent ^ content, System::Threading::CancellationToken cancellationToken);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PutAsync (Uri requestUri, System.Net.Http.HttpContent content, System.Threading.CancellationToken cancellationToken);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PutAsync (Uri? requestUri, System.Net.Http.HttpContent content, System.Threading.CancellationToken cancellationToken);

public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PutAsync (Uri? requestUri, System.Net.Http.HttpContent? content, System.Threading.CancellationToken cancellationToken);

member this.PutAsync : Uri * System.Net.Http.HttpContent * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>

Public Function PutAsync (requestUri As Uri, content As HttpContent, cancellationToken As CancellationToken) As Task(Of HttpResponseMessage)

参数

requestUri: Uri

请求发送到的 URI。

content: HttpContent

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

cancellationToken: CancellationToken

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

Task<HttpResponseMessage>

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

例外

InvalidOperationException

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

HttpRequestException

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

TaskCanceledException

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

OperationCanceledException

取消令牌已取消。此异常存储在返回的任务中。

注解

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

注意

如果出现超时，则会在不同的 .NET 实现上引发不同的异常。

HttpRequestException在所有适用的 .NET Framework 版本上引发。
TaskCanceledException 不会在所有适用的 .NET Core 版本上引发任何内部异常。
TaskCanceledException 在 .NET 5 及更高版本上引发嵌套 TimeoutException 的。

适用于

反馈

此页面是否有帮助？

通过

HttpClient.PutAsync 方法

定义

重载

注解

PutAsync(String, HttpContent)

参数

返回

例外

注解

适用于

PutAsync(Uri, HttpContent)

参数

返回

例外

注解

适用于

PutAsync(String, HttpContent, CancellationToken)

参数

返回

例外

注解

适用于

PutAsync(Uri, HttpContent, CancellationToken)

参数

返回

例外

注解

适用于

反馈