HttpClient.SendAsync 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ía una solicitud HTTP como una operación asincrónica.
Sobrecargas
| SendAsync(HttpRequestMessage, HttpCompletionOption, CancellationToken) |
Envía una solicitud HTTP como una operación asincrónica. |
| SendAsync(HttpRequestMessage) |
Envía una solicitud HTTP como una operación asincrónica. |
| SendAsync(HttpRequestMessage, HttpCompletionOption) |
Envía una solicitud HTTP como una operación asincrónica. |
| SendAsync(HttpRequestMessage, CancellationToken) |
Envía una solicitud HTTP como una operación asincrónica. |
Comentarios
Esta operación no se bloqueará.
SendAsync(HttpRequestMessage, HttpCompletionOption, CancellationToken)
- Source:
- HttpClient.cs
- Source:
- HttpClient.cs
- Source:
- HttpClient.cs
Envía una solicitud HTTP como una operación asincrónica.
public:
System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ SendAsync(System::Net::Http::HttpRequestMessage ^ request, System::Net::Http::HttpCompletionOption completionOption, System::Threading::CancellationToken cancellationToken);public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> SendAsync (System.Net.Http.HttpRequestMessage request, System.Net.Http.HttpCompletionOption completionOption, System.Threading.CancellationToken cancellationToken);override this.SendAsync : System.Net.Http.HttpRequestMessage * System.Net.Http.HttpCompletionOption * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>Public Function SendAsync (request As HttpRequestMessage, completionOption As HttpCompletionOption, cancellationToken As CancellationToken) As Task(Of HttpResponseMessage)Parámetros
- request
- HttpRequestMessage
Mensaje de la solicitud HTTP que se va a enviar.
- completionOption
- HttpCompletionOption
Cuándo se debe completar la operación (tan pronto como haya una respuesta disponible o después de leer todo el contenido de la respuesta).
- cancellationToken
- CancellationToken
Token de cancelación para cancelar la operación.
Devoluciones
Objeto de tarea que representa la operación asincrónica.
Excepciones
El valor de request es null.
La instancia HttpClient ya envió el mensaje de solicitud.
Error en la solicitud debido a un problema subyacente, como la conectividad de red, un error de DNS, la validación del certificado de servidor o el tiempo de espera.
Solo .NET Core y .NET 5 y versiones posteriores: se produjo un error en la solicitud debido al tiempo de espera.
Se canceló el token de cancelación. Esta excepción se almacena en la tarea devuelta.
Comentarios
Esta operación no se bloqueará. Según el valor del completionOption parámetro , el objeto devuelto Task<TResult> se completará en cuanto haya disponible una respuesta o se lea toda la respuesta, incluido el contenido.
Nota
En el caso del tiempo de espera, se producen excepciones diferentes en diferentes implementaciones de .NET.
- HttpRequestException se produce en todas las versiones de .NET Framework aplicables.
- TaskCanceledException sin ninguna excepción interna se produce en todas las versiones de .NET Core aplicables.
- TaskCanceledException que anida un TimeoutException elemento se inicia en .NET 5 y versiones posteriores.
Este método almacena en la tarea que devuelve todas las excepciones que no son de uso que puede producir el homólogo sincrónico del método. Si se almacena una excepción en la tarea devuelta, se producirá esa excepción cuando se espere la tarea. Las excepciones de uso, como ArgumentException, se siguen iniciando de forma sincrónica. Para ver las excepciones almacenadas, consulte las excepciones producidas por Send(HttpRequestMessage, HttpCompletionOption).
Se aplica a
SendAsync(HttpRequestMessage)
- Source:
- HttpClient.cs
- Source:
- HttpClient.cs
- Source:
- HttpClient.cs
Envía una solicitud HTTP como una operación asincrónica.
public:
System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ SendAsync(System::Net::Http::HttpRequestMessage ^ request);public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> SendAsync (System.Net.Http.HttpRequestMessage request);override this.SendAsync : System.Net.Http.HttpRequestMessage -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>Public Function SendAsync (request As HttpRequestMessage) As Task(Of HttpResponseMessage)Parámetros
- request
- HttpRequestMessage
Mensaje de la solicitud HTTP que se va a enviar.
Devoluciones
Objeto de tarea que representa la operación asincrónica.
Excepciones
El valor de request es null.
La instancia HttpClient ya envió el mensaje de solicitud.
Error en la solicitud debido a un problema subyacente, como la conectividad de red, un error de DNS, la validación del certificado de servidor o el tiempo de espera.
Solo .NET Core y .NET 5 y versiones posteriores: se produjo un error en la solicitud debido al tiempo de espera.
Comentarios
Esta operación no se bloqueará. El objeto devuelto Task<TResult> se completará una vez que se lea toda la respuesta, incluido el contenido. El comportamiento es el mismo que si ResponseContentRead se ha especificado explícitamente.
Nota
En el caso del tiempo de espera, se producen excepciones diferentes en diferentes implementaciones de .NET.
- HttpRequestException se produce en todas las versiones de .NET Framework aplicables.
- TaskCanceledException sin ninguna excepción interna se produce en todas las versiones de .NET Core aplicables.
- TaskCanceledException que anida un TimeoutException elemento se inicia en .NET 5 y versiones posteriores.
Este método almacena en la tarea que devuelve todas las excepciones que no son de uso que puede producir el homólogo sincrónico del método. Si se almacena una excepción en la tarea devuelta, se producirá esa excepción cuando se espere la tarea. Las excepciones de uso, como ArgumentException, se siguen iniciando de forma sincrónica. Para ver las excepciones almacenadas, consulte las excepciones producidas por Send(HttpRequestMessage).
Se aplica a
SendAsync(HttpRequestMessage, HttpCompletionOption)
- Source:
- HttpClient.cs
- Source:
- HttpClient.cs
- Source:
- HttpClient.cs
Envía una solicitud HTTP como una operación asincrónica.
public:
System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ SendAsync(System::Net::Http::HttpRequestMessage ^ request, System::Net::Http::HttpCompletionOption completionOption);public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> SendAsync (System.Net.Http.HttpRequestMessage request, System.Net.Http.HttpCompletionOption completionOption);override this.SendAsync : System.Net.Http.HttpRequestMessage * System.Net.Http.HttpCompletionOption -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>Public Function SendAsync (request As HttpRequestMessage, completionOption As HttpCompletionOption) As Task(Of HttpResponseMessage)Parámetros
- request
- HttpRequestMessage
Mensaje de la solicitud HTTP que se va a enviar.
- completionOption
- HttpCompletionOption
Cuándo se debe completar la operación (tan pronto como haya una respuesta disponible o después de leer todo el contenido de la respuesta).
Devoluciones
Objeto de tarea que representa la operación asincrónica.
Excepciones
El valor de request es null.
La instancia HttpClient ya envió el mensaje de solicitud.
Error en la solicitud debido a un problema subyacente, como la conectividad de red, un error de DNS, la validación del certificado de servidor o el tiempo de espera.
Solo .NET Core y .NET 5 y versiones posteriores: se produjo un error en la solicitud debido al tiempo de espera.
Comentarios
Esta operación no se bloqueará. Según el valor del completionOption parámetro , el objeto devuelto Task<TResult> se completará en cuanto haya disponible una respuesta o se lea toda la respuesta, incluido el contenido.
Nota
En el caso del tiempo de espera, se producen excepciones diferentes en diferentes implementaciones de .NET.
- HttpRequestException se produce en todas las versiones de .NET Framework aplicables.
- TaskCanceledException sin ninguna excepción interna se produce en todas las versiones de .NET Core aplicables.
- TaskCanceledException que anida un TimeoutException elemento se inicia en .NET 5 y versiones posteriores.
Este método almacena en la tarea que devuelve todas las excepciones que no son de uso que puede producir el homólogo sincrónico del método. Si se almacena una excepción en la tarea devuelta, se producirá esa excepción cuando se espere la tarea. Las excepciones de uso, como ArgumentException, se siguen iniciando de forma sincrónica. Para ver las excepciones almacenadas, consulte las excepciones producidas por Send(HttpRequestMessage, HttpCompletionOption).
Se aplica a
SendAsync(HttpRequestMessage, CancellationToken)
- Source:
- HttpClient.cs
- Source:
- HttpClient.cs
- Source:
- HttpClient.cs
Envía una solicitud HTTP como una operación asincrónica.
public:
override System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ SendAsync(System::Net::Http::HttpRequestMessage ^ request, System::Threading::CancellationToken cancellationToken);public override System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> SendAsync (System.Net.Http.HttpRequestMessage request, System.Threading.CancellationToken cancellationToken);override this.SendAsync : System.Net.Http.HttpRequestMessage * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>Public Overrides Function SendAsync (request As HttpRequestMessage, cancellationToken As CancellationToken) As Task(Of HttpResponseMessage)Parámetros
- request
- HttpRequestMessage
Mensaje de la solicitud HTTP que se va a enviar.
- cancellationToken
- CancellationToken
Token de cancelación para cancelar la operación.
Devoluciones
Objeto de tarea que representa la operación asincrónica.
Excepciones
El valor de request es null.
La instancia HttpClient ya envió el mensaje de solicitud.
Error en la solicitud debido a un problema subyacente, como la conectividad de red, un error de DNS, la validación del certificado de servidor o el tiempo de espera.
Solo .NET Core y .NET 5 y versiones posteriores: se produjo un error en la solicitud debido al tiempo de espera.
Se canceló el token de cancelación. Esta excepción se almacena en la tarea devuelta.
Comentarios
Esta operación no se bloqueará. El objeto devuelto Task<TResult> se completará una vez que se lea toda la respuesta, incluido el contenido. El comportamiento es el mismo que si ResponseContentRead se ha especificado explícitamente.
Nota
En el caso del tiempo de espera, se producen excepciones diferentes en diferentes implementaciones de .NET.
- HttpRequestException se produce en todas las versiones de .NET Framework aplicables.
- TaskCanceledException sin ninguna excepción interna se produce en todas las versiones de .NET Core aplicables.
- TaskCanceledException que anida un TimeoutException elemento se inicia en .NET 5 y versiones posteriores.
Este método almacena en la tarea que devuelve todas las excepciones que no son de uso que puede producir el homólogo sincrónico del método. Si se almacena una excepción en la tarea devuelta, se producirá esa excepción cuando se espere la tarea. Las excepciones de uso, como ArgumentException, se siguen iniciando de forma sincrónica. Para ver las excepciones almacenadas, consulte las excepciones producidas por Send(HttpRequestMessage).
