HttpClient.PostAsync Méthode

Référence

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.

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

Task<HttpResponseMessage>

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

Exceptions

InvalidOperationException

requestUri doit être un URI absolu ou BaseAddress doit être défini.

HttpRequestException

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.

TaskCanceledException

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

UriFormatException

L’URI de requête fourni n’est pas un URI relatif ou absolu valide.

OperationCanceledException

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

Task<HttpResponseMessage>

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

Exceptions

InvalidOperationException

requestUri doit être un URI absolu ou BaseAddress doit être défini.

HttpRequestException

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.

TaskCanceledException

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

OperationCanceledException

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

Task<HttpResponseMessage>

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

Exceptions

InvalidOperationException

requestUri doit être un URI absolu ou BaseAddress doit être défini.

HttpRequestException

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.

TaskCanceledException

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

UriFormatException

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

Task<HttpResponseMessage>

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

Exceptions

InvalidOperationException

requestUri doit être un URI absolu ou BaseAddress doit être défini.

HttpRequestException

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.

TaskCanceledException

.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 à

Partager via

HttpClient.PostAsync Méthode

Définition

Surcharges

Remarques

PostAsync(String, HttpContent, CancellationToken)

Paramètres

Retours

Exceptions

Remarques

S’applique à

PostAsync(Uri, HttpContent, CancellationToken)

Paramètres

Retours

Exceptions

Remarques

S’applique à

PostAsync(String, HttpContent)

Paramètres

Retours

Exceptions

Remarques

S’applique à

PostAsync(Uri, HttpContent)

Paramètres

Retours

Exceptions

Remarques

S’applique à

Ressources supplémentaires