HttpClient.PostAsync(Uri, IHttpContent) Método

Definición

Envíe una solicitud POST al URI especificado como una operación asincrónica. Para obtener instrucciones de programación para la clase HttpClient y ejemplos de código, consulte el tema conceptual 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

URI al que se envía la solicitud.

content
IHttpContent

Contenido de la solicitud HTTP que se va a enviar al servidor.

Devoluciones

Objeto que representa la operación asincrónica.

Atributos

Ejemplos

Consulte HttpClient para obtener ejemplos de llamada a HttpClient.PostAsync.

Comentarios

Esta operación no se bloqueará. La IAsyncOperationWithProgress devuelta (deHttpResponseMessage y HttpProgress) se completa después de leer toda la respuesta (incluido el contenido).

Los métodos PostAsync y PutAsync solo permiten establecer un número limitado de encabezados de contenido HTTP. En cambio, el método SendRequestAsync permite establecer encabezados en el mensaje de solicitud, así como en el contenido HTTP que se va a enviar.

A continuación se muestran las excepciones que produce esta función.

E_INVALIDARG

El parámetro URI era una referencia nula (Nothing en Visual Basic).

Control de excepciones.

Debe escribir código para controlar las excepciones al llamar a este método. Las excepciones pueden deberse a errores de validación de parámetros, errores de resolución de nombres y errores de red. Las excepciones de los errores de red (pérdida de conectividad, errores de conexión y errores de servidor HTTP, por ejemplo) pueden producirse en cualquier momento. Estos errores hacen que se arrojen excepciones. Si la aplicación no la controla, una excepción puede hacer que el tiempo de ejecución finalice toda la aplicación. Para obtener más información sobre cómo controlar las excepciones, consulte Control de excepciones en aplicaciones de red.

Se aplica a

Consulte también