HttpClient.PostAsync 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 POST vers l'URI spécifié sous forme d'opération asynchrone.
Surcharges
| PostAsync(String, HttpContent, CancellationToken) |
Envoie une requête POST avec un jeton d'annulation sous forme d'opération asynchrone. |
| PostAsync(Uri, HttpContent, CancellationToken) |
Envoie une requête POST avec un jeton d'annulation sous forme d'opération asynchrone. |
| PostAsync(String, HttpContent) |
Envoie une requête POST vers l'URI spécifié sous forme d'opération asynchrone. |
| PostAsync(Uri, HttpContent) |
Envoie une requête POST vers l'URI spécifié sous forme d'opération asynchrone. |
Remarques
Cette opération ne se bloque pas.
PostAsync(String, HttpContent, CancellationToken)
- Source:
- HttpClient.cs
- Source:
- HttpClient.cs
- Source:
- HttpClient.cs
Envoie une requête POST avec un jeton d'annulation sous forme d'opération asynchrone.
public:
System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ PostAsync(System::String ^ requestUri, System::Net::Http::HttpContent ^ content, System::Threading::CancellationToken cancellationToken);public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PostAsync (string requestUri, System.Net.Http.HttpContent content, System.Threading.CancellationToken cancellationToken);public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PostAsync (string? requestUri, System.Net.Http.HttpContent content, System.Threading.CancellationToken cancellationToken);public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PostAsync (string? requestUri, System.Net.Http.HttpContent? content, System.Threading.CancellationToken cancellationToken);member this.PostAsync : string * System.Net.Http.HttpContent * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>Public Function PostAsync (requestUri As String, content As HttpContent, cancellationToken As CancellationToken) As Task(Of HttpResponseMessage)Paramètres
- requestUri
- String
URI auquel la requête est envoyée.
- content
- HttpContent
Contenu de requête HTTP envoyé au serveur.
- cancellationToken
- CancellationToken
Jeton d'annulation qui peut être utilisé par d'autres objets ou threads pour être informés de l'annulation.
Retours
Objet de tâche représentant l'opération asynchrone.
Exceptions
requestUri doit être un URI absolu ou BaseAddress doit être défini.
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.
L’URI de requête fourni n’est pas un URI relatif ou absolu valide.
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.
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.
S’applique à
PostAsync(Uri, HttpContent, CancellationToken)
- Source:
- HttpClient.cs
- Source:
- HttpClient.cs
- Source:
- HttpClient.cs
Envoie une requête POST avec un jeton d'annulation sous forme d'opération asynchrone.
public:
System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ PostAsync(Uri ^ requestUri, System::Net::Http::HttpContent ^ content, System::Threading::CancellationToken cancellationToken);public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PostAsync (Uri requestUri, System.Net.Http.HttpContent content, System.Threading.CancellationToken cancellationToken);public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PostAsync (Uri? requestUri, System.Net.Http.HttpContent content, System.Threading.CancellationToken cancellationToken);public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PostAsync (Uri? requestUri, System.Net.Http.HttpContent? content, System.Threading.CancellationToken cancellationToken);member this.PostAsync : Uri * System.Net.Http.HttpContent * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>Public Function PostAsync (requestUri As Uri, content As HttpContent, cancellationToken As CancellationToken) As Task(Of HttpResponseMessage)Paramètres
- requestUri
- Uri
URI auquel la requête est envoyée.
- content
- HttpContent
Contenu de requête HTTP envoyé au serveur.
- cancellationToken
- CancellationToken
Jeton d'annulation qui peut être utilisé par d'autres objets ou threads pour être informés de l'annulation.
Retours
Objet de tâche représentant l'opération asynchrone.
Exceptions
requestUri doit être un URI absolu ou BaseAddress doit être défini.
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 la réponse entière (y compris le contenu) 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 imbrit un TimeoutException est levée sur .NET 5 et versions ultérieures.
S’applique à
PostAsync(String, HttpContent)
- Source:
- HttpClient.cs
- Source:
- HttpClient.cs
- Source:
- HttpClient.cs
Envoie une requête POST vers l'URI spécifié sous forme d'opération asynchrone.
public:
System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ PostAsync(System::String ^ requestUri, System::Net::Http::HttpContent ^ content);public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PostAsync (string requestUri, System.Net.Http.HttpContent content);public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PostAsync (string? requestUri, System.Net.Http.HttpContent content);public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PostAsync (string? requestUri, System.Net.Http.HttpContent? content);member this.PostAsync : string * System.Net.Http.HttpContent -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>Public Function PostAsync (requestUri As String, content As HttpContent) As Task(Of HttpResponseMessage)Paramètres
- requestUri
- String
URI auquel la requête est envoyée.
- content
- HttpContent
Contenu de requête HTTP envoyé au serveur.
Retours
Objet de tâche représentant l'opération asynchrone.
Exceptions
requestUri doit être un URI absolu ou BaseAddress doit être défini.
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.
L’URI de requête fourni n’est pas un URI relatif ou absolu valide.
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.
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.
S’applique à
PostAsync(Uri, HttpContent)
- Source:
- HttpClient.cs
- Source:
- HttpClient.cs
- Source:
- HttpClient.cs
Envoie une requête POST vers l'URI spécifié sous forme d'opération asynchrone.
public:
System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ PostAsync(Uri ^ requestUri, System::Net::Http::HttpContent ^ content);public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PostAsync (Uri requestUri, System.Net.Http.HttpContent content);public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PostAsync (Uri? requestUri, System.Net.Http.HttpContent content);public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> PostAsync (Uri? requestUri, System.Net.Http.HttpContent? content);member this.PostAsync : Uri * System.Net.Http.HttpContent -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>Public Function PostAsync (requestUri As Uri, content As HttpContent) As Task(Of HttpResponseMessage)Paramètres
- requestUri
- Uri
URI auquel la requête est envoyée.
- content
- HttpContent
Contenu de requête HTTP envoyé au serveur.
Retours
Objet de tâche représentant l'opération asynchrone.
Exceptions
requestUri doit être un URI absolu ou BaseAddress doit être défini.
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 la réponse entière (y compris le contenu) 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 imbrit un TimeoutException est levée sur .NET 5 et versions ultérieures.
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