Freigeben über


HttpClient.GetAsync Methode

Definition

Überlädt

GetAsync(Uri)

Eine GET-Anforderung an den angegebenen URI als asynchronen Vorgang senden. Programmieranleitungen für die HttpClient-Klasse und Codebeispiele finden Sie im konzeptuellen Thema HttpClient .

GetAsync(Uri, HttpCompletionOption)

Senden Sie eine GET-Anforderung mit einer HTTP-Vervollständigungsoption als asynchronen Vorgang an den angegebenen URI . Programmieranleitungen für die HttpClient-Klasse und Codebeispiele finden Sie im konzeptuellen Thema HttpClient .

GetAsync(Uri)

Eine GET-Anforderung an den angegebenen URI als asynchronen Vorgang senden. Programmieranleitungen für die HttpClient-Klasse und Codebeispiele finden Sie im konzeptuellen Thema HttpClient .

public:
 virtual IAsyncOperationWithProgress<HttpResponseMessage ^, HttpProgress> ^ GetAsync(Uri ^ uri) = GetAsync;
/// [Windows.Foundation.Metadata.Overload("GetAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<HttpResponseMessage, HttpProgress> GetAsync(Uri const& uri);
[Windows.Foundation.Metadata.Overload("GetAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperationWithProgress<HttpResponseMessage,HttpProgress> GetAsync(System.Uri uri);
function getAsync(uri)
Public Function GetAsync (uri As Uri) As IAsyncOperationWithProgress(Of HttpResponseMessage, HttpProgress)

Parameter

uri
Uri Uri

Der URI , an den die Anforderung gesendet werden soll.

Gibt zurück

Das -Objekt, das den asynchronen Vorgang darstellt.

Attribute

Hinweise

Dieser Vorgang wird nicht blockiert. Die zurückgegebene IAsyncOperationWithProgress (von HttpResponseMessage und HttpProgress) wird abgeschlossen, nachdem die gesamte Antwort (einschließlich des Inhalts) gelesen wurde.

Beispielcode in C#/VB/C++ und XAML, der zeigt, wie HttpClient und GetAsync(Uri) zum Herstellen einer Verbindung mit einem HTTP-Server und zum Senden einer GET-Anforderung verwendet werden, finden Sie unter HttpClient.

Beispielcode in JavaScript und HTML, der zeigt, wie Sie httpClient und GetAsync(Uri) verwenden, um eine Verbindung mit einem HTTP-Server herzustellen und eine GET-Anforderung zu senden, finden Sie unter Herstellen einer Verbindung mit einem HTTP-Server mithilfe von Windows.Web.Http.

Im Folgenden finden Sie die Ausnahmen, die von dieser Funktion ausgelöst werden.

COMException

Wird ausgelöst, wenn ein featurespezifisches HRESULT von einem Methodenaufruf zurückgegeben wird.

Dies ist die häufigste Ausnahme, die von Netzwerkmethoden ausgelöst wird. Eine App sollte das HRESULT aus der Ausnahme verwenden, um die Fehlerursache zu ermitteln.

AccessDeniedException

Wird ausgelöst, wenn der Zugriff auf eine Ressource oder eine Funktion verweigert wird. Diese Ausnahme tritt auf, wenn für eine App nicht die erforderlichen Netzwerkfunktionen im App-Manifest für den angeforderten Netzwerkvorgang festgelegt sind.

InvalidArgumentException

Wird ausgelöst, wenn eines der Argumente für eine Methode ungültig ist.

Wenn die vom Benutzer bereitgestellte Eingabe diese Ausnahme verursacht hat, kann eine App den Benutzer informieren und neue Eingaben anfordern.

ObjectDisposedException

Wird ausgelöst, wenn ein Vorgang für ein verworfenes Objekt ausgeführt wird.

OutOfMemoryException

Wird ausgelöst, wenn nicht genügend Arbeitsspeicher zum Abschließen des Vorgangs verfügbar ist.

Weitere Informationen

Gilt für:

GetAsync(Uri, HttpCompletionOption)

Senden Sie eine GET-Anforderung mit einer HTTP-Vervollständigungsoption als asynchronen Vorgang an den angegebenen URI . Programmieranleitungen für die HttpClient-Klasse und Codebeispiele finden Sie im konzeptuellen Thema HttpClient .

public:
 virtual IAsyncOperationWithProgress<HttpResponseMessage ^, HttpProgress> ^ GetAsync(Uri ^ uri, HttpCompletionOption completionOption) = GetAsync;
/// [Windows.Foundation.Metadata.Overload("GetWithOptionAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<HttpResponseMessage, HttpProgress> GetAsync(Uri const& uri, HttpCompletionOption const& completionOption);
[Windows.Foundation.Metadata.Overload("GetWithOptionAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperationWithProgress<HttpResponseMessage,HttpProgress> GetAsync(System.Uri uri, HttpCompletionOption completionOption);
function getAsync(uri, completionOption)
Public Function GetAsync (uri As Uri, completionOption As HttpCompletionOption) As IAsyncOperationWithProgress(Of HttpResponseMessage, HttpProgress)

Parameter

uri
Uri 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

Das -Objekt, das den asynchronen Vorgang darstellt.

Attribute

Hinweise

Dieser Vorgang wird nicht blockiert. Die zurückgegebene IAsyncOperationWithProgress (von HttpResponseMessage und HttpProgress) wird basierend auf dem completionOption-Parameter abgeschlossen, nachdem ein Teil oder die gesamte Antwort (einschließlich Inhalt) gelesen wurde.

Nachfolgend sind die Ausnahmen aufgeführt, die von diesem Inhalt ausgelöst werden.

COMException

Wird ausgelöst, wenn ein featurespezifisches HRESULT von einem Methodenaufruf zurückgegeben wird.

Dies ist die häufigste Ausnahme, die von Netzwerkmethoden ausgelöst wird. Eine App sollte das HRESULT aus der Ausnahme verwenden, um die Fehlerursache zu ermitteln.

AccessDeniedException

Wird ausgelöst, wenn der Zugriff auf eine Ressource oder eine Funktion verweigert wird. Diese Ausnahme tritt auf, wenn für eine App nicht die erforderlichen Netzwerkfunktionen im App-Manifest für den angeforderten Netzwerkvorgang festgelegt sind.

InvalidArgumentException

Wird ausgelöst, wenn eines der Argumente für eine Methode ungültig ist.

Wenn die vom Benutzer bereitgestellte Eingabe diese Ausnahme verursacht hat, kann eine App den Benutzer informieren und neue Eingaben anfordern.

ObjectDisposedException

Wird ausgelöst, wenn ein Vorgang für ein verworfenes Objekt ausgeführt wird.

OutOfMemoryException

Wird ausgelöst, wenn nicht genügend Arbeitsspeicher zum Abschließen des Vorgangs verfügbar ist.

Weitere Informationen

Gilt für: