HttpClient.PostAsync 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.
Sobrecargas
| Nombre | Description |
|---|---|
| PostAsync(Uri, HttpContent, CancellationToken) |
Envíe una solicitud POST con un token de cancelación como una operación asincrónica. |
| PostAsync(String, HttpContent, CancellationToken) |
Envíe una solicitud POST con un token de cancelación como una operación asincrónica. |
| PostAsync(String, HttpContent) |
Envíe una solicitud POST al URI especificado como una operación asincrónica. |
| PostAsync(Uri, HttpContent) |
Envíe una solicitud POST al URI especificado como una operación asincrónica. |
Comentarios
Esta operación no se bloquea.
PostAsync(Uri, HttpContent, CancellationToken)
Envíe una solicitud POST con un token de cancelación como una operación asincrónica.
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
Identificador URI al que se envía la solicitud.
- content
- HttpContent
El contenido de la solicitud HTTP enviado al servidor.
- cancellationToken
- CancellationToken
Token de cancelación que otros objetos o subprocesos pueden usar para recibir un aviso de cancelación.
Devoluciones
Objeto de tarea que representa la operación asincrónica.
Excepciones
no requestUri es un URI absoluto y BaseAddress no se establece.
Error en la solicitud debido a un problema al obtener una respuesta HTTP válida, como un error de conectividad de red, un error dns, un error de validación del certificado de servidor o una respuesta de servidor no válida. En .NET 8 y versiones posteriores, el motivo se indica mediante HttpRequestError
O bien
solo .NET Framework: se agota el tiempo de espera de la solicitud.
Se canceló el token de cancelación. Esta excepción se almacena en la tarea devuelta.
O bien
.NET Core y .NET 5 y versiones posteriores solo: error en la solicitud debido al tiempo de espera.
Comentarios
Esta operación no se bloquea. El objeto devuelto Task<TResult> se completará después de leer toda la respuesta (incluido el contenido).
Note
En caso de tiempo de espera, se inician excepciones diferentes en implementaciones de .NET diferentes.
- HttpRequestException se inicia en todas las versiones de .NET Framework aplicables.
- OperationCanceledException sin ninguna excepción interna se inicia en todas las versiones de .NET Core aplicables.
- OperationCanceledException que anida una TimeoutException se inicia en .NET 5 y versiones posteriores.
Se aplica a
PostAsync(String, HttpContent, CancellationToken)
Envíe una solicitud POST con un token de cancelación como una operación asincrónica.
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);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
Identificador URI al que se envía la solicitud.
- content
- HttpContent
El contenido de la solicitud HTTP enviado al servidor.
- cancellationToken
- CancellationToken
Token de cancelación que otros objetos o subprocesos pueden usar para recibir un aviso de cancelación.
Devoluciones
Objeto de tarea que representa la operación asincrónica.
Excepciones
no requestUri es un URI absoluto y BaseAddress no se establece.
Error en la solicitud debido a un problema al obtener una respuesta HTTP válida, como un error de conectividad de red, un error dns, un error de validación del certificado de servidor o una respuesta de servidor no válida. En .NET 8 y versiones posteriores, el motivo se indica mediante HttpRequestError
O bien
solo .NET Framework: se agota el tiempo de espera de la solicitud.
El URI de solicitud proporcionado no es un URI relativo o absoluto válido.
Se canceló el token de cancelación. Esta excepción se almacena en la tarea devuelta.
O bien
.NET Core y .NET 5 y versiones posteriores solo: error en la solicitud debido al tiempo de espera.
Comentarios
Esta operación no se bloquea. El objeto devuelto Task<TResult> se completará después de leer toda la respuesta (incluido el contenido).
Note
En caso de tiempo de espera, se inician excepciones diferentes en implementaciones de .NET diferentes.
- HttpRequestException se inicia en todas las versiones de .NET Framework aplicables.
- OperationCanceledException sin ninguna excepción interna se inicia en todas las versiones de .NET Core aplicables.
- OperationCanceledException que anida una TimeoutException se inicia en .NET 5 y versiones posteriores.
Se aplica a
PostAsync(String, HttpContent)
Envíe una solicitud POST al URI especificado como una operación asincrónica.
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);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
Identificador URI al que se envía la solicitud.
- content
- HttpContent
El contenido de la solicitud HTTP enviado al servidor.
Devoluciones
Objeto de tarea que representa la operación asincrónica.
Excepciones
no requestUri es un URI absoluto y BaseAddress no se establece.
Error en la solicitud debido a un problema al obtener una respuesta HTTP válida, como un error de conectividad de red, un error dns, un error de validación del certificado de servidor o una respuesta de servidor no válida. En .NET 8 y versiones posteriores, el motivo se indica mediante HttpRequestError
O bien
solo .NET Framework: se agota el tiempo de espera de la solicitud.
.NET Core y .NET 5 y versiones posteriores solo: error en la solicitud debido al tiempo de espera.
El URI de solicitud proporcionado no es un URI relativo o absoluto válido.
Comentarios
Esta operación no se bloquea. El objeto devuelto Task<TResult> se completará después de leer toda la respuesta (incluido el contenido).
Note
En caso de tiempo de espera, se inician excepciones diferentes en implementaciones de .NET diferentes.
- HttpRequestException se inicia en todas las versiones de .NET Framework aplicables.
- OperationCanceledException sin ninguna excepción interna se inicia en todas las versiones de .NET Core aplicables.
- OperationCanceledException que anida una TimeoutException se inicia en .NET 5 y versiones posteriores.
Se aplica a
PostAsync(Uri, HttpContent)
Envíe una solicitud POST al URI especificado como una operación asincrónica.
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
Identificador URI al que se envía la solicitud.
- content
- HttpContent
El contenido de la solicitud HTTP enviado al servidor.
Devoluciones
Objeto de tarea que representa la operación asincrónica.
Excepciones
no requestUri es un URI absoluto y BaseAddress no se establece.
Error en la solicitud debido a un problema al obtener una respuesta HTTP válida, como un error de conectividad de red, un error dns, un error de validación del certificado de servidor o una respuesta de servidor no válida. En .NET 8 y versiones posteriores, el motivo se indica mediante HttpRequestError
O bien
solo .NET Framework: se agota el tiempo de espera de la solicitud.
.NET Core y .NET 5 y versiones posteriores solo: error en la solicitud debido al tiempo de espera.
Comentarios
Esta operación no se bloquea. El objeto devuelto Task<TResult> se completará después de leer toda la respuesta (incluido el contenido).
Note
En caso de tiempo de espera, se inician excepciones diferentes en implementaciones de .NET diferentes.
- HttpRequestException se inicia en todas las versiones de .NET Framework aplicables.
- OperationCanceledException sin ninguna excepción interna se inicia en todas las versiones de .NET Core aplicables.
- OperationCanceledException que anida una TimeoutException se inicia en .NET 5 y versiones posteriores.