Freigeben über


HttpClient.TryGetStringAsync(Uri) Methode

Definition

Senden Sie eine GET-Anforderung an den angegebenen URI und geben Sie den Antworttext als Zeichenfolge in einem asynchronen Vorgang zurück. Programmieranleitungen für die HttpClient-Klasse und Codebeispiele finden Sie im konzeptuellen Thema HttpClient .

public:
 virtual IAsyncOperationWithProgress<HttpGetStringResult ^, HttpProgress> ^ TryGetStringAsync(Uri ^ uri) = TryGetStringAsync;
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<HttpGetStringResult, HttpProgress> TryGetStringAsync(Uri const& uri);
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperationWithProgress<HttpGetStringResult,HttpProgress> TryGetStringAsync(System.Uri uri);
function tryGetStringAsync(uri)
Public Function TryGetStringAsync (uri As Uri) As IAsyncOperationWithProgress(Of HttpGetStringResult, HttpProgress)

Parameter

uri
Uri Uri

Der URI, an den die Anforderung gesendet wird.

Gibt zurück

Das -Objekt, das den asynchronen Vorgang darstellt.

Attribute

Windows-Anforderungen

Gerätefamilie
Windows 10, version 1903 (eingeführt in 10.0.18362.0)
API contract
Windows.Foundation.UniversalApiContract (eingeführt in v8.0)

Hinweise

Dieser Vorgang wird nicht blockiert. Der zurückgegebene IAsyncOperationWithProgress (von HttpGetStringResult und HttpProgress) wird abgeschlossen, nachdem der gesamte Antworttext gelesen wurde.

Die HttpClient-Klasse wird häufig von einer App verwendet, um Text herunterzuladen und dann zu analysieren. Es ist möglich, dass die im Content-Type-Header von einem HTTP-Server angegebene Zeichencodierung nicht mit der Zeichencodierung des HTTP-Antworttexts übereinstimmt (z. B. die XML-Codierung in einem XML-Dokument). Eine Möglichkeit, HttpClient mit Text zu verwenden, besteht darin, die TryGetStringAsync-Methode aufzurufen und die zurückgegebene Zeichenfolge an den Textparser zu übergeben. Dies kann jedoch zu Fehlern führen, wenn der Content-Type kein Typ ist, der als Zeichenfolge ausgedrückt werden kann. Eine zuverlässige Möglichkeit zur Verwendung von HttpClient mit einem XML-Parser besteht darin, die TryGetBufferAsync-Methode aufzurufen und den Puffer für das Element "<?xml>" zu analysieren. Verwenden Sie dann die angegebene Zeichencodierung ("<xmlversion="1.0" encoding="UTF-8"?>", z. B.), um den HTTP-Antworttext zu analysieren. Für andere Textformate können ähnliche Methoden verwendet werden, wenn die App den anfänglichen Teil des HTTP-Antworttexts überprüft, um die verwendete Zeichencodierung zu bestimmen.

Gilt für:

Weitere Informationen