HttpClient.PostAsync Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Enviar um pedido POST ao URI especificado como uma operação assíncrona.
Sobrecargas
| Name | Description |
|---|---|
| PostAsync(Uri, HttpContent, CancellationToken) |
Enviar um pedido POST com um token de cancelamento como uma operação assíncrona. |
| PostAsync(String, HttpContent, CancellationToken) |
Enviar um pedido POST com um token de cancelamento como uma operação assíncrona. |
| PostAsync(String, HttpContent) |
Enviar um pedido POST ao URI especificado como uma operação assíncrona. |
| PostAsync(Uri, HttpContent) |
Enviar um pedido POST ao URI especificado como uma operação assíncrona. |
Observações
Esta operação não bloqueia.
PostAsync(Uri, HttpContent, CancellationToken)
Enviar um pedido POST com um token de cancelamento como uma operação assíncrona.
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)Parâmetros
- requestUri
- Uri
O URI para onde o pedido é enviado.
- content
- HttpContent
O conteúdo do pedido HTTP enviado para o servidor.
- cancellationToken
- CancellationToken
Um token de cancelamento que pode ser usado por outros objetos ou threads para receber aviso de cancelamento.
Devoluções
O objeto tarefa que representa a operação assíncrona.
Exceções
Não requestUri é um URI absoluto e BaseAddress não está configurado.
O pedido falhou devido a um problema em obter uma resposta HTTP válida, como falha de conectividade de rede, falha DNS, erro de validação de certificado do servidor ou resposta inválida do servidor. Em versões .NET 8 e posteriores, a razão é indicada por HttpRequestError
-ou-
Framework .NET apenas: O pedido expirou.
O token de cancelamento foi cancelado. Esta exceção é armazenada na tarefa devolvida.
-ou-
.NET Core e .NET 5 e posteriores apenas: O pedido falhou devido ao timeout.
Observações
Esta operação não bloqueia. O objeto devolvido Task<TResult> será concluído depois de toda a resposta (incluindo o conteúdo) ser lida.
Note
Em caso de timeout, diferentes exceções são lançadas em diferentes implementações .NET.
- HttpRequestException está incluído em todas as versões aplicáveis do .NET Framework.
- OperationCanceledException sem exceção interna é aplicado em todas as versões .NET Core aplicáveis.
- OperationCanceledException que aninham um TimeoutException é lançado em .NET versões 5 e posteriores.
Aplica-se a
PostAsync(String, HttpContent, CancellationToken)
Enviar um pedido POST com um token de cancelamento como uma operação assíncrona.
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);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)Parâmetros
- requestUri
- String
O URI para onde o pedido é enviado.
- content
- HttpContent
O conteúdo do pedido HTTP enviado para o servidor.
- cancellationToken
- CancellationToken
Um token de cancelamento que pode ser usado por outros objetos ou threads para receber aviso de cancelamento.
Devoluções
O objeto tarefa que representa a operação assíncrona.
Exceções
Não requestUri é um URI absoluto e BaseAddress não está configurado.
O pedido falhou devido a um problema em obter uma resposta HTTP válida, como falha de conectividade de rede, falha DNS, erro de validação de certificado do servidor ou resposta inválida do servidor. Em versões .NET 8 e posteriores, a razão é indicada por HttpRequestError
-ou-
Framework .NET apenas: O pedido expirou.
O URI de pedido fornecido não é válido relativo nem absoluto.
O token de cancelamento foi cancelado. Esta exceção é armazenada na tarefa devolvida.
-ou-
.NET Core e .NET 5 e posteriores apenas: O pedido falhou devido ao timeout.
Observações
Esta operação não bloqueia. O objeto devolvido Task<TResult> será concluído depois de toda a resposta (incluindo o conteúdo) ser lida.
Note
Em caso de timeout, diferentes exceções são lançadas em diferentes implementações .NET.
- HttpRequestException está incluído em todas as versões aplicáveis do .NET Framework.
- OperationCanceledException sem exceção interna é aplicado em todas as versões .NET Core aplicáveis.
- OperationCanceledException que aninham um TimeoutException é lançado em .NET versões 5 e posteriores.
Aplica-se a
PostAsync(String, HttpContent)
Enviar um pedido POST ao URI especificado como uma operação assíncrona.
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);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)Parâmetros
- requestUri
- String
O URI para onde o pedido é enviado.
- content
- HttpContent
O conteúdo do pedido HTTP enviado para o servidor.
Devoluções
O objeto tarefa que representa a operação assíncrona.
Exceções
Não requestUri é um URI absoluto e BaseAddress não está configurado.
O pedido falhou devido a um problema em obter uma resposta HTTP válida, como falha de conectividade de rede, falha DNS, erro de validação de certificado do servidor ou resposta inválida do servidor. Em versões .NET 8 e posteriores, a razão é indicada por HttpRequestError
-ou-
Framework .NET apenas: O pedido expirou.
.NET Core e .NET 5 e posteriores apenas: O pedido falhou devido ao timeout.
O URI de pedido fornecido não é válido relativo nem absoluto.
Observações
Esta operação não bloqueia. O objeto devolvido Task<TResult> será concluído depois de toda a resposta (incluindo o conteúdo) ser lida.
Note
Em caso de timeout, diferentes exceções são lançadas em diferentes implementações .NET.
- HttpRequestException está incluído em todas as versões aplicáveis do .NET Framework.
- OperationCanceledException sem exceção interna é aplicado em todas as versões .NET Core aplicáveis.
- OperationCanceledException que aninham um TimeoutException é lançado em .NET versões 5 e posteriores.
Aplica-se a
PostAsync(Uri, HttpContent)
Enviar um pedido POST ao URI especificado como uma operação assíncrona.
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)Parâmetros
- requestUri
- Uri
O URI para onde o pedido é enviado.
- content
- HttpContent
O conteúdo do pedido HTTP enviado para o servidor.
Devoluções
O objeto tarefa que representa a operação assíncrona.
Exceções
Não requestUri é um URI absoluto e BaseAddress não está configurado.
O pedido falhou devido a um problema em obter uma resposta HTTP válida, como falha de conectividade de rede, falha DNS, erro de validação de certificado do servidor ou resposta inválida do servidor. Em versões .NET 8 e posteriores, a razão é indicada por HttpRequestError
-ou-
Framework .NET apenas: O pedido expirou.
.NET Core e .NET 5 e posteriores apenas: O pedido falhou devido ao timeout.
Observações
Esta operação não bloqueia. O objeto devolvido Task<TResult> será concluído depois de toda a resposta (incluindo o conteúdo) ser lida.
Note
Em caso de timeout, diferentes exceções são lançadas em diferentes implementações .NET.
- HttpRequestException está incluído em todas as versões aplicáveis do .NET Framework.
- OperationCanceledException sem exceção interna é aplicado em todas as versões .NET Core aplicáveis.
- OperationCanceledException que aninham um TimeoutException é lançado em .NET versões 5 e posteriores.