HttpClient.GetAsync 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 GET-aanvraag naar de opgegeven URI als asynchrone bewerking.
Overloads
| Name | Description |
|---|---|
| GetAsync(String) |
Verzend een GET-aanvraag naar de opgegeven URI als asynchrone bewerking. |
| GetAsync(Uri) |
Verzend een GET-aanvraag naar de opgegeven URI als asynchrone bewerking. |
| GetAsync(String, HttpCompletionOption) |
Verzend een GET-aanvraag naar de opgegeven URI met een HTTP-voltooiingsoptie als asynchrone bewerking. |
| GetAsync(String, CancellationToken) |
Verzend een GET-aanvraag naar de opgegeven URI met een annuleringstoken als asynchrone bewerking. |
| GetAsync(Uri, HttpCompletionOption) |
Verzend een GET-aanvraag naar de opgegeven URI met een HTTP-voltooiingsoptie als asynchrone bewerking. |
| GetAsync(Uri, CancellationToken) |
Verzend een GET-aanvraag naar de opgegeven URI met een annuleringstoken als asynchrone bewerking. |
| GetAsync(String, HttpCompletionOption, CancellationToken) |
Verzend een GET-aanvraag naar de opgegeven URI met een HTTP-voltooiingsoptie en een annuleringstoken als asynchrone bewerking. |
| GetAsync(Uri, HttpCompletionOption, CancellationToken) |
Verzend een GET-aanvraag naar de opgegeven URI met een HTTP-voltooiingsoptie en een annuleringstoken als asynchrone bewerking. |
Opmerkingen
De bewerking wordt niet geblokkeerd.
GetAsync(String)
Verzend een GET-aanvraag naar de opgegeven URI als asynchrone bewerking.
public:
System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ GetAsync(System::String ^ requestUri);public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync(string requestUri);member this.GetAsync : string -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>Public Function GetAsync (requestUri As String) As Task(Of HttpResponseMessage)Parameters
- requestUri
- String
De URI waar de aanvraag naar wordt 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. 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.
Van toepassing op
GetAsync(Uri)
Verzend een GET-aanvraag naar de opgegeven URI als asynchrone bewerking.
public:
System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ GetAsync(Uri ^ requestUri);public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync(Uri requestUri);member this.GetAsync : Uri -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>Public Function GetAsync (requestUri As Uri) As Task(Of HttpResponseMessage)Parameters
- requestUri
- Uri
De URI waar de aanvraag naar wordt 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. 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.
Van toepassing op
GetAsync(String, HttpCompletionOption)
Verzend een GET-aanvraag naar de opgegeven URI met een HTTP-voltooiingsoptie als asynchrone bewerking.
public:
System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ GetAsync(System::String ^ requestUri, System::Net::Http::HttpCompletionOption completionOption);public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync(string requestUri, System.Net.Http.HttpCompletionOption completionOption);member this.GetAsync : string * System.Net.Http.HttpCompletionOption -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>Public Function GetAsync (requestUri As String, completionOption As HttpCompletionOption) As Task(Of HttpResponseMessage)Parameters
- requestUri
- String
De URI waar de aanvraag naar wordt verzonden.
- completionOption
- HttpCompletionOption
Een http-voltooiingsoptiewaarde die aangeeft wanneer de bewerking moet worden beschouwd als voltooid.
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 onderliggend probleem, zoals netwerkverbinding, DNS-fout, validatie van servercertificaat of time-out.
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 op basis van de completionOption parameter nadat het deel of alle antwoorden (inclusief inhoud) zijn 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
GetAsync(String, CancellationToken)
Verzend een GET-aanvraag naar de opgegeven URI met een annuleringstoken als asynchrone bewerking.
public:
System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ GetAsync(System::String ^ requestUri, System::Threading::CancellationToken cancellationToken);public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync(string requestUri, System.Threading.CancellationToken cancellationToken);member this.GetAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>Public Function GetAsync (requestUri As String, cancellationToken As CancellationToken) As Task(Of HttpResponseMessage)Parameters
- requestUri
- String
De URI waar de aanvraag naar wordt 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. 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.
Van toepassing op
GetAsync(Uri, HttpCompletionOption)
Verzend een GET-aanvraag naar de opgegeven URI met een HTTP-voltooiingsoptie als asynchrone bewerking.
public:
System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ GetAsync(Uri ^ requestUri, System::Net::Http::HttpCompletionOption completionOption);public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync(Uri requestUri, System.Net.Http.HttpCompletionOption completionOption);member this.GetAsync : Uri * System.Net.Http.HttpCompletionOption -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>Public Function GetAsync (requestUri As Uri, completionOption As HttpCompletionOption) As Task(Of HttpResponseMessage)Parameters
- requestUri
- Uri
De URI waar de aanvraag naar wordt verzonden.
- completionOption
- HttpCompletionOption
Een http-voltooiingsoptiewaarde die aangeeft wanneer de bewerking moet worden beschouwd als voltooid.
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 op basis van de completionOption parameter nadat het deel of alle antwoorden (inclusief inhoud) zijn 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
GetAsync(Uri, CancellationToken)
Verzend een GET-aanvraag naar de opgegeven URI met een annuleringstoken als asynchrone bewerking.
public:
System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ GetAsync(Uri ^ requestUri, System::Threading::CancellationToken cancellationToken);public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync(Uri requestUri, System.Threading.CancellationToken cancellationToken);member this.GetAsync : Uri * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>Public Function GetAsync (requestUri As Uri, cancellationToken As CancellationToken) As Task(Of HttpResponseMessage)Parameters
- requestUri
- Uri
De URI waar de aanvraag naar wordt 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.
TDe aanvraag is mislukt vanwege een probleem met het ophalen van een HTTP-antwoord, zoals netwerkconnectiviteit, DNS-fout of servercertificaatvalidatie. 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. 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.
Van toepassing op
GetAsync(String, HttpCompletionOption, CancellationToken)
Verzend een GET-aanvraag naar de opgegeven URI met een HTTP-voltooiingsoptie en een annuleringstoken als asynchrone bewerking.
public:
System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ GetAsync(System::String ^ requestUri, System::Net::Http::HttpCompletionOption completionOption, System::Threading::CancellationToken cancellationToken);public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync(string requestUri, System.Net.Http.HttpCompletionOption completionOption, System.Threading.CancellationToken cancellationToken);member this.GetAsync : string * System.Net.Http.HttpCompletionOption * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>Public Function GetAsync (requestUri As String, completionOption As HttpCompletionOption, cancellationToken As CancellationToken) As Task(Of HttpResponseMessage)Parameters
- requestUri
- String
De URI waar de aanvraag naar wordt verzonden.
- completionOption
- HttpCompletionOption
Een http-voltooiingsoptiewaarde die aangeeft wanneer de bewerking moet worden beschouwd als voltooid.
- 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 op basis van de completionOption parameter nadat het deel of alle antwoorden (inclusief inhoud) zijn 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
GetAsync(Uri, HttpCompletionOption, CancellationToken)
Verzend een GET-aanvraag naar de opgegeven URI met een HTTP-voltooiingsoptie en een annuleringstoken als asynchrone bewerking.
public:
System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ GetAsync(Uri ^ requestUri, System::Net::Http::HttpCompletionOption completionOption, System::Threading::CancellationToken cancellationToken);public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync(Uri requestUri, System.Net.Http.HttpCompletionOption completionOption, System.Threading.CancellationToken cancellationToken);member this.GetAsync : Uri * System.Net.Http.HttpCompletionOption * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>Public Function GetAsync (requestUri As Uri, completionOption As HttpCompletionOption, cancellationToken As CancellationToken) As Task(Of HttpResponseMessage)Parameters
- requestUri
- Uri
De URI waar de aanvraag naar wordt verzonden.
- completionOption
- HttpCompletionOption
Een http-voltooiingsoptiewaarde die aangeeft wanneer de bewerking moet worden beschouwd als voltooid.
- 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 op basis van de completionOption parameter nadat het deel of alle antwoorden (inclusief inhoud) zijn 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.