HttpClient.PostAsync(Uri, IHttpContent) Método

Definição

Namespace:

Windows.Web.Http

Envie uma solicitação POST para o URI especificado como uma operação assíncrona. Para obter diretrizes de programação para a classe HttpClient e exemplos de código, consulte o tópico conceitual HttpClient .

public:
 virtual IAsyncOperationWithProgress<HttpResponseMessage ^, HttpProgress> ^ PostAsync(Uri ^ uri, IHttpContent ^ content) = PostAsync;

/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<HttpResponseMessage, HttpProgress> PostAsync(Uri const& uri, IHttpContent const& content);

[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperationWithProgress<HttpResponseMessage,HttpProgress> PostAsync(System.Uri uri, IHttpContent content);

function postAsync(uri, content)

Public Function PostAsync (uri As Uri, content As IHttpContent) As IAsyncOperationWithProgress(Of HttpResponseMessage, HttpProgress)

Parâmetros

uri

Uri Uri

O URI para o qual a solicitação é enviada.

content

IHttpContent

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

Retornos

IAsyncOperationWithProgress<HttpResponseMessage,HttpProgress>

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

Atributos

RemoteAsyncAttribute

Exemplos

Consulte HttpClient para obter exemplos de como chamar HttpClient.PostAsync.

Comentários

Esta operação não será bloqueada. O IAsyncOperationWithProgress retornado (deHttpResponseMessage e HttpProgress) é concluído depois que toda a resposta (incluindo conteúdo) é lida.

Os métodos PostAsync e PutAsync permitem apenas definir um número limitado de cabeçalhos de conteúdo HTTP. Por outro lado, o método SendRequestAsync permite definir cabeçalhos na mensagem de solicitação, bem como no conteúdo HTTP a ser enviado.

Abaixo estão as exceções geradas por essa função.

E_INVALIDARG

O parâmetro uri era uma referência nula (Nothing no Visual Basic).

Tratamento de exceção

Você deve escrever código para lidar com exceções ao chamar esse método. As exceções podem resultar de erros de validação de parâmetro, falhas de resolução de nomes e erros de rede. Exceções de erros de rede (perda de conectividade, falhas de conexão e falhas de servidor HTTP, por exemplo) podem ocorrer a qualquer momento. Esses erros geram exceções. Se não for tratada pelo aplicativo, uma exceção poderá fazer com que todo o aplicativo seja encerrado pelo runtime. Para obter mais informações sobre como lidar com exceções, consulte Manipulando exceções em aplicativos de rede.

Confira também

• IHttpContent
• IAsyncOperationWithProgress<TResult,TProgress>
• PutAsync(Uri, IHttpContent)
• SendRequestAsync(HttpRequestMessage, HttpCompletionOption)
• Uri
• HttpResponseMessage
• HttpProgress
• HttpClient