HttpClient.PostAsync(Uri, IHttpContent) Método
Definição
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. 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
- content
- IHttpContent
O conteúdo da solicitação HTTP a ser enviado ao servidor.
Retornos
O objeto que representa a operação assíncrona.
- Atributos
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.