Compartir a través de


HttpClient.SendAsync Método

Definición

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.

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.

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.

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.

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