HttpClient.PostAsync Méthode

Définition

Espace de noms:: System.Net.Http

Assembly:: System.Net.Http.dll

Assembly:: netstandard.dll

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.

Envoyez une requête POST à l’URI spécifié en tant qu’opération asynchrone.

Surcharges

Nom	Description
PostAsync(Uri, HttpContent, CancellationToken)	Envoyez une requête POST avec un jeton d’annulation en tant qu’opération asynchrone.
PostAsync(String, HttpContent, CancellationToken)	Envoyez une requête POST avec un jeton d’annulation en tant qu’opération asynchrone.
PostAsync(String, HttpContent)	Envoyez une requête POST à l’URI spécifié en tant qu’opération asynchrone.
PostAsync(Uri, HttpContent)	Envoyez une requête POST à l’URI spécifié en tant qu’opération asynchrone.

Remarques

Cette opération ne bloque pas.

PostAsync(Uri, HttpContent, CancellationToken)

Envoyez une requête POST avec un jeton d’annulation en tant qu’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);

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 la requête HTTP envoyé au serveur.

cancellationToken: CancellationToken

Jeton d’annulation qui peut être utilisé par d’autres objets ou threads pour recevoir une notification d’annulation.

Retours

Task<HttpResponseMessage>

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

Exceptions

InvalidOperationException

Ce requestUri n’est pas un URI absolu et BaseAddress n’est pas défini.

HttpRequestException

La requête a échoué en raison d’un problème d’obtention d’une réponse HTTP valide, telle que l’échec de connectivité réseau, l’échec DNS, l’erreur de validation du certificat de serveur ou la réponse du serveur non valide. Sur .NET 8 et versions ultérieures, la raison est indiquée par HttpRequestError

-ou-

.NET Framework uniquement : la requête a expiré.

OperationCanceledException

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

-ou-

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

Remarques

Cette opération ne bloque pas. L’objet retourné Task<TResult> se termine une fois la réponse entière (y compris le contenu) lue.

Note

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

HttpRequestException est levée sur toutes les versions .NET Framework applicables.
OperationCanceledException sans exception interne est levée sur toutes les versions .NET Core applicables.
OperationCanceledException qui imbrique un TimeoutException est levée sur .NET 5 et versions ultérieures.

S’applique à

PostAsync(String, HttpContent, CancellationToken)

Envoyez une requête POST avec un jeton d’annulation en tant qu’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);

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 la requête HTTP envoyé au serveur.

cancellationToken: CancellationToken

Jeton d’annulation qui peut être utilisé par d’autres objets ou threads pour recevoir une notification d’annulation.

Retours

Task<HttpResponseMessage>

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

Exceptions

InvalidOperationException

Ce requestUri n’est pas un URI absolu et BaseAddress n’est pas défini.

HttpRequestException

-ou-

.NET Framework uniquement : la requête a expiré.

UriFormatException

L’URI de la demande fourni n’est pas valide par rapport ou PAR URI absolu.

OperationCanceledException

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

-ou-

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

Remarques

Cette opération ne bloque pas. L’objet retourné Task<TResult> se termine une fois la réponse entière (y compris le contenu) lue.

Note

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

HttpRequestException est levée sur toutes les versions .NET Framework applicables.
OperationCanceledException sans exception interne est levée sur toutes les versions .NET Core applicables.
OperationCanceledException qui imbrique un TimeoutException est levée sur .NET 5 et versions ultérieures.

S’applique à

PostAsync(String, HttpContent)

Envoyez une requête POST à l’URI spécifié en tant qu’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);

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 la requête HTTP envoyé au serveur.

Retours

Task<HttpResponseMessage>

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

Exceptions

InvalidOperationException

Ce requestUri n’est pas un URI absolu et BaseAddress n’est pas défini.

HttpRequestException

-ou-

.NET Framework uniquement : la requête a expiré.

OperationCanceledException

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

UriFormatException

L’URI de la demande fourni n’est pas valide par rapport ou PAR URI absolu.

Remarques

Cette opération ne bloque pas. L’objet retourné Task<TResult> se termine une fois la réponse entière (y compris le contenu) lue.

Note

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

HttpRequestException est levée sur toutes les versions .NET Framework applicables.
OperationCanceledException sans exception interne est levée sur toutes les versions .NET Core applicables.
OperationCanceledException qui imbrique un TimeoutException est levée sur .NET 5 et versions ultérieures.

S’applique à

PostAsync(Uri, HttpContent)

Envoyez une requête POST à l’URI spécifié en tant qu’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);

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 la requête HTTP envoyé au serveur.

Retours

Task<HttpResponseMessage>

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

Exceptions

InvalidOperationException

Ce requestUri n’est pas un URI absolu et BaseAddress n’est pas défini.

HttpRequestException

-ou-

.NET Framework uniquement : la requête a expiré.

OperationCanceledException

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

Remarques

Cette opération ne bloque pas. L’objet retourné Task<TResult> se termine une fois la réponse entière (y compris le contenu) lue.

Note

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

HttpRequestException est levée sur toutes les versions .NET Framework applicables.
OperationCanceledException sans exception interne est levée sur toutes les versions .NET Core applicables.
OperationCanceledException qui imbrique un TimeoutException est levée sur .NET 5 et versions ultérieures.

S’applique à

Commentaires

Cette page a-t-elle été utile ?