HttpClient.SendAsync 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 HTTP-aanvraag als asynchrone bewerking.
Overloads
| Name | Description |
|---|---|
| SendAsync(HttpRequestMessage, HttpCompletionOption, CancellationToken) |
Verzend een HTTP-aanvraag als asynchrone bewerking. |
| SendAsync(HttpRequestMessage) |
Verzend een HTTP-aanvraag als asynchrone bewerking. |
| SendAsync(HttpRequestMessage, HttpCompletionOption) |
Verzend een HTTP-aanvraag als asynchrone bewerking. |
| SendAsync(HttpRequestMessage, CancellationToken) |
Verzend een HTTP-aanvraag als asynchrone bewerking. |
Opmerkingen
Deze bewerking wordt niet geblokkeerd.
SendAsync(HttpRequestMessage, HttpCompletionOption, CancellationToken)
Verzend een HTTP-aanvraag als asynchrone bewerking.
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)Parameters
- request
- HttpRequestMessage
Het HTTP-aanvraagbericht dat moet worden verzonden.
- completionOption
- HttpCompletionOption
Wanneer de bewerking moet worden voltooid (zodra een antwoord beschikbaar is of nadat de volledige antwoordinhoud is gelezen).
- cancellationToken
- CancellationToken
Het annuleringstoken om de bewerking te annuleren.
Retouren
Het taakobject dat de asynchrone bewerking vertegenwoordigt.
Uitzonderingen
De request is null.
Het aanvraagbericht is al verzonden door het HttpClient exemplaar.
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. Afhankelijk van de waarde van de completionOption parameter wordt het geretourneerde Task<TResult> object voltooid zodra er een antwoord beschikbaar is of het volledige antwoord inclusief inhoud wordt 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.
Deze methode slaat op in de taak die alle uitzonderingen voor niet-gebruik retourneert die de synchrone tegenhanger van de methode kan genereren. Als er een uitzondering wordt opgeslagen in de geretourneerde taak, wordt deze uitzondering gegenereerd wanneer de taak wordt gewacht. Gebruiksonderzondering, zoals ArgumentException, worden nog steeds synchroon gegenereerd. Zie de uitzonderingen die zijn gegenereerd door Send(HttpRequestMessage, HttpCompletionOption)de opgeslagen uitzonderingen voor de opgeslagen uitzonderingen.
Van toepassing op
SendAsync(HttpRequestMessage)
Verzend een HTTP-aanvraag als asynchrone bewerking.
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)Parameters
- request
- HttpRequestMessage
Het HTTP-aanvraagbericht dat moet worden verzonden.
Retouren
Het taakobject dat de asynchrone bewerking vertegenwoordigt.
Uitzonderingen
De request is null.
Het aanvraagbericht is al verzonden door het HttpClient exemplaar.
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 zodra het volledige antwoord inclusief inhoud wordt gelezen. Het gedrag is hetzelfde als als dat ResponseContentRead expliciet is opgegeven.
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.
Deze methode slaat op in de taak die alle uitzonderingen voor niet-gebruik retourneert die de synchrone tegenhanger van de methode kan genereren. Als er een uitzondering wordt opgeslagen in de geretourneerde taak, wordt deze uitzondering gegenereerd wanneer de taak wordt gewacht. Gebruiksonderzondering, zoals ArgumentException, worden nog steeds synchroon gegenereerd. Zie de uitzonderingen die zijn gegenereerd door Send(HttpRequestMessage)de opgeslagen uitzonderingen voor de opgeslagen uitzonderingen.
Van toepassing op
SendAsync(HttpRequestMessage, HttpCompletionOption)
Verzend een HTTP-aanvraag als asynchrone bewerking.
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)Parameters
- request
- HttpRequestMessage
Het HTTP-aanvraagbericht dat moet worden verzonden.
- completionOption
- HttpCompletionOption
Wanneer de bewerking moet worden voltooid (zodra een antwoord beschikbaar is of nadat de volledige antwoordinhoud is gelezen).
Retouren
Het taakobject dat de asynchrone bewerking vertegenwoordigt.
Uitzonderingen
De request is null.
Het aanvraagbericht is al verzonden door het HttpClient exemplaar.
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. Afhankelijk van de waarde van de completionOption parameter wordt het geretourneerde Task<TResult> object voltooid zodra er een antwoord beschikbaar is of het volledige antwoord inclusief inhoud wordt 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.
Deze methode slaat op in de taak die alle uitzonderingen voor niet-gebruik retourneert die de synchrone tegenhanger van de methode kan genereren. Als er een uitzondering wordt opgeslagen in de geretourneerde taak, wordt deze uitzondering gegenereerd wanneer de taak wordt gewacht. Gebruiksonderzondering, zoals ArgumentException, worden nog steeds synchroon gegenereerd. Zie de uitzonderingen die zijn gegenereerd door Send(HttpRequestMessage, HttpCompletionOption)de opgeslagen uitzonderingen voor de opgeslagen uitzonderingen.
Van toepassing op
SendAsync(HttpRequestMessage, CancellationToken)
Verzend een HTTP-aanvraag als asynchrone bewerking.
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)Parameters
- request
- HttpRequestMessage
Het HTTP-aanvraagbericht dat moet worden verzonden.
- cancellationToken
- CancellationToken
Het annuleringstoken om de bewerking te annuleren.
Retouren
Het taakobject dat de asynchrone bewerking vertegenwoordigt.
Uitzonderingen
De request is null.
Het aanvraagbericht is al verzonden door het HttpClient exemplaar.
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 zodra het volledige antwoord inclusief inhoud wordt gelezen. Het gedrag is hetzelfde als als dat ResponseContentRead expliciet is opgegeven.
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.
Deze methode slaat op in de taak die alle uitzonderingen voor niet-gebruik retourneert die de synchrone tegenhanger van de methode kan genereren. Als er een uitzondering wordt opgeslagen in de geretourneerde taak, wordt deze uitzondering gegenereerd wanneer de taak wordt gewacht. Gebruiksonderzondering, zoals ArgumentException, worden nog steeds synchroon gegenereerd. Zie de uitzonderingen die zijn gegenereerd door Send(HttpRequestMessage)de opgeslagen uitzonderingen voor de opgeslagen uitzonderingen.