HttpClient.PutAsync Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Envie uma solicitação PUT para o URI especificado como uma operação assíncrona.
Sobrecargas
| PutAsync(String, HttpContent) |
Envie uma solicitação PUT para o URI especificado como uma operação assíncrona. |
| PutAsync(Uri, HttpContent) |
Envie uma solicitação PUT para o URI especificado como uma operação assíncrona. |
| PutAsync(String, HttpContent, CancellationToken) |
Envie uma solicitação PUT com um token de cancelamento como uma operação assíncrona. |
| PutAsync(Uri, HttpContent, CancellationToken) |
Envie uma solicitação PUT com um token de cancelamento como uma operação assíncrona. |
Comentários
Esta operação não será bloqueada.
PutAsync(String, HttpContent)
- Origem:
- HttpClient.cs
- Origem:
- HttpClient.cs
- Origem:
- HttpClient.cs
Envie uma solicitação PUT para o URI especificado como uma operação assíncrona.
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)Parâmetros
- requestUri
- String
O URI ao qual a solicitação é enviada.
- content
- HttpContent
O conteúdo da solicitação HTTP enviada ao servidor.
Retornos
O objeto de tarefa que representa a operação assíncrona.
Exceções
O requestUri deve ser um URI absoluto ou BaseAddress deve ser definido.
A solicitação falhou devido a um problema subjacente, como conectividade de rede, falha de DNS, validação de certificado do servidor ou tempo limite.
Somente .NET Core e .NET 5 e posterior: a solicitação falhou devido ao tempo limite.
O URI de solicitação fornecido não é um URI relativo ou absoluto válido.
Comentários
Esta operação não será bloqueada. O objeto retornado Task<TResult> será concluído depois que toda a resposta (incluindo conteúdo) for lida.
Observação
No caso de tempo limite, exceções diferentes são geradas em diferentes implementações do .NET.
- HttpRequestExceptioné lançado em todas as versões de .NET Framework aplicáveis.
- TaskCanceledException sem nenhuma exceção interna é gerada em todas as versões aplicáveis do .NET Core.
- TaskCanceledException que aninha um TimeoutException é lançado no .NET 5 e em versões posteriores.
Aplica-se a
PutAsync(Uri, HttpContent)
- Origem:
- HttpClient.cs
- Origem:
- HttpClient.cs
- Origem:
- HttpClient.cs
Envie uma solicitação PUT para o URI especificado como uma operação assíncrona.
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)Parâmetros
- requestUri
- Uri
O URI ao qual a solicitação é enviada.
- content
- HttpContent
O conteúdo da solicitação HTTP enviada ao servidor.
Retornos
O objeto de tarefa que representa a operação assíncrona.
Exceções
O requestUri deve ser um URI absoluto ou BaseAddress deve ser definido.
A solicitação falhou devido a um problema subjacente, como conectividade de rede, falha de DNS, validação de certificado do servidor ou tempo limite.
Somente .NET Core e .NET 5 e posterior: a solicitação falhou devido ao tempo limite.
Comentários
Esta operação não será bloqueada. O objeto retornado Task<TResult> será concluído depois que toda a resposta (incluindo conteúdo) for lida.
Observação
No caso de tempo limite, exceções diferentes são geradas em diferentes implementações do .NET.
- HttpRequestExceptioné lançado em todas as versões de .NET Framework aplicáveis.
- TaskCanceledException sem nenhuma exceção interna é gerada em todas as versões aplicáveis do .NET Core.
- TaskCanceledException que aninha um TimeoutException é lançado no .NET 5 e em versões posteriores.
Aplica-se a
PutAsync(String, HttpContent, CancellationToken)
- Origem:
- HttpClient.cs
- Origem:
- HttpClient.cs
- Origem:
- HttpClient.cs
Envie uma solicitação PUT com um token de cancelamento como uma operação assíncrona.
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)Parâmetros
- requestUri
- String
O URI ao qual a solicitação é enviada.
- content
- HttpContent
O conteúdo da solicitação HTTP enviada ao servidor.
- cancellationToken
- CancellationToken
Um token de cancelamento que pode ser usado por outros objetos ou threads para receber um aviso de cancelamento.
Retornos
O objeto de tarefa que representa a operação assíncrona.
Exceções
O requestUri deve ser um URI absoluto ou BaseAddress deve ser definido.
A solicitação falhou devido a um problema subjacente, como conectividade de rede, falha de DNS, validação de certificado do servidor ou tempo limite.
Somente .NET Core e .NET 5 e posterior: a solicitação falhou devido ao tempo limite.
O URI de solicitação fornecido não é um URI relativo ou absoluto válido.
O token de cancelamento foi cancelado. Essa exceção é armazenada na tarefa retornada.
Comentários
Esta operação não será bloqueada. O objeto retornado Task<TResult> será concluído depois que toda a resposta (incluindo conteúdo) for lida.
Observação
No caso de tempo limite, exceções diferentes são geradas em diferentes implementações do .NET.
- HttpRequestExceptioné lançado em todas as versões de .NET Framework aplicáveis.
- TaskCanceledException sem nenhuma exceção interna é gerada em todas as versões aplicáveis do .NET Core.
- TaskCanceledException que aninha um TimeoutException é lançado no .NET 5 e em versões posteriores.
Aplica-se a
PutAsync(Uri, HttpContent, CancellationToken)
- Origem:
- HttpClient.cs
- Origem:
- HttpClient.cs
- Origem:
- HttpClient.cs
Envie uma solicitação PUT com um token de cancelamento como uma operação assíncrona.
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)Parâmetros
- requestUri
- Uri
O URI ao qual a solicitação é enviada.
- content
- HttpContent
O conteúdo da solicitação HTTP enviada ao servidor.
- cancellationToken
- CancellationToken
Um token de cancelamento que pode ser usado por outros objetos ou threads para receber um aviso de cancelamento.
Retornos
O objeto de tarefa que representa a operação assíncrona.
Exceções
O requestUri deve ser um URI absoluto ou BaseAddress deve ser definido.
A solicitação falhou devido a um problema subjacente, como conectividade de rede, falha de DNS, validação de certificado do servidor ou tempo limite.
Somente .NET Core e .NET 5 e posterior: a solicitação falhou devido ao tempo limite.
O token de cancelamento foi cancelado. Essa exceção é armazenada na tarefa retornada.
Comentários
Esta operação não será bloqueada. O objeto retornado Task<TResult> será concluído depois que toda a resposta (incluindo conteúdo) for lida.
Observação
No caso de tempo limite, exceções diferentes são geradas em diferentes implementações do .NET.
- HttpRequestExceptioné lançado em todas as versões de .NET Framework aplicáveis.
- TaskCanceledException sem nenhuma exceção interna é gerada em todas as versões aplicáveis do .NET Core.
- TaskCanceledException que aninha um TimeoutException é lançado no .NET 5 e em versões posteriores.
