HttpClient.PostAsync Método

Definição

Envie uma solicitação POST para o URI especificado como uma operação assíncrona.

Sobrecargas

PostAsync(String, HttpContent, CancellationToken)

Envie uma solicitação POST com um token de cancelamento como uma operação assíncrona.

PostAsync(Uri, HttpContent, CancellationToken)

Envie uma solicitação POST com um token de cancelamento como uma operação assíncrona.

PostAsync(String, HttpContent)

Envie uma solicitação POST para o URI especificado como uma operação assíncrona.

PostAsync(Uri, HttpContent)

Envie uma solicitação POST para o URI especificado como uma operação assíncrona.

Comentários

Essa operação não será bloqueada.

PostAsync(String, HttpContent, CancellationToken)

Origem:
HttpClient.cs
Origem:
HttpClient.cs
Origem:
HttpClient.cs

Envie uma solicitação 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);
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)

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 posteriores: a solicitação falhou devido ao tempo limite.

O URI de solicitação fornecido não é URI relativo ou absoluto válido.

O token de cancelamento foi cancelado. Essa exceção é armazenada na tarefa retornada.

Comentários

Essa 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, diferentes exceções são geradas em diferentes implementações do .NET.

Aplica-se a

PostAsync(Uri, HttpContent, CancellationToken)

Origem:
HttpClient.cs
Origem:
HttpClient.cs
Origem:
HttpClient.cs

Envie uma solicitação 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);
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 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 posteriores: a solicitação falhou devido ao tempo limite.

O token de cancelamento foi cancelado. Essa exceção é armazenada na tarefa retornada.

Comentários

Essa 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, diferentes exceções são geradas em diferentes implementações do .NET.

Aplica-se a

PostAsync(String, HttpContent)

Origem:
HttpClient.cs
Origem:
HttpClient.cs
Origem:
HttpClient.cs

Envie uma solicitação POST para o 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);
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)

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 posteriores: a solicitação falhou devido ao tempo limite.

O URI de solicitação fornecido não é URI relativo ou absoluto válido.

Comentários

Essa 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, diferentes exceções são geradas em diferentes implementações do .NET.

Aplica-se a

PostAsync(Uri, HttpContent)

Origem:
HttpClient.cs
Origem:
HttpClient.cs
Origem:
HttpClient.cs

Envie uma solicitação POST para o 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);
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 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 posteriores: a solicitação falhou devido ao tempo limite.

Comentários

Essa 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, diferentes exceções são geradas em diferentes implementações do .NET.

Aplica-se a