HttpClient.PostAsync(Uri, IHttpContent) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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
- 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.