Sdílet prostřednictvím


HttpClient.GetAsync Metoda

Definice

Odešle požadavek GET na zadaný identifikátor URI jako asynchronní operaci.

Přetížení

GetAsync(String)

Odešle požadavek GET na zadaný identifikátor URI jako asynchronní operaci.

GetAsync(Uri)

Odešle požadavek GET na zadaný identifikátor URI jako asynchronní operaci.

GetAsync(String, HttpCompletionOption)

Odešle požadavek GET na zadaný identifikátor URI s možností dokončení HTTP jako asynchronní operace.

GetAsync(String, CancellationToken)

Odešle požadavek GET na zadaný identifikátor URI s tokenem zrušení jako asynchronní operací.

GetAsync(Uri, HttpCompletionOption)

Odešle požadavek GET na zadaný identifikátor URI s možností dokončení HTTP jako asynchronní operace.

GetAsync(Uri, CancellationToken)

Odešle požadavek GET na zadaný identifikátor URI s tokenem zrušení jako asynchronní operací.

GetAsync(String, HttpCompletionOption, CancellationToken)

Odešle požadavek GET na zadaný identifikátor URI s možností dokončení HTTP a tokenem zrušení jako asynchronní operací.

GetAsync(Uri, HttpCompletionOption, CancellationToken)

Odešle požadavek GET na zadaný identifikátor URI s možností dokončení HTTP a tokenem zrušení jako asynchronní operací.

Poznámky

Operace nebude blokována.

GetAsync(String)

Zdroj:
HttpClient.cs
Zdroj:
HttpClient.cs
Zdroj:
HttpClient.cs

Odešle požadavek GET na zadaný identifikátor URI jako asynchronní operaci.

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)

Parametry

requestUri
String

Identifikátor URI, na který se požadavek odešle.

Návraty

Objekt úlohy představující asynchronní operaci.

Výjimky

Musí requestUri být absolutní identifikátor URI nebo BaseAddress musí být nastaven.

Požadavek selhal kvůli základnímu problému, jako je připojení k síti, selhání DNS, ověření certifikátu serveru nebo vypršení časového limitu.

Pouze .NET Core a .NET 5 a novější: Požadavek selhal kvůli vypršení časového limitu.

Zadaný identifikátor URI požadavku není platný relativní nebo absolutní identifikátor URI.

Poznámky

Tato operace nebude blokována. Task<TResult> Vrácený objekt se dokončí po přečtení celé odpovědi (včetně obsahu). Chování je stejné, jako kdyby ResponseContentRead bylo explicitně zadáno.

Poznámka

V případě vypršení časového limitu se u různých implementací .NET vyvolá různé výjimky.

Platí pro

GetAsync(Uri)

Zdroj:
HttpClient.cs
Zdroj:
HttpClient.cs
Zdroj:
HttpClient.cs

Odešle požadavek GET na zadaný identifikátor URI jako asynchronní operaci.

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)

Parametry

requestUri
Uri

Identifikátor URI, na který se požadavek odešle.

Návraty

Objekt úlohy představující asynchronní operaci.

Výjimky

Musí requestUri být absolutní identifikátor URI nebo BaseAddress musí být nastaven.

Požadavek selhal kvůli základnímu problému, jako je připojení k síti, selhání DNS, ověření certifikátu serveru nebo vypršení časového limitu.

Pouze .NET Core a .NET 5 a novější: Požadavek selhal kvůli vypršení časového limitu.

Poznámky

Tato operace nebude blokována. Task<TResult> Vrácený objekt se dokončí po přečtení celé odpovědi (včetně obsahu). Chování je stejné, jako kdyby ResponseContentRead bylo explicitně zadáno.

Poznámka

V případě vypršení časového limitu se u různých implementací .NET vyvolá různé výjimky.

Platí pro

GetAsync(String, HttpCompletionOption)

Zdroj:
HttpClient.cs
Zdroj:
HttpClient.cs
Zdroj:
HttpClient.cs

Odešle požadavek GET na zadaný identifikátor URI s možností dokončení HTTP jako asynchronní operace.

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)

Parametry

requestUri
String

Identifikátor URI, na který se požadavek odešle.

completionOption
HttpCompletionOption

Hodnota možnosti dokončení HTTP, která určuje, kdy se má operace považovat za dokončenou.

Návraty

Objekt úlohy představující asynchronní operaci.

Výjimky

Musí requestUri být absolutní identifikátor URI nebo BaseAddress musí být nastaven.

Požadavek selhal kvůli základnímu problému, jako je připojení k síti, selhání DNS, ověření certifikátu serveru nebo vypršení časového limitu.

Pouze .NET Core a .NET 5 a novější: Požadavek selhal kvůli vypršení časového limitu.

Zadaný identifikátor URI požadavku není platný relativní nebo absolutní identifikátor URI.

Poznámky

Tato operace nebude blokována. Task<TResult> Vrácený objekt se dokončí na základě parametru completionOption po přečtení části nebo celé odpovědi (včetně obsahu).

Poznámka

V případě vypršení časového limitu se u různých implementací .NET vyvolá různé výjimky.

Platí pro

GetAsync(String, CancellationToken)

Zdroj:
HttpClient.cs
Zdroj:
HttpClient.cs
Zdroj:
HttpClient.cs

Odešle požadavek GET na zadaný identifikátor URI s tokenem zrušení jako asynchronní operací.

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)

Parametry

requestUri
String

Identifikátor URI, na který se požadavek odešle.

cancellationToken
CancellationToken

Token zrušení, který mohou být použity jinými objekty nebo vlákny k přijetí oznámení o zrušení.

Návraty

Objekt úlohy představující asynchronní operaci.

Výjimky

Musí requestUri být absolutní identifikátor URI nebo BaseAddress musí být nastaven.

Požadavek selhal kvůli základnímu problému, jako je připojení k síti, selhání DNS, ověření certifikátu serveru nebo vypršení časového limitu.

Pouze .NET Core a .NET 5 a novější: Požadavek selhal kvůli vypršení časového limitu.

Zadaný identifikátor URI požadavku není platný relativní nebo absolutní identifikátor URI.

Token zrušení byl zrušen. Tato výjimka se uloží do vrácené úlohy.

Poznámky

Tato operace nebude blokována. Task<TResult> Vrácený objekt se dokončí po přečtení celé odpovědi (včetně obsahu). Chování je stejné, jako kdyby ResponseContentRead bylo explicitně zadáno.

Poznámka

V případě vypršení časového limitu se u různých implementací .NET vyvolá různé výjimky.

Platí pro

GetAsync(Uri, HttpCompletionOption)

Zdroj:
HttpClient.cs
Zdroj:
HttpClient.cs
Zdroj:
HttpClient.cs

Odešle požadavek GET na zadaný identifikátor URI s možností dokončení HTTP jako asynchronní operace.

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)

Parametry

requestUri
Uri

Identifikátor URI, na který se požadavek odešle.

completionOption
HttpCompletionOption

Hodnota možnosti dokončení HTTP, která určuje, kdy se má operace považovat za dokončenou.

Návraty

Objekt úlohy představující asynchronní operaci.

Výjimky

Musí requestUri být absolutní identifikátor URI nebo BaseAddress musí být nastaven.

Požadavek selhal kvůli základnímu problému, jako je připojení k síti, selhání DNS, ověření certifikátu serveru nebo vypršení časového limitu.

Pouze .NET Core a .NET 5 a novější: Požadavek selhal kvůli vypršení časového limitu.

Poznámky

Tato operace nebude blokována. Task<TResult> Vrácený objekt se dokončí na základě parametru completionOption po přečtení části nebo celé odpovědi (včetně obsahu).

Poznámka

V případě vypršení časového limitu se u různých implementací .NET vyvolá různé výjimky.

Platí pro

GetAsync(Uri, CancellationToken)

Zdroj:
HttpClient.cs
Zdroj:
HttpClient.cs
Zdroj:
HttpClient.cs

Odešle požadavek GET na zadaný identifikátor URI s tokenem zrušení jako asynchronní operací.

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)

Parametry

requestUri
Uri

Identifikátor URI, na který se požadavek odešle.

cancellationToken
CancellationToken

Token zrušení, který mohou být použity jinými objekty nebo vlákny k přijetí oznámení o zrušení.

Návraty

Objekt úlohy představující asynchronní operaci.

Výjimky

Musí requestUri být absolutní identifikátor URI nebo BaseAddress musí být nastaven.

Požadavek selhal kvůli základnímu problému, jako je připojení k síti, selhání DNS, ověření certifikátu serveru nebo vypršení časového limitu.

Pouze .NET Core a .NET 5 a novější: Požadavek selhal kvůli vypršení časového limitu.

Token zrušení byl zrušen. Tato výjimka se uloží do vrácené úlohy.

Poznámky

Tato operace nebude blokována. Task<TResult> Vrácený objekt se dokončí po přečtení celé odpovědi (včetně obsahu). Chování je stejné, jako kdyby ResponseContentRead bylo explicitně zadáno.

Poznámka

V případě vypršení časového limitu se u různých implementací .NET vyvolá různé výjimky.

Platí pro

GetAsync(String, HttpCompletionOption, CancellationToken)

Zdroj:
HttpClient.cs
Zdroj:
HttpClient.cs
Zdroj:
HttpClient.cs

Odešle požadavek GET na zadaný identifikátor URI s možností dokončení HTTP a tokenem zrušení jako asynchronní operací.

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)

Parametry

requestUri
String

Identifikátor URI, na který se požadavek odešle.

completionOption
HttpCompletionOption

Hodnota možnosti dokončení HTTP, která určuje, kdy se má operace považovat za dokončenou.

cancellationToken
CancellationToken

Token zrušení, který mohou být použity jinými objekty nebo vlákny k přijetí oznámení o zrušení.

Návraty

Objekt úlohy představující asynchronní operaci.

Výjimky

Musí requestUri být absolutní identifikátor URI nebo BaseAddress musí být nastaven.

Požadavek selhal kvůli základnímu problému, jako je připojení k síti, selhání DNS, ověření certifikátu serveru nebo vypršení časového limitu.

Pouze .NET Core a .NET 5 a novější: Požadavek selhal kvůli vypršení časového limitu.

Zadaný identifikátor URI požadavku není platný relativní nebo absolutní identifikátor URI.

Token zrušení byl zrušen. Tato výjimka se uloží do vrácené úlohy.

Poznámky

Tato operace nebude blokována. Task<TResult> Vrácený objekt se dokončí na základě parametru completionOption po přečtení části nebo celé odpovědi (včetně obsahu).

Poznámka

V případě vypršení časového limitu se u různých implementací .NET vyvolá různé výjimky.

Platí pro

GetAsync(Uri, HttpCompletionOption, CancellationToken)

Zdroj:
HttpClient.cs
Zdroj:
HttpClient.cs
Zdroj:
HttpClient.cs

Odešle požadavek GET na zadaný identifikátor URI s možností dokončení HTTP a tokenem zrušení jako asynchronní operací.

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)

Parametry

requestUri
Uri

Identifikátor URI, na který se požadavek odešle.

completionOption
HttpCompletionOption

Hodnota možnosti dokončení HTTP, která určuje, kdy se má operace považovat za dokončenou.

cancellationToken
CancellationToken

Token zrušení, který mohou být použity jinými objekty nebo vlákny k přijetí oznámení o zrušení.

Návraty

Objekt úlohy představující asynchronní operaci.

Výjimky

Musí requestUri být absolutní identifikátor URI nebo BaseAddress musí být nastaven.

Požadavek selhal kvůli základnímu problému, jako je připojení k síti, selhání DNS, ověření certifikátu serveru nebo vypršení časového limitu.

Pouze .NET Core a .NET 5 a novější: Požadavek selhal kvůli vypršení časového limitu.

Token zrušení byl zrušen. Tato výjimka se uloží do vrácené úlohy.

Poznámky

Tato operace nebude blokována. Task<TResult> Vrácený objekt se dokončí na základě parametru completionOption po přečtení části nebo celé odpovědi (včetně obsahu).

Poznámka

V případě vypršení časového limitu se u různých implementací .NET vyvolá různé výjimky.

Platí pro