Partager via


HttpClient.SendAsync Méthode

Définition

Envoie une requête HTTP en tant qu'opération asynchrone.

Surcharges

SendAsync(HttpRequestMessage, HttpCompletionOption, CancellationToken)

Envoie une requête HTTP en tant qu'opération asynchrone.

SendAsync(HttpRequestMessage)

Envoie une requête HTTP en tant qu'opération asynchrone.

SendAsync(HttpRequestMessage, HttpCompletionOption)

Envoie une requête HTTP en tant qu'opération asynchrone.

SendAsync(HttpRequestMessage, CancellationToken)

Envoie une requête HTTP en tant qu'opération asynchrone.

Remarques

Cette opération ne se bloque pas.

SendAsync(HttpRequestMessage, HttpCompletionOption, CancellationToken)

Source:
HttpClient.cs
Source:
HttpClient.cs
Source:
HttpClient.cs

Envoie une requête HTTP en tant qu'opération asynchrone.

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)

Paramètres

request
HttpRequestMessage

Message de la requête HTTP à envoyer.

completionOption
HttpCompletionOption

Moment auquel l'opération doit s'exécuter (dès qu'une réponse est disponible ou après avoir pris connaissance du contenu de réponse entier).

cancellationToken
CancellationToken

Jeton d'annulation pour annuler une opération.

Retours

Objet de tâche représentant l'opération asynchrone.

Exceptions

request a la valeur null.

Le message de requête déjà été envoyé par l’instance HttpClient.

La demande a échoué en raison d’un problème sous-jacent, comme la connectivité réseau, une défaillance du DNS, la validation du certificat du serveur ou le délai d’attente.

.NET Core et .NET 5 et versions ultérieures uniquement : la demande a échoué en raison du délai d’expiration.

Le jeton d’annulation a été annulé. Cette exception est stockée dans la tâche retournée.

Remarques

Cette opération ne se bloque pas. En fonction de la valeur du completionOption paramètre, l’objet retourné Task<TResult> se termine dès qu’une réponse est disponible ou que l’intégralité de la réponse, y compris le contenu, est lue.

Notes

En cas de délai d’expiration, différentes exceptions sont levées sur différentes implémentations .NET.

Cette méthode stocke dans la tâche toutes les exceptions de non-utilisation que le équivalent synchrone de la méthode peut lever. Si une exception est stockée dans la tâche retournée, cette exception est levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de manière synchrone. Pour les exceptions stockées, consultez les exceptions levées par Send(HttpRequestMessage, HttpCompletionOption).

S’applique à

SendAsync(HttpRequestMessage)

Source:
HttpClient.cs
Source:
HttpClient.cs
Source:
HttpClient.cs

Envoie une requête HTTP en tant qu'opération asynchrone.

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)

Paramètres

request
HttpRequestMessage

Message de la requête HTTP à envoyer.

Retours

Objet de tâche représentant l'opération asynchrone.

Exceptions

request a la valeur null.

Le message de requête déjà été envoyé par l’instance HttpClient.

La demande a échoué en raison d’un problème sous-jacent, comme la connectivité réseau, une défaillance du DNS, la validation du certificat du serveur ou le délai d’attente.

.NET Core et .NET 5 et versions ultérieures uniquement : la demande a échoué en raison du délai d’expiration.

Remarques

Cette opération ne se bloque pas. L’objet retourné Task<TResult> se termine une fois la réponse entière, y compris le contenu, lue. Le comportement est le même que si ResponseContentRead avait été explicitement spécifié.

Notes

En cas de délai d’expiration, différentes exceptions sont levées sur différentes implémentations .NET.

Cette méthode stocke dans la tâche toutes les exceptions de non-utilisation que le équivalent synchrone de la méthode peut lever. Si une exception est stockée dans la tâche retournée, cette exception est levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de manière synchrone. Pour les exceptions stockées, consultez les exceptions levées par Send(HttpRequestMessage).

S’applique à

SendAsync(HttpRequestMessage, HttpCompletionOption)

Source:
HttpClient.cs
Source:
HttpClient.cs
Source:
HttpClient.cs

Envoie une requête HTTP en tant qu'opération asynchrone.

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)

Paramètres

request
HttpRequestMessage

Message de la requête HTTP à envoyer.

completionOption
HttpCompletionOption

Moment auquel l'opération doit s'exécuter (dès qu'une réponse est disponible ou après avoir pris connaissance du contenu de réponse entier).

Retours

Objet de tâche représentant l'opération asynchrone.

Exceptions

request a la valeur null.

Le message de requête déjà été envoyé par l’instance HttpClient.

La demande a échoué en raison d’un problème sous-jacent, comme la connectivité réseau, une défaillance du DNS, la validation du certificat du serveur ou le délai d’attente.

.NET Core et .NET 5 et versions ultérieures uniquement : la demande a échoué en raison du délai d’expiration.

Remarques

Cette opération ne se bloque pas. En fonction de la valeur du completionOption paramètre, l’objet retourné Task<TResult> se termine dès qu’une réponse est disponible ou que l’intégralité de la réponse, y compris le contenu, est lue.

Notes

En cas de délai d’expiration, différentes exceptions sont levées sur différentes implémentations .NET.

Cette méthode stocke dans la tâche toutes les exceptions de non-utilisation que le équivalent synchrone de la méthode peut lever. Si une exception est stockée dans la tâche retournée, cette exception est levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de manière synchrone. Pour les exceptions stockées, consultez les exceptions levées par Send(HttpRequestMessage, HttpCompletionOption).

S’applique à

SendAsync(HttpRequestMessage, CancellationToken)

Source:
HttpClient.cs
Source:
HttpClient.cs
Source:
HttpClient.cs

Envoie une requête HTTP en tant qu'opération asynchrone.

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)

Paramètres

request
HttpRequestMessage

Message de la requête HTTP à envoyer.

cancellationToken
CancellationToken

Jeton d'annulation pour annuler une opération.

Retours

Objet de tâche représentant l'opération asynchrone.

Exceptions

request a la valeur null.

Le message de requête déjà été envoyé par l’instance HttpClient.

La demande a échoué en raison d’un problème sous-jacent, comme la connectivité réseau, une défaillance du DNS, la validation du certificat du serveur ou le délai d’attente.

.NET Core et .NET 5 et versions ultérieures uniquement : la demande a échoué en raison du délai d’expiration.

Le jeton d’annulation a été annulé. Cette exception est stockée dans la tâche retournée.

Remarques

Cette opération ne se bloque pas. L’objet retourné Task<TResult> se termine une fois la réponse entière, y compris le contenu, lue. Le comportement est le même que si ResponseContentRead avait été explicitement spécifié.

Notes

En cas de délai d’expiration, différentes exceptions sont levées sur différentes implémentations .NET.

Cette méthode stocke dans la tâche toutes les exceptions de non-utilisation que le équivalent synchrone de la méthode peut lever. Si une exception est stockée dans la tâche retournée, cette exception est levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de manière synchrone. Pour les exceptions stockées, consultez les exceptions levées par Send(HttpRequestMessage).

S’applique à