HttpClient.PostAsync Método

Referência

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

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

Task<HttpResponseMessage>

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

Exceções

InvalidOperationException

O requestUri deve ser um URI absoluto ou BaseAddress deve ser definido.

HttpRequestException

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.

TaskCanceledException

Somente .NET Core e .NET 5 e posteriores: a solicitação falhou devido ao 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.

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.

HttpRequestExceptioné gerado em todas as versões .NET Framework aplicáveis.
TaskCanceledException sem qualquer 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 versões posteriores.

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

Task<HttpResponseMessage>

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

Exceções

InvalidOperationException

O requestUri deve ser um URI absoluto ou BaseAddress deve ser definido.

HttpRequestException

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.

TaskCanceledException

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

OperationCanceledException

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.

HttpRequestExceptioné gerado em todas as versões .NET Framework aplicáveis.
TaskCanceledException sem qualquer 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 versões posteriores.

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

Task<HttpResponseMessage>

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

Exceções

InvalidOperationException

O requestUri deve ser um URI absoluto ou BaseAddress deve ser definido.

HttpRequestException

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.

TaskCanceledException

Somente .NET Core e .NET 5 e posteriores: 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 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.

HttpRequestExceptioné gerado em todas as versões .NET Framework aplicáveis.
TaskCanceledException sem qualquer 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 versões posteriores.

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

Task<HttpResponseMessage>

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

Exceções

InvalidOperationException

O requestUri deve ser um URI absoluto ou BaseAddress deve ser definido.

HttpRequestException

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.

TaskCanceledException

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.

HttpRequestExceptioné gerado em todas as versões .NET Framework aplicáveis.
TaskCanceledException sem qualquer 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 versões posteriores.

Aplica-se a

Compartilhar via

HttpClient.PostAsync Método

Definição

Sobrecargas

Comentários

PostAsync(String, HttpContent, CancellationToken)

Parâmetros

Retornos

Exceções

Comentários

Aplica-se a

PostAsync(Uri, HttpContent, CancellationToken)

Parâmetros

Retornos

Exceções

Comentários

Aplica-se a

PostAsync(String, HttpContent)

Parâmetros

Retornos

Exceções

Comentários

Aplica-se a

PostAsync(Uri, HttpContent)

Parâmetros

Retornos

Exceções

Comentários

Aplica-se a

Recursos adicionais