HttpClient.PostAsync Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Verzend een POST-aanvraag naar de opgegeven URI als asynchrone bewerking.
Overloads
| Name | Description |
|---|---|
| PostAsync(Uri, HttpContent, CancellationToken) |
Verzend een POST-aanvraag met een annuleringstoken als asynchrone bewerking. |
| PostAsync(String, HttpContent, CancellationToken) |
Verzend een POST-aanvraag met een annuleringstoken als asynchrone bewerking. |
| PostAsync(String, HttpContent) |
Verzend een POST-aanvraag naar de opgegeven URI als asynchrone bewerking. |
| PostAsync(Uri, HttpContent) |
Verzend een POST-aanvraag naar de opgegeven URI als asynchrone bewerking. |
Opmerkingen
Deze bewerking wordt niet geblokkeerd.
PostAsync(Uri, HttpContent, CancellationToken)
Verzend een POST-aanvraag met een annuleringstoken als asynchrone bewerking.
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)Parameters
- requestUri
- Uri
De URI waar de aanvraag naar wordt verzonden.
- content
- HttpContent
De HTTP-aanvraaginhoud die naar de server is verzonden.
- cancellationToken
- CancellationToken
Een annuleringstoken dat kan worden gebruikt door andere objecten of threads om kennisgeving van annulering te ontvangen.
Retouren
Het taakobject dat de asynchrone bewerking vertegenwoordigt.
Uitzonderingen
Het requestUri is geen absolute URI en BaseAddress is niet ingesteld.
De aanvraag is mislukt vanwege een probleem met het ophalen van een geldig HTTP-antwoord, zoals netwerkverbindingsfout, DNS-fout, servercertificaatvalidatiefout of ongeldige serverreactie. In .NET 8 en latere versies wordt de reden aangegeven door HttpRequestError
– of –
alleen .NET Framework: er is een time-out opgetreden voor de aanvraag.
Het annuleringstoken is geannuleerd. Deze uitzondering wordt opgeslagen in de geretourneerde taak.
– of –
alleen .NET Core en .NET 5 en hoger: de aanvraag is mislukt vanwege een time-out.
Opmerkingen
Deze bewerking wordt niet geblokkeerd. Het geretourneerde Task<TResult> object wordt voltooid nadat het hele antwoord (inclusief inhoud) is gelezen.
Note
Bij time-outs worden er verschillende uitzonderingen gegenereerd op verschillende .NET implementaties.
- HttpRequestException wordt gegenereerd op alle toepasselijke .NET Framework-versies.
- OperationCanceledException zonder interne uitzondering wordt gegenereerd op alle toepasselijke .NET Core-versies.
- OperationCanceledException die een TimeoutException nest, wordt gegenereerd op .NET 5 en nieuwere versies.
Van toepassing op
PostAsync(String, HttpContent, CancellationToken)
Verzend een POST-aanvraag met een annuleringstoken als asynchrone bewerking.
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)Parameters
- requestUri
- String
De URI waar de aanvraag naar wordt verzonden.
- content
- HttpContent
De HTTP-aanvraaginhoud die naar de server is verzonden.
- cancellationToken
- CancellationToken
Een annuleringstoken dat kan worden gebruikt door andere objecten of threads om kennisgeving van annulering te ontvangen.
Retouren
Het taakobject dat de asynchrone bewerking vertegenwoordigt.
Uitzonderingen
Het requestUri is geen absolute URI en BaseAddress is niet ingesteld.
De aanvraag is mislukt vanwege een probleem met het ophalen van een geldig HTTP-antwoord, zoals netwerkverbindingsfout, DNS-fout, servercertificaatvalidatiefout of ongeldige serverreactie. In .NET 8 en latere versies wordt de reden aangegeven door HttpRequestError
– of –
alleen .NET Framework: er is een time-out opgetreden voor de aanvraag.
De opgegeven aanvraag-URI is geen geldige relatieve of absolute URI.
Het annuleringstoken is geannuleerd. Deze uitzondering wordt opgeslagen in de geretourneerde taak.
– of –
alleen .NET Core en .NET 5 en hoger: de aanvraag is mislukt vanwege een time-out.
Opmerkingen
Deze bewerking wordt niet geblokkeerd. Het geretourneerde Task<TResult> object wordt voltooid nadat het hele antwoord (inclusief inhoud) is gelezen.
Note
Bij time-outs worden er verschillende uitzonderingen gegenereerd op verschillende .NET implementaties.
- HttpRequestException wordt gegenereerd op alle toepasselijke .NET Framework-versies.
- OperationCanceledException zonder interne uitzondering wordt gegenereerd op alle toepasselijke .NET Core-versies.
- OperationCanceledException die een TimeoutException nest, wordt gegenereerd op .NET 5 en nieuwere versies.
Van toepassing op
PostAsync(String, HttpContent)
Verzend een POST-aanvraag naar de opgegeven URI als asynchrone bewerking.
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)Parameters
- requestUri
- String
De URI waar de aanvraag naar wordt verzonden.
- content
- HttpContent
De HTTP-aanvraaginhoud die naar de server is verzonden.
Retouren
Het taakobject dat de asynchrone bewerking vertegenwoordigt.
Uitzonderingen
Het requestUri is geen absolute URI en BaseAddress is niet ingesteld.
De aanvraag is mislukt vanwege een probleem met het ophalen van een geldig HTTP-antwoord, zoals netwerkverbindingsfout, DNS-fout, servercertificaatvalidatiefout of ongeldige serverreactie. In .NET 8 en latere versies wordt de reden aangegeven door HttpRequestError
– of –
alleen .NET Framework: er is een time-out opgetreden voor de aanvraag.
alleen .NET Core en .NET 5 en hoger: de aanvraag is mislukt vanwege een time-out.
De opgegeven aanvraag-URI is geen geldige relatieve of absolute URI.
Opmerkingen
Deze bewerking wordt niet geblokkeerd. Het geretourneerde Task<TResult> object wordt voltooid nadat het hele antwoord (inclusief inhoud) is gelezen.
Note
Bij time-outs worden er verschillende uitzonderingen gegenereerd op verschillende .NET implementaties.
- HttpRequestException wordt gegenereerd op alle toepasselijke .NET Framework-versies.
- OperationCanceledException zonder interne uitzondering wordt gegenereerd op alle toepasselijke .NET Core-versies.
- OperationCanceledException die een TimeoutException nest, wordt gegenereerd op .NET 5 en nieuwere versies.
Van toepassing op
PostAsync(Uri, HttpContent)
Verzend een POST-aanvraag naar de opgegeven URI als asynchrone bewerking.
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)Parameters
- requestUri
- Uri
De URI waar de aanvraag naar wordt verzonden.
- content
- HttpContent
De HTTP-aanvraaginhoud die naar de server is verzonden.
Retouren
Het taakobject dat de asynchrone bewerking vertegenwoordigt.
Uitzonderingen
Het requestUri is geen absolute URI en BaseAddress is niet ingesteld.
De aanvraag is mislukt vanwege een probleem met het ophalen van een geldig HTTP-antwoord, zoals netwerkverbindingsfout, DNS-fout, servercertificaatvalidatiefout of ongeldige serverreactie. In .NET 8 en latere versies wordt de reden aangegeven door HttpRequestError
– of –
alleen .NET Framework: er is een time-out opgetreden voor de aanvraag.
alleen .NET Core en .NET 5 en hoger: de aanvraag is mislukt vanwege een time-out.
Opmerkingen
Deze bewerking wordt niet geblokkeerd. Het geretourneerde Task<TResult> object wordt voltooid nadat het hele antwoord (inclusief inhoud) is gelezen.
Note
Bij time-outs worden er verschillende uitzonderingen gegenereerd op verschillende .NET implementaties.
- HttpRequestException wordt gegenereerd op alle toepasselijke .NET Framework-versies.
- OperationCanceledException zonder interne uitzondering wordt gegenereerd op alle toepasselijke .NET Core-versies.
- OperationCanceledException die een TimeoutException nest, wordt gegenereerd op .NET 5 en nieuwere versies.