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 d’un 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’ensemble de la réponse, y compris le contenu, est lu.
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 imbrit 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 l’équivalent synchrone de la méthode peut lever. Si une exception est stockée dans la tâche retournée, cette exception sera levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de manière synchrone. Pour connaître 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 d’un délai d’expiration.
Remarques
Cette opération ne se bloque pas. L’objet retourné Task<TResult> se termine une fois que l’ensemble de la réponse, y compris le contenu, est lu. Le comportement est le même que si ResponseContentRead avait été spécifié explicitement.
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 imbrit 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 l’équivalent synchrone de la méthode peut lever. Si une exception est stockée dans la tâche retournée, cette exception sera levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de manière synchrone. Pour connaître 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 d’un 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’ensemble de la réponse, y compris le contenu, est lu.
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 imbrit 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 l’équivalent synchrone de la méthode peut lever. Si une exception est stockée dans la tâche retournée, cette exception sera levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de manière synchrone. Pour connaître 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 d’un 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 que l’ensemble de la réponse, y compris le contenu, est lu. Le comportement est le même que si ResponseContentRead avait été spécifié explicitement.
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 imbrit 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 l’équivalent synchrone de la méthode peut lever. Si une exception est stockée dans la tâche retournée, cette exception sera levée lorsque la tâche est attendue. Les exceptions d’utilisation, telles que ArgumentException, sont toujours levées de manière synchrone. Pour connaître les exceptions stockées, consultez les exceptions levées par Send(HttpRequestMessage).
S’applique à
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour