HttpClient.GetAsync Methode

Referenz

Definition

Namespace:: System.Net.Http

Assembly:: System.Net.Http.dll

Assembly:: netstandard.dll

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.

Eine GET-Anforderung an den angegebenen URI als asynchronen Vorgang senden.

Überlädt

GetAsync(String)	Eine GET-Anforderung an den angegebenen URI als asynchronen Vorgang senden.
GetAsync(Uri)	Eine GET-Anforderung an den angegebenen URI als asynchronen Vorgang senden.
GetAsync(String, HttpCompletionOption)	Eine GET-Anforderung an den angegebenen URI mit einer HTTP-Abschlussoption als asynchronen Vorgang senden.
GetAsync(String, CancellationToken)	Eine GET-Anforderung für den angegebenen URI mit einem Abbruchtoken als asynchronen Vorgang senden.
GetAsync(Uri, HttpCompletionOption)	Eine GET-Anforderung an den angegebenen URI mit einer HTTP-Abschlussoption als asynchronen Vorgang senden.
GetAsync(Uri, CancellationToken)	Eine GET-Anforderung für den angegebenen URI mit einem Abbruchtoken als asynchronen Vorgang senden.
GetAsync(String, HttpCompletionOption, CancellationToken)	Eine GET-Anforderung an den angegebenen URI mit einer HTTP-Abschlussoption und einem Abbruchtoken als asynchronen Vorgang senden.
GetAsync(Uri, HttpCompletionOption, CancellationToken)	Eine GET-Anforderung an den angegebenen URI mit einer HTTP-Abschlussoption und einem Abbruchtoken als asynchronen Vorgang senden.

Hinweise

Der Vorgang wird nicht blockiert.

GetAsync(String)

Quelle:: HttpClient.cs

Quelle:: HttpClient.cs

Quelle:: HttpClient.cs

Eine GET-Anforderung an den angegebenen URI als asynchronen Vorgang senden.

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);

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

Task<HttpResponseMessage>

Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.

Ausnahmen

InvalidOperationException

Der requestUri muss ein absoluter URI sein, oder BaseAddress muss festgelegt werden.

HttpRequestException

Die Anforderung konnte wg. eines zugrunde liegenden Problems wie Netzwerkkonnektivität, DNS-Fehler, Überprüfung des Serverzertifikats oder Timeout nicht durchgeführt werden.

TaskCanceledException

Nur .NET Core und .NET 5 und höher: Fehler bei der Anforderung aufgrund eines Timeouts.

UriFormatException

Der bereitgestellte Anforderungs-URI ist kein gültiger relativer oder absoluter URI.

Hinweise

Dieser Vorgang wird nicht blockiert. 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.

Hinweis

Im Falle eines Timeouts werden verschiedene Ausnahmen für verschiedene .NET-Implementierungen ausgelöst.

HttpRequestExceptionwird für alle anwendbaren .NET Framework Versionen ausgelöst.
TaskCanceledException ohne innere Ausnahme wird für alle anwendbaren .NET Core-Versionen ausgelöst.
TaskCanceledException , das einen TimeoutException verschachtelt, wird in .NET 5 und höheren Versionen ausgelöst.

Gilt für:

GetAsync(Uri)

Quelle:: HttpClient.cs

Quelle:: HttpClient.cs

Quelle:: HttpClient.cs

Eine GET-Anforderung an den angegebenen URI als asynchronen Vorgang senden.

public:
 System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ GetAsync(Uri ^ requestUri);

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

Task<HttpResponseMessage>

Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.

Ausnahmen

InvalidOperationException

Der requestUri muss ein absoluter URI sein, oder BaseAddress muss festgelegt werden.

HttpRequestException

Die Anforderung konnte wg. eines zugrunde liegenden Problems wie Netzwerkkonnektivität, DNS-Fehler, Überprüfung des Serverzertifikats oder Timeout nicht durchgeführt werden.

TaskCanceledException

Nur .NET Core und .NET 5 und höher: Fehler bei der Anforderung aufgrund eines Timeouts.

Hinweise

Hinweis

Im Falle eines Timeouts werden verschiedene Ausnahmen für verschiedene .NET-Implementierungen ausgelöst.

HttpRequestExceptionwird für alle anwendbaren .NET Framework Versionen ausgelöst.
TaskCanceledException ohne innere Ausnahme wird für alle anwendbaren .NET Core-Versionen ausgelöst.
TaskCanceledException , das einen TimeoutException verschachtelt, wird in .NET 5 und höheren Versionen ausgelöst.

Gilt für:

GetAsync(String, HttpCompletionOption)

Quelle:: HttpClient.cs

Quelle:: HttpClient.cs

Quelle:: HttpClient.cs

Eine GET-Anforderung an den angegebenen URI mit einer HTTP-Abschlussoption als asynchronen Vorgang senden.

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);

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-Abschlussoptions-Wert, der angibt, wann die Operation als abgeschlossen betrachtet werden soll.

Gibt zurück

Task<HttpResponseMessage>

Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.

Ausnahmen

InvalidOperationException

Der requestUri muss ein absoluter URI sein, oder BaseAddress muss festgelegt werden.

HttpRequestException

Die Anforderung konnte wg. eines zugrunde liegenden Problems wie Netzwerkkonnektivität, DNS-Fehler, Überprüfung des Serverzertifikats oder Timeout nicht durchgeführt werden.

TaskCanceledException

Nur .NET Core und .NET 5 und höher: Fehler bei der Anforderung aufgrund eines Timeouts.

UriFormatException

Der bereitgestellte Anforderungs-URI ist kein gültiger relativer oder absoluter URI.

Hinweise

Dieser Vorgang wird nicht blockiert. Das zurückgegebene Task<TResult> Objekt wird basierend auf dem completionOption Parameter abgeschlossen, nachdem der Teil oder die gesamte Antwort (einschließlich Inhalt) gelesen wurde.

Hinweis

Im Falle eines Timeouts werden verschiedene Ausnahmen für verschiedene .NET-Implementierungen ausgelöst.

HttpRequestExceptionwird für alle anwendbaren .NET Framework Versionen ausgelöst.
TaskCanceledException ohne innere Ausnahme wird für alle anwendbaren .NET Core-Versionen ausgelöst.
TaskCanceledException , das einen TimeoutException verschachtelt, wird in .NET 5 und höheren Versionen ausgelöst.

Gilt für:

GetAsync(String, CancellationToken)

Quelle:: HttpClient.cs

Quelle:: HttpClient.cs

Quelle:: HttpClient.cs

Eine GET-Anforderung für den angegebenen URI mit einem Abbruchtoken als asynchronen Vorgang senden.

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);

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 Nachricht vom Abbruch zu empfangen.

Gibt zurück

Task<HttpResponseMessage>

Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.

Ausnahmen

InvalidOperationException

Der requestUri muss ein absoluter URI sein, oder BaseAddress muss festgelegt werden.

HttpRequestException

Die Anforderung konnte wg. eines zugrunde liegenden Problems wie Netzwerkkonnektivität, DNS-Fehler, Überprüfung des Serverzertifikats oder Timeout nicht durchgeführt werden.

TaskCanceledException

Nur .NET Core und .NET 5 und höher: Fehler bei der Anforderung aufgrund eines Timeouts.

UriFormatException

Der bereitgestellte Anforderungs-URI ist kein gültiger relativer oder absoluter URI.

OperationCanceledException

Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.

Hinweise

Hinweis

Im Falle eines Timeouts werden verschiedene Ausnahmen für verschiedene .NET-Implementierungen ausgelöst.

HttpRequestExceptionwird für alle anwendbaren .NET Framework Versionen ausgelöst.
TaskCanceledException ohne innere Ausnahme wird für alle anwendbaren .NET Core-Versionen ausgelöst.
TaskCanceledException , das einen TimeoutException verschachtelt, wird in .NET 5 und höheren Versionen ausgelöst.

Gilt für:

GetAsync(Uri, HttpCompletionOption)

Quelle:: HttpClient.cs

Quelle:: HttpClient.cs

Quelle:: HttpClient.cs

Eine GET-Anforderung an den angegebenen URI mit einer HTTP-Abschlussoption als asynchronen Vorgang senden.

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);

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-Abschlussoptions-Wert, der angibt, wann die Operation als abgeschlossen betrachtet werden soll.

Gibt zurück

Task<HttpResponseMessage>

Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.

Ausnahmen

InvalidOperationException

Der requestUri muss ein absoluter URI sein, oder BaseAddress muss festgelegt werden.

HttpRequestException

Die Anforderung konnte wg. eines zugrunde liegenden Problems wie Netzwerkkonnektivität, DNS-Fehler, Überprüfung des Serverzertifikats oder Timeout nicht durchgeführt werden.

TaskCanceledException

Nur .NET Core und .NET 5 und höher: Fehler bei der Anforderung aufgrund eines Timeouts.

Hinweise

Hinweis

Im Falle eines Timeouts werden verschiedene Ausnahmen für verschiedene .NET-Implementierungen ausgelöst.

HttpRequestExceptionwird für alle anwendbaren .NET Framework Versionen ausgelöst.
TaskCanceledException ohne innere Ausnahme wird für alle anwendbaren .NET Core-Versionen ausgelöst.
TaskCanceledException , das einen TimeoutException verschachtelt, wird in .NET 5 und höheren Versionen ausgelöst.

Gilt für:

GetAsync(Uri, CancellationToken)

Quelle:: HttpClient.cs

Quelle:: HttpClient.cs

Quelle:: HttpClient.cs

Eine GET-Anforderung für den angegebenen URI mit einem Abbruchtoken als asynchronen Vorgang senden.

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);

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 Nachricht vom Abbruch zu empfangen.

Gibt zurück

Task<HttpResponseMessage>

Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.

Ausnahmen

InvalidOperationException

Der requestUri muss ein absoluter URI sein, oder BaseAddress muss festgelegt werden.

HttpRequestException

Die Anforderung konnte wg. eines zugrunde liegenden Problems wie Netzwerkkonnektivität, DNS-Fehler, Überprüfung des Serverzertifikats oder Timeout nicht durchgeführt werden.

TaskCanceledException

Nur .NET Core und .NET 5 und höher: Fehler bei der Anforderung aufgrund eines Timeouts.

OperationCanceledException

Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.

Hinweise

Dieser Vorgang wird nicht blockiert. Das zurückgegebene Task<TResult> Objekt wird abgeschlossen, nachdem die gesamte Antwort (einschließlich des Inhalts) gelesen wurde. Das Verhalten ist identisch mit dem, wenn ResponseContentRead explizit angegeben wurde.

Hinweis

Im Falle eines Timeouts werden unterschiedliche Ausnahmen für verschiedene .NET-Implementierungen ausgelöst.

HttpRequestExceptionwird für alle anwendbaren .NET Framework Versionen ausgelöst.
TaskCanceledException ohne eine innere Ausnahme wird für alle anwendbaren .NET Core-Versionen ausgelöst.
TaskCanceledException , der ein schachtelt, TimeoutException wird unter .NET 5 und höheren Versionen ausgelöst.

Gilt für:

GetAsync(String, HttpCompletionOption, CancellationToken)

Quelle:: HttpClient.cs

Quelle:: HttpClient.cs

Quelle:: HttpClient.cs

Eine GET-Anforderung an den angegebenen URI mit einer HTTP-Abschlussoption und einem Abbruchtoken als asynchronen Vorgang senden.

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);

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-Abschlussoptions-Wert, der angibt, wann die Operation als abgeschlossen betrachtet werden soll.

cancellationToken: CancellationToken

Ein Abbruchtoken, das von anderen Objekten oder Threads verwendet werden kann, um Nachricht vom Abbruch zu empfangen.

Gibt zurück

Task<HttpResponseMessage>

Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.

Ausnahmen

InvalidOperationException

Der requestUri muss ein absoluter URI sein, oder BaseAddress muss festgelegt werden.

HttpRequestException

Die Anforderung konnte wg. eines zugrunde liegenden Problems wie Netzwerkkonnektivität, DNS-Fehler, Überprüfung des Serverzertifikats oder Timeout nicht durchgeführt werden.

TaskCanceledException

Nur .NET Core und .NET 5 und höher: Fehler bei der Anforderung aufgrund eines Timeouts.

UriFormatException

Der angegebene Anforderungs-URI ist kein gültiger relativer oder absoluter URI.

OperationCanceledException

Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.

Hinweise

Hinweis

Im Falle eines Timeouts werden unterschiedliche Ausnahmen für verschiedene .NET-Implementierungen ausgelöst.

HttpRequestExceptionwird für alle anwendbaren .NET Framework Versionen ausgelöst.
TaskCanceledException ohne eine innere Ausnahme wird für alle anwendbaren .NET Core-Versionen ausgelöst.
TaskCanceledException , der ein schachtelt, TimeoutException wird unter .NET 5 und höheren Versionen ausgelöst.

Gilt für:

GetAsync(Uri, HttpCompletionOption, CancellationToken)

Quelle:: HttpClient.cs

Quelle:: HttpClient.cs

Quelle:: HttpClient.cs

Eine GET-Anforderung an den angegebenen URI mit einer HTTP-Abschlussoption und einem Abbruchtoken als asynchronen Vorgang senden.

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);

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-Abschlussoptions-Wert, der angibt, wann die Operation als abgeschlossen betrachtet werden soll.

cancellationToken: CancellationToken

Ein Abbruchtoken, das von anderen Objekten oder Threads verwendet werden kann, um Nachricht vom Abbruch zu empfangen.

Gibt zurück

Task<HttpResponseMessage>

Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.

Ausnahmen

InvalidOperationException

Der requestUri muss ein absoluter URI sein, oder BaseAddress muss festgelegt werden.

HttpRequestException

Die Anforderung konnte wg. eines zugrunde liegenden Problems wie Netzwerkkonnektivität, DNS-Fehler, Überprüfung des Serverzertifikats oder Timeout nicht durchgeführt werden.

TaskCanceledException

Nur .NET Core und .NET 5 und höher: Fehler bei der Anforderung aufgrund eines Timeouts.

OperationCanceledException

Das Abbruchtoken wurde abgebrochen. Diese Ausnahme wird in der zurückgegebenen Aufgabe gespeichert.

Hinweise

Hinweis

Im Falle eines Timeouts werden unterschiedliche Ausnahmen für verschiedene .NET-Implementierungen ausgelöst.

HttpRequestExceptionwird für alle anwendbaren .NET Framework Versionen ausgelöst.
TaskCanceledException ohne eine innere Ausnahme wird für alle anwendbaren .NET Core-Versionen ausgelöst.
TaskCanceledException , der ein schachtelt, TimeoutException wird unter .NET 5 und höheren Versionen ausgelöst.

Gilt für:

Freigeben über

HttpClient.GetAsync Methode

Definition

Überlädt

Hinweise

GetAsync(String)

Parameter

Gibt zurück

Ausnahmen

Hinweise

Gilt für:

GetAsync(Uri)

Parameter

Gibt zurück

Ausnahmen

Hinweise

Gilt für:

GetAsync(String, HttpCompletionOption)

Parameter

Gibt zurück

Ausnahmen

Hinweise

Gilt für:

GetAsync(String, CancellationToken)

Parameter

Gibt zurück

Ausnahmen

Hinweise

Gilt für:

GetAsync(Uri, HttpCompletionOption)

Parameter

Gibt zurück

Ausnahmen

Hinweise

Gilt für:

GetAsync(Uri, CancellationToken)

Parameter

Gibt zurück

Ausnahmen

Hinweise

Gilt für:

GetAsync(String, HttpCompletionOption, CancellationToken)

Parameter

Gibt zurück

Ausnahmen

Hinweise

Gilt für:

GetAsync(Uri, HttpCompletionOption, CancellationToken)

Parameter

Gibt zurück

Ausnahmen

Hinweise

Gilt für:

Zusätzliche Ressourcen