HttpClient.GetAsync Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Senden Sie eine GET-Anforderung als asynchronen Vorgang an den angegebenen URI.
Überlädt
| Name | Beschreibung |
|---|---|
| GetAsync(String) |
Senden Sie eine GET-Anforderung als asynchronen Vorgang an den angegebenen URI. |
| GetAsync(Uri) |
Senden Sie eine GET-Anforderung als asynchronen Vorgang an den angegebenen URI. |
| GetAsync(String, HttpCompletionOption) |
Senden Sie eine GET-Anforderung an den angegebenen URI mit einer HTTP-Abschlussoption als asynchronen Vorgang. |
| GetAsync(String, CancellationToken) |
Senden Sie eine GET-Anforderung an den angegebenen URI mit einem Abbruchtoken als asynchronen Vorgang. |
| GetAsync(Uri, HttpCompletionOption) |
Senden Sie eine GET-Anforderung an den angegebenen URI mit einer HTTP-Abschlussoption als asynchronen Vorgang. |
| GetAsync(Uri, CancellationToken) |
Senden Sie eine GET-Anforderung an den angegebenen URI mit einem Abbruchtoken als asynchronen Vorgang. |
| GetAsync(String, HttpCompletionOption, CancellationToken) |
Senden Sie eine GET-Anforderung an den angegebenen URI mit einer HTTP-Abschlussoption und einem Abbruchtoken als asynchronen Vorgang. |
| GetAsync(Uri, HttpCompletionOption, CancellationToken) |
Senden Sie eine GET-Anforderung an den angegebenen URI mit einer HTTP-Abschlussoption und einem Abbruchtoken als asynchronen Vorgang. |
Hinweise
Der Vorgang wird nicht blockiert.
GetAsync(String)
Senden Sie eine GET-Anforderung als asynchronen Vorgang an den angegebenen URI.
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)Parameter
- requestUri
- String
Der URI, an den die Anforderung gesendet wird.
Gibt zurück
Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.
Ausnahmen
Dies requestUri ist kein absoluter URI und BaseAddress wird nicht festgelegt.
Fehler bei der Anforderung aufgrund eines Problems beim Abrufen einer gültigen HTTP-Antwort, z. B. Netzwerkverbindungsfehler, DNS-Fehler, Serverzertifikatüberprüfungsfehler oder ungültiger Serverantwort. Auf .NET 8 und neueren Versionen wird der Grund durch HttpRequestError
-oder-
.NET Framework: Timeout der Anforderung.
.NET Core und .NET 5 und höher: Die Anforderung ist aufgrund eines Timeouts fehlgeschlagen.
Der bereitgestellte Anforderungs-URI ist kein gültiger relativer oder absoluter URI.
Hinweise
Dieser Vorgang blockiert nicht. Das zurückgegebene Task<TResult> Objekt wird abgeschlossen, nachdem die gesamte Antwort (einschließlich Inhalt) gelesen wurde. Das Verhalten ist identisch mit dem, wenn ResponseContentRead explizit angegeben wurde.
Note
Bei Timeout werden unterschiedliche Ausnahmen für verschiedene .NET Implementierungen ausgelöst.
- HttpRequestException wird für alle anwendbaren .NET Framework-Versionen ausgelöst.
- OperationCanceledException ohne innere Ausnahme wird für alle anwendbaren .NET Core-Versionen ausgelöst.
- OperationCanceledException, die eine TimeoutException verschachtelt, wird auf .NET 5 und höher ausgelöst.
Gilt für:
GetAsync(Uri)
Senden Sie eine GET-Anforderung als asynchronen Vorgang an den angegebenen URI.
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)Parameter
- requestUri
- Uri
Der URI, an den die Anforderung gesendet wird.
Gibt zurück
Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.
Ausnahmen
Dies requestUri ist kein absoluter URI und BaseAddress wird nicht festgelegt.
Fehler bei der Anforderung aufgrund eines Problems beim Abrufen einer gültigen HTTP-Antwort, z. B. Netzwerkverbindungsfehler, DNS-Fehler, Serverzertifikatüberprüfungsfehler oder ungültiger Serverantwort. Auf .NET 8 und neueren Versionen wird der Grund durch HttpRequestError
-oder-
.NET Framework: Timeout der Anforderung.
.NET Core und .NET 5 und höher: Die Anforderung ist aufgrund eines Timeouts fehlgeschlagen.
Hinweise
Dieser Vorgang blockiert nicht. Das zurückgegebene Task<TResult> Objekt wird abgeschlossen, nachdem die gesamte Antwort (einschließlich Inhalt) gelesen wurde. Das Verhalten ist identisch mit dem, wenn ResponseContentRead explizit angegeben wurde.
Note
Bei Timeout werden unterschiedliche Ausnahmen für verschiedene .NET Implementierungen ausgelöst.
- HttpRequestException wird für alle anwendbaren .NET Framework-Versionen ausgelöst.
- OperationCanceledException ohne innere Ausnahme wird für alle anwendbaren .NET Core-Versionen ausgelöst.
- OperationCanceledException, die eine TimeoutException verschachtelt, wird auf .NET 5 und höher ausgelöst.
Gilt für:
GetAsync(String, HttpCompletionOption)
Senden Sie eine GET-Anforderung an den angegebenen URI mit einer HTTP-Abschlussoption als asynchronen Vorgang.
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)Parameter
- requestUri
- String
Der URI, an den die Anforderung gesendet wird.
- completionOption
- HttpCompletionOption
Ein HTTP-Abschlussoptionswert, der angibt, wann der Vorgang als abgeschlossen betrachtet werden soll.
Gibt zurück
Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.
Ausnahmen
Dies requestUri ist kein absoluter URI und BaseAddress wird nicht festgelegt.
Fehler bei der Anforderung aufgrund eines zugrunde liegenden Problems wie Netzwerkkonnektivität, DNS-Fehler, Serverzertifikatüberprüfung oder Timeout.
.NET Core und .NET 5 und höher: Die Anforderung ist aufgrund eines Timeouts fehlgeschlagen.
Der bereitgestellte Anforderungs-URI ist kein gültiger relativer oder absoluter URI.
Hinweise
Dieser Vorgang blockiert nicht. Das zurückgegebene Task<TResult> Objekt wird basierend auf dem completionOption Parameter abgeschlossen, nachdem der Teil oder alle Antworten (einschließlich Inhalt) gelesen wurden.
Note
Bei Timeout werden unterschiedliche Ausnahmen für verschiedene .NET Implementierungen ausgelöst.
- HttpRequestException wird für alle anwendbaren .NET Framework-Versionen ausgelöst.
- OperationCanceledException ohne innere Ausnahme wird für alle anwendbaren .NET Core-Versionen ausgelöst.
- OperationCanceledException, die eine TimeoutException verschachtelt, wird auf .NET 5 und höher ausgelöst.
Gilt für:
GetAsync(String, CancellationToken)
Senden Sie eine GET-Anforderung an den angegebenen URI mit einem Abbruchtoken als asynchronen Vorgang.
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)Parameter
- requestUri
- String
Der URI, an den die Anforderung gesendet wird.
- cancellationToken
- CancellationToken
Ein Abbruchtoken, das von anderen Objekten oder Threads verwendet werden kann, um eine Kündigungsbenachrichtigung zu erhalten.
Gibt zurück
Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.
Ausnahmen
Dies requestUri ist kein absoluter URI und BaseAddress wird nicht festgelegt.
Fehler bei der Anforderung aufgrund eines Problems beim Abrufen einer gültigen HTTP-Antwort, z. B. Netzwerkverbindungsfehler, DNS-Fehler, Serverzertifikatüberprüfungsfehler oder ungültiger Serverantwort. Auf .NET 8 und neueren Versionen wird der Grund durch HttpRequestError
-oder-
.NET Framework: Timeout der Anforderung.
Der bereitgestellte Anforderungs-URI ist kein gültiger relativer oder absoluter URI.
Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.
-oder-
.NET Core und .NET 5 und höher: Die Anforderung ist aufgrund eines Timeouts fehlgeschlagen.
Hinweise
Dieser Vorgang blockiert nicht. Das zurückgegebene Task<TResult> Objekt wird abgeschlossen, nachdem die gesamte Antwort (einschließlich Inhalt) gelesen wurde. Das Verhalten ist identisch mit dem, wenn ResponseContentRead explizit angegeben wurde.
Note
Bei Timeout werden unterschiedliche Ausnahmen für verschiedene .NET Implementierungen ausgelöst.
- HttpRequestException wird für alle anwendbaren .NET Framework-Versionen ausgelöst.
- OperationCanceledException ohne innere Ausnahme wird für alle anwendbaren .NET Core-Versionen ausgelöst.
- OperationCanceledException, die eine TimeoutException verschachtelt, wird auf .NET 5 und höher ausgelöst.
Gilt für:
GetAsync(Uri, HttpCompletionOption)
Senden Sie eine GET-Anforderung an den angegebenen URI mit einer HTTP-Abschlussoption als asynchronen Vorgang.
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)Parameter
- requestUri
- Uri
Der URI, an den die Anforderung gesendet wird.
- completionOption
- HttpCompletionOption
Ein HTTP-Abschlussoptionswert, der angibt, wann der Vorgang als abgeschlossen betrachtet werden soll.
Gibt zurück
Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.
Ausnahmen
Dies requestUri ist kein absoluter URI und BaseAddress wird nicht festgelegt.
Fehler bei der Anforderung aufgrund eines Problems beim Abrufen einer gültigen HTTP-Antwort, z. B. Netzwerkverbindungsfehler, DNS-Fehler, Serverzertifikatüberprüfungsfehler oder ungültiger Serverantwort. Auf .NET 8 und neueren Versionen wird der Grund durch HttpRequestError
-oder-
.NET Framework: Timeout der Anforderung.
.NET Core und .NET 5 und höher: Die Anforderung ist aufgrund eines Timeouts fehlgeschlagen.
Hinweise
Dieser Vorgang blockiert nicht. Das zurückgegebene Task<TResult> Objekt wird basierend auf dem completionOption Parameter abgeschlossen, nachdem der Teil oder alle Antworten (einschließlich Inhalt) gelesen wurden.
Note
Bei Timeout werden unterschiedliche Ausnahmen für verschiedene .NET Implementierungen ausgelöst.
- HttpRequestException wird für alle anwendbaren .NET Framework-Versionen ausgelöst.
- OperationCanceledException ohne innere Ausnahme wird für alle anwendbaren .NET Core-Versionen ausgelöst.
- OperationCanceledException, die eine TimeoutException verschachtelt, wird auf .NET 5 und höher ausgelöst.
Gilt für:
GetAsync(Uri, CancellationToken)
Senden Sie eine GET-Anforderung an den angegebenen URI mit einem Abbruchtoken als asynchronen Vorgang.
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)Parameter
- requestUri
- Uri
Der URI, an den die Anforderung gesendet wird.
- cancellationToken
- CancellationToken
Ein Abbruchtoken, das von anderen Objekten oder Threads verwendet werden kann, um eine Kündigungsbenachrichtigung zu erhalten.
Gibt zurück
Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.
Ausnahmen
Dies requestUri ist kein absoluter URI und BaseAddress wird nicht festgelegt.
Fehler bei der Anforderung aufgrund eines Problems beim Abrufen einer HTTP-Antwort wie Netzwerkkonnektivität, DNS-Fehler oder Serverzertifikatüberprüfung. Auf .NET 8 und neueren Versionen wird der Grund durch HttpRequestError
-oder-
.NET Framework: Timeout der Anforderung.
Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.
-oder-
.NET Core und .NET 5 und höher: Die Anforderung ist aufgrund eines Timeouts fehlgeschlagen.
Hinweise
Dieser Vorgang blockiert nicht. Das zurückgegebene Task<TResult> Objekt wird abgeschlossen, nachdem die gesamte Antwort (einschließlich Inhalt) gelesen wurde. Das Verhalten ist identisch mit dem, wenn ResponseContentRead explizit angegeben wurde.
Note
Bei Timeout werden unterschiedliche Ausnahmen für verschiedene .NET Implementierungen ausgelöst.
- HttpRequestException wird für alle anwendbaren .NET Framework-Versionen ausgelöst.
- OperationCanceledException ohne innere Ausnahme wird für alle anwendbaren .NET Core-Versionen ausgelöst.
- OperationCanceledException, die eine TimeoutException verschachtelt, wird auf .NET 5 und höher ausgelöst.
Gilt für:
GetAsync(String, HttpCompletionOption, CancellationToken)
Senden Sie eine GET-Anforderung an den angegebenen URI mit einer HTTP-Abschlussoption und einem Abbruchtoken als asynchronen Vorgang.
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)Parameter
- requestUri
- String
Der URI, an den die Anforderung gesendet wird.
- completionOption
- HttpCompletionOption
Ein HTTP-Abschlussoptionswert, der angibt, wann der Vorgang als abgeschlossen betrachtet werden soll.
- cancellationToken
- CancellationToken
Ein Abbruchtoken, das von anderen Objekten oder Threads verwendet werden kann, um eine Kündigungsbenachrichtigung zu erhalten.
Gibt zurück
Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.
Ausnahmen
Dies requestUri ist kein absoluter URI und BaseAddress wird nicht festgelegt.
Fehler bei der Anforderung aufgrund eines Problems beim Abrufen einer gültigen HTTP-Antwort, z. B. Netzwerkverbindungsfehler, DNS-Fehler, Serverzertifikatüberprüfungsfehler oder ungültiger Serverantwort. Auf .NET 8 und neueren Versionen wird der Grund durch HttpRequestError
-oder-
.NET Framework: Timeout der Anforderung.
Der bereitgestellte Anforderungs-URI ist kein gültiger relativer oder absoluter URI.
Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.
-oder-
.NET Core und .NET 5 und höher: Die Anforderung ist aufgrund eines Timeouts fehlgeschlagen.
Hinweise
Dieser Vorgang blockiert nicht. Das zurückgegebene Task<TResult> Objekt wird basierend auf dem completionOption Parameter abgeschlossen, nachdem der Teil oder alle Antworten (einschließlich Inhalt) gelesen wurden.
Note
Bei Timeout werden unterschiedliche Ausnahmen für verschiedene .NET Implementierungen ausgelöst.
- HttpRequestException wird für alle anwendbaren .NET Framework-Versionen ausgelöst.
- OperationCanceledException ohne innere Ausnahme wird für alle anwendbaren .NET Core-Versionen ausgelöst.
- OperationCanceledException, die eine TimeoutException verschachtelt, wird auf .NET 5 und höher ausgelöst.
Gilt für:
GetAsync(Uri, HttpCompletionOption, CancellationToken)
Senden Sie eine GET-Anforderung an den angegebenen URI mit einer HTTP-Abschlussoption und einem Abbruchtoken als asynchronen Vorgang.
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)Parameter
- requestUri
- Uri
Der URI, an den die Anforderung gesendet wird.
- completionOption
- HttpCompletionOption
Ein HTTP-Abschlussoptionswert, der angibt, wann der Vorgang als abgeschlossen betrachtet werden soll.
- cancellationToken
- CancellationToken
Ein Abbruchtoken, das von anderen Objekten oder Threads verwendet werden kann, um eine Kündigungsbenachrichtigung zu erhalten.
Gibt zurück
Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.
Ausnahmen
Dies requestUri ist kein absoluter URI und BaseAddress wird nicht festgelegt.
Fehler bei der Anforderung aufgrund eines Problems beim Abrufen einer gültigen HTTP-Antwort, z. B. Netzwerkverbindungsfehler, DNS-Fehler, Serverzertifikatüberprüfungsfehler oder ungültiger Serverantwort. Auf .NET 8 und neueren Versionen wird der Grund durch HttpRequestError
-oder-
.NET Framework: Timeout der Anforderung.
Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.
-oder-
.NET Core und .NET 5 und höher: Die Anforderung ist aufgrund eines Timeouts fehlgeschlagen.
Hinweise
Dieser Vorgang blockiert nicht. Das zurückgegebene Task<TResult> Objekt wird basierend auf dem completionOption Parameter abgeschlossen, nachdem der Teil oder alle Antworten (einschließlich Inhalt) gelesen wurden.
Note
Bei Timeout werden unterschiedliche Ausnahmen für verschiedene .NET Implementierungen ausgelöst.
- HttpRequestException wird für alle anwendbaren .NET Framework-Versionen ausgelöst.
- OperationCanceledException ohne innere Ausnahme wird für alle anwendbaren .NET Core-Versionen ausgelöst.
- OperationCanceledException, die eine TimeoutException verschachtelt, wird auf .NET 5 und höher ausgelöst.