HttpClient.SendAsync Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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.
- HttpRequestException est levée sur toutes les versions de .NET Framework applicables.
- TaskCanceledException sans aucune exception interne est levée sur toutes les versions de .NET Core applicables.
- TaskCanceledException qui imbriquez un TimeoutException est levée sur .NET 5 et versions ultérieures.
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.
- HttpRequestException est levée sur toutes les versions de .NET Framework applicables.
- TaskCanceledException sans aucune exception interne est levée sur toutes les versions de .NET Core applicables.
- TaskCanceledException qui imbriquez un TimeoutException est levée sur .NET 5 et versions ultérieures.
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.
- HttpRequestException est levée sur toutes les versions de .NET Framework applicables.
- TaskCanceledException sans aucune exception interne est levée sur toutes les versions de .NET Core applicables.
- TaskCanceledException qui imbriquez un TimeoutException est levée sur .NET 5 et versions ultérieures.
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.
- HttpRequestException est levée sur toutes les versions de .NET Framework applicables.
- TaskCanceledException sans aucune exception interne est levée sur toutes les versions de .NET Core applicables.
- TaskCanceledException qui imbriquez un TimeoutException est levée sur .NET 5 et versions ultérieures.
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).
