Freigeben über


HttpClient.GetStringAsync Methode

Definition

Senden Sie eine GET-Anforderung an den angegebenen URI und geben Sie den Antworttext als Zeichenfolge in einem asynchronen Vorgang zurück.

Überlädt

GetStringAsync(String)

Senden Sie eine GET-Anforderung an den angegebenen URI und geben Sie den Antworttext als Zeichenfolge in einem asynchronen Vorgang zurück.

GetStringAsync(Uri)

Senden Sie eine GET-Anforderung an den angegebenen URI und geben Sie den Antworttext als Zeichenfolge in einem asynchronen Vorgang zurück.

GetStringAsync(String, CancellationToken)

Senden Sie eine GET-Anforderung an den angegebenen URI und geben Sie den Antworttext als Zeichenfolge in einem asynchronen Vorgang zurück.

GetStringAsync(Uri, CancellationToken)

Senden Sie eine GET-Anforderung an den angegebenen URI und geben Sie den Antworttext als Zeichenfolge in einem asynchronen Vorgang zurück.

Hinweise

Dieser Vorgang wird nicht blockiert.

GetStringAsync(String)

Quelle:
HttpClient.cs
Quelle:
HttpClient.cs
Quelle:
HttpClient.cs

Senden Sie eine GET-Anforderung an den angegebenen URI und geben Sie den Antworttext als Zeichenfolge in einem asynchronen Vorgang zurück.

public:
 System::Threading::Tasks::Task<System::String ^> ^ GetStringAsync(System::String ^ requestUri);
public System.Threading.Tasks.Task<string> GetStringAsync (string requestUri);
public System.Threading.Tasks.Task<string> GetStringAsync (string? requestUri);
member this.GetStringAsync : string -> System.Threading.Tasks.Task<string>
Public Function GetStringAsync (requestUri As String) As Task(Of String)

Parameter

requestUri
String

Der URI, an den die Anforderung gesendet wird.

Gibt zurück

Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.

Ausnahmen

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

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

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

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 der gesamte Antworttext gelesen wurde.

Hinweis

Im Falle eines Timeouts:

Gilt für:

GetStringAsync(Uri)

Quelle:
HttpClient.cs
Quelle:
HttpClient.cs
Quelle:
HttpClient.cs

Senden Sie eine GET-Anforderung an den angegebenen URI und geben Sie den Antworttext als Zeichenfolge in einem asynchronen Vorgang zurück.

public:
 System::Threading::Tasks::Task<System::String ^> ^ GetStringAsync(Uri ^ requestUri);
public System.Threading.Tasks.Task<string> GetStringAsync (Uri requestUri);
public System.Threading.Tasks.Task<string> GetStringAsync (Uri? requestUri);
member this.GetStringAsync : Uri -> System.Threading.Tasks.Task<string>
Public Function GetStringAsync (requestUri As Uri) As Task(Of String)

Parameter

requestUri
Uri

Der URI, an den die Anforderung gesendet wird.

Gibt zurück

Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.

Ausnahmen

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

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

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

Hinweise

Dieser Vorgang wird nicht blockiert. Das zurückgegebene Task<TResult> Objekt wird abgeschlossen, nachdem der gesamte Antworttext gelesen wurde.

Hinweis

Im Falle eines Timeouts:

Gilt für:

GetStringAsync(String, CancellationToken)

Quelle:
HttpClient.cs
Quelle:
HttpClient.cs
Quelle:
HttpClient.cs

Senden Sie eine GET-Anforderung an den angegebenen URI und geben Sie den Antworttext als Zeichenfolge in einem asynchronen Vorgang zurück.

public:
 System::Threading::Tasks::Task<System::String ^> ^ GetStringAsync(System::String ^ requestUri, System::Threading::CancellationToken cancellationToken);
public System.Threading.Tasks.Task<string> GetStringAsync (string? requestUri, System.Threading.CancellationToken cancellationToken);
member this.GetStringAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<string>
Public Function GetStringAsync (requestUri As String, cancellationToken As CancellationToken) As Task(Of String)

Parameter

requestUri
String

Der URI, an den die Anforderung gesendet wird.

cancellationToken
CancellationToken

Das Abbruchtoken, um den Vorgang abzubrechen.

Gibt zurück

Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.

Ausnahmen

requestUri ist null.

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

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

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.

Hinweise

Dieser Vorgang wird nicht blockiert. Das zurückgegebene Task<TResult> Objekt wird abgeschlossen, nachdem der gesamte Antworttext gelesen wurde.

Hinweis

Im Falle eines Timeouts:

Gilt für:

GetStringAsync(Uri, CancellationToken)

Quelle:
HttpClient.cs
Quelle:
HttpClient.cs
Quelle:
HttpClient.cs

Senden Sie eine GET-Anforderung an den angegebenen URI und geben Sie den Antworttext als Zeichenfolge in einem asynchronen Vorgang zurück.

public:
 System::Threading::Tasks::Task<System::String ^> ^ GetStringAsync(Uri ^ requestUri, System::Threading::CancellationToken cancellationToken);
public System.Threading.Tasks.Task<string> GetStringAsync (Uri? requestUri, System.Threading.CancellationToken cancellationToken);
member this.GetStringAsync : Uri * System.Threading.CancellationToken -> System.Threading.Tasks.Task<string>
Public Function GetStringAsync (requestUri As Uri, cancellationToken As CancellationToken) As Task(Of String)

Parameter

requestUri
Uri

Der URI, an den die Anforderung gesendet wird.

cancellationToken
CancellationToken

Das Abbruchtoken, um den Vorgang abzubrechen.

Gibt zurück

Das Aufgabenobjekt, das den asynchronen Vorgang darstellt.

Ausnahmen

requestUri ist null.

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

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

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 der gesamte Antworttext gelesen wurde.

Hinweis

Im Falle eines Timeouts:

Gilt für: