HttpClient.PostAsync Método

Definição

Namespace:: System.Net.Http

Assembly:: System.Net.Http.dll

Assembly:: netstandard.dll

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 POST para o URI especificado como uma operação assíncrona.

Sobrecargas

Nome	Description
PostAsync(Uri, HttpContent, CancellationToken)	Enviar uma solicitação POST com um token de cancelamento como uma operação assíncrona.
PostAsync(String, HttpContent, CancellationToken)	Enviar 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 é bloqueada.

PostAsync(Uri, HttpContent, CancellationToken)

Enviar 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);

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 o qual a solicitação é enviada.

content: HttpContent

O conteúdo da solicitação HTTP enviado ao servidor.

cancellationToken: CancellationToken

Um token de cancelamento que pode ser usado por outros objetos ou threads para receber aviso de cancelamento.

Retornos

Task<HttpResponseMessage>

O objeto de tarefa que representa a operação assíncrona.

Exceções

InvalidOperationException

O requestUri URI não é absoluto e BaseAddress não está definido.

HttpRequestException

A solicitação falhou devido a um problema ao obter uma resposta HTTP válida, como falha de conectividade de rede, falha de DNS, erro de validação de certificado do servidor ou resposta inválida do servidor. Em versões .NET 8 e posteriores, o motivo é indicado por HttpRequestError

-ou-

somente .NET Framework: a solicitação atingiu o tempo limite.

OperationCanceledException

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

-ou-

.NET Core e .NET 5 e posterior somente: a solicitação falhou devido ao tempo limite.

Comentários

Essa operação não é bloqueada. O objeto retornado Task<TResult> será concluído depois que toda a resposta (incluindo conteúdo) for lida.

Note

Em caso de tempo limite, exceções diferentes são geradas em diferentes implementações de .NET.

HttpRequestException é lançada em todas as versões do .NET Framework aplicáveis.
OperationCanceledException sem nenhuma exceção interna é lançada em todas as versões do .NET Core aplicáveis.
OperationCanceledException que aninha um TimeoutException é lançado em versões .NET 5 e posteriores.

Aplica-se a

PostAsync(String, HttpContent, CancellationToken)

Enviar 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);

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 o qual a solicitação é enviada.

content: HttpContent

O conteúdo da solicitação HTTP enviado ao servidor.

cancellationToken: CancellationToken

Um token de cancelamento que pode ser usado por outros objetos ou threads para receber aviso de cancelamento.

Retornos

Task<HttpResponseMessage>

O objeto de tarefa que representa a operação assíncrona.

Exceções

InvalidOperationException

O requestUri URI não é absoluto e BaseAddress não está definido.

HttpRequestException

-ou-

somente .NET Framework: a solicitação atingiu o tempo limite.

UriFormatException

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

OperationCanceledException

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

-ou-

.NET Core e .NET 5 e posterior somente: a solicitação falhou devido ao tempo limite.

Comentários

Essa operação não é bloqueada. O objeto retornado Task<TResult> será concluído depois que toda a resposta (incluindo conteúdo) for lida.

Note

Em caso de tempo limite, exceções diferentes são geradas em diferentes implementações de .NET.

HttpRequestException é lançada em todas as versões do .NET Framework aplicáveis.
OperationCanceledException sem nenhuma exceção interna é lançada em todas as versões do .NET Core aplicáveis.
OperationCanceledException que aninha um TimeoutException é lançado em versões .NET 5 e posteriores.

Aplica-se a

PostAsync(String, HttpContent)

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);

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 o qual a solicitação é enviada.

content: HttpContent

O conteúdo da solicitação HTTP enviado ao servidor.

Retornos

Task<HttpResponseMessage>

O objeto de tarefa que representa a operação assíncrona.

Exceções

InvalidOperationException

O requestUri URI não é absoluto e BaseAddress não está definido.

HttpRequestException

-ou-

somente .NET Framework: a solicitação atingiu o tempo limite.

OperationCanceledException

.NET Core e .NET 5 e posterior somente: a solicitação falhou devido ao tempo limite.

UriFormatException

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

Comentários

Essa operação não é bloqueada. O objeto retornado Task<TResult> será concluído depois que toda a resposta (incluindo conteúdo) for lida.

Note

Em caso de tempo limite, exceções diferentes são geradas em diferentes implementações de .NET.

HttpRequestException é lançada em todas as versões do .NET Framework aplicáveis.
OperationCanceledException sem nenhuma exceção interna é lançada em todas as versões do .NET Core aplicáveis.
OperationCanceledException que aninha um TimeoutException é lançado em versões .NET 5 e posteriores.

Aplica-se a

PostAsync(Uri, HttpContent)

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);

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 o qual a solicitação é enviada.

content: HttpContent

O conteúdo da solicitação HTTP enviado ao servidor.

Retornos

Task<HttpResponseMessage>

O objeto de tarefa que representa a operação assíncrona.

Exceções

InvalidOperationException

O requestUri URI não é absoluto e BaseAddress não está definido.

HttpRequestException

-ou-

somente .NET Framework: a solicitação atingiu o tempo limite.

OperationCanceledException

.NET Core e .NET 5 e posterior somente: a solicitação falhou devido ao tempo limite.

Comentários

Essa operação não é bloqueada. O objeto retornado Task<TResult> será concluído depois que toda a resposta (incluindo conteúdo) for lida.

Note

Em caso de tempo limite, exceções diferentes são geradas em diferentes implementações de .NET.

HttpRequestException é lançada em todas as versões do .NET Framework aplicáveis.
OperationCanceledException sem nenhuma exceção interna é lançada em todas as versões do .NET Core aplicáveis.
OperationCanceledException que aninha um TimeoutException é lançado em versões .NET 5 e posteriores.

Aplica-se a

Comentários

Esta página foi útil?