HttpClient.SendAsync Método
Definición
Envía una solicitud HTTP como una operación asincrónica.Send an HTTP request as an asynchronous operation.
Sobrecargas
| SendAsync(HttpRequestMessage, HttpCompletionOption, CancellationToken) |
Envía una solicitud HTTP como una operación asincrónica.Send an HTTP request as an asynchronous operation. |
| SendAsync(HttpRequestMessage) |
Envía una solicitud HTTP como una operación asincrónica.Send an HTTP request as an asynchronous operation. |
| SendAsync(HttpRequestMessage, HttpCompletionOption) |
Envía una solicitud HTTP como una operación asincrónica.Send an HTTP request as an asynchronous operation. |
| SendAsync(HttpRequestMessage, CancellationToken) |
Envía una solicitud HTTP como una operación asincrónica.Send an HTTP request as an asynchronous operation. |
Comentarios
Esta operación no se bloqueará.This operation will not block.
SendAsync(HttpRequestMessage, HttpCompletionOption, CancellationToken)
Envía una solicitud HTTP como una operación asincrónica.Send an HTTP request as an asynchronous operation.
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.The HTTP request message to send.
- 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).When the operation should complete (as soon as a response is available or after reading the whole response content).
- cancellationToken
- CancellationToken
Token de cancelación para cancelar la operación.The cancellation token to cancel operation.
Devoluciones
Objeto de tarea que representa la operación asincrónica.The task object representing the asynchronous operation.
Excepciones
El valor de request es null.The request is null.
La instancia HttpClient ya envió el mensaje de solicitud.The request message was already sent by the HttpClient instance.
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.The request failed due to an underlying issue such as network connectivity, DNS failure, server certificate validation or timeout.
Solo .NET Core y .NET 5.0 y versiones posteriores: Error en la solicitud debido a que se agotó el tiempo de espera..NET Core and .NET 5.0 and later only: The request failed due to timeout.
Comentarios
Esta operación no se bloqueará.This operation will not block. Dependiendo del valor del completionOption parámetro, el objeto devuelto Task<TResult> se completará en cuanto haya una respuesta disponible o se leerá toda la respuesta, incluido el contenido.Depending on the value of the completionOption parameter, the returned Task<TResult> object will complete as soon as a response is available or the entire response including content is read.
Nota
En el caso del tiempo de espera, se producen diferentes excepciones en diferentes implementaciones de .NET.In case of timeout, different exceptions are thrown on different .NET implementations.
- HttpRequestException se produce en todas las versiones de .NET Framework aplicables.HttpRequestException is thrown on all applicable .NET Framework versions.
- TaskCanceledException sin ninguna excepción interna se produce en todas las versiones de .NET Core aplicables.TaskCanceledException without any inner exception is thrown on all applicable .NET Core versions.
- TaskCanceledException que anida un TimeoutException se inicia en .net 5,0 y versiones posteriores.TaskCanceledException that nests a TimeoutException is thrown on .NET 5.0 and later versions.
Se aplica a
SendAsync(HttpRequestMessage)
Envía una solicitud HTTP como una operación asincrónica.Send an HTTP request as an asynchronous operation.
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.The HTTP request message to send.
Devoluciones
Objeto de tarea que representa la operación asincrónica.The task object representing the asynchronous operation.
Excepciones
El valor de request es null.The request is null.
La instancia HttpClient ya envió el mensaje de solicitud.The request message was already sent by the HttpClient instance.
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.The request failed due to an underlying issue such as network connectivity, DNS failure, server certificate validation or timeout.
Solo .NET Core y .NET 5.0 y versiones posteriores: Error en la solicitud debido a que se agotó el tiempo de espera..NET Core and .NET 5.0 and later only: The request failed due to timeout.
Comentarios
Esta operación no se bloqueará.This operation will not block. El objeto devuelto Task<TResult> se completará una vez que se lea la respuesta completa, incluido el contenido.The returned Task<TResult> object will complete once the entire response including content is read.
Nota
En el caso del tiempo de espera, se producen diferentes excepciones en diferentes implementaciones de .NET.In case of timeout, different exceptions are thrown on different .NET implementations.
- HttpRequestException se produce en todas las versiones de .NET Framework aplicables.HttpRequestException is thrown on all applicable .NET Framework versions.
- TaskCanceledException sin ninguna excepción interna se produce en todas las versiones de .NET Core aplicables.TaskCanceledException without any inner exception is thrown on all applicable .NET Core versions.
- TaskCanceledException que anida un TimeoutException se inicia en .net 5,0 y versiones posteriores.TaskCanceledException that nests a TimeoutException is thrown on .NET 5.0 and later versions.
Se aplica a
SendAsync(HttpRequestMessage, HttpCompletionOption)
Envía una solicitud HTTP como una operación asincrónica.Send an HTTP request as an asynchronous operation.
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.The HTTP request message to send.
- 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).When the operation should complete (as soon as a response is available or after reading the whole response content).
Devoluciones
Objeto de tarea que representa la operación asincrónica.The task object representing the asynchronous operation.
Excepciones
El valor de request es null.The request is null.
La instancia HttpClient ya envió el mensaje de solicitud.The request message was already sent by the HttpClient instance.
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.The request failed due to an underlying issue such as network connectivity, DNS failure, server certificate validation or timeout.
Solo .NET Core y .NET 5.0 y versiones posteriores: Error en la solicitud debido a que se agotó el tiempo de espera..NET Core and .NET 5.0 and later only: The request failed due to timeout.
Comentarios
Esta operación no se bloqueará.This operation will not block. Dependiendo del valor del completionOption parámetro, el objeto devuelto Task<TResult> se completará en cuanto haya una respuesta disponible o se leerá toda la respuesta, incluido el contenido.Depending on the value of the completionOption parameter, the returned Task<TResult> object will complete as soon as a response is available or the entire response including content is read.
Nota
En el caso del tiempo de espera, se producen diferentes excepciones en diferentes implementaciones de .NET.In case of timeout, different exceptions are thrown on different .NET implementations.
- HttpRequestException se produce en todas las versiones de .NET Framework aplicables.HttpRequestException is thrown on all applicable .NET Framework versions.
- TaskCanceledException sin ninguna excepción interna se produce en todas las versiones de .NET Core aplicables.TaskCanceledException without any inner exception is thrown on all applicable .NET Core versions.
- TaskCanceledException que anida un TimeoutException se inicia en .net 5,0 y versiones posteriores.TaskCanceledException that nests a TimeoutException is thrown on .NET 5.0 and later versions.
Se aplica a
SendAsync(HttpRequestMessage, CancellationToken)
Envía una solicitud HTTP como una operación asincrónica.Send an HTTP request as an asynchronous operation.
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.The HTTP request message to send.
- cancellationToken
- CancellationToken
Token de cancelación para cancelar la operación.The cancellation token to cancel operation.
Devoluciones
Objeto de tarea que representa la operación asincrónica.The task object representing the asynchronous operation.
Excepciones
El valor de request es null.The request is null.
La instancia HttpClient ya envió el mensaje de solicitud.The request message was already sent by the HttpClient instance.
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.The request failed due to an underlying issue such as network connectivity, DNS failure, server certificate validation or timeout.
Solo .NET Core y .NET 5.0 y versiones posteriores: Error en la solicitud debido a que se agotó el tiempo de espera..NET Core and .NET 5.0 and later only: The request failed due to timeout.
Comentarios
Esta operación no se bloqueará.This operation will not block. El objeto devuelto Task<TResult> se completará una vez que se lea la respuesta completa, incluido el contenido.The returned Task<TResult> object will complete once the entire response including content is read.
Nota
En el caso del tiempo de espera, se producen diferentes excepciones en diferentes implementaciones de .NET.In case of timeout, different exceptions are thrown on different .NET implementations.
- HttpRequestException se produce en todas las versiones de .NET Framework aplicables.HttpRequestException is thrown on all applicable .NET Framework versions.
- TaskCanceledException sin ninguna excepción interna se produce en todas las versiones de .NET Core aplicables.TaskCanceledException without any inner exception is thrown on all applicable .NET Core versions.
- TaskCanceledException que anida un TimeoutException se inicia en .net 5,0 y versiones posteriores.TaskCanceledException that nests a TimeoutException is thrown on .NET 5.0 and later versions.