HttpClient.GetAsync Metoda

Definice

Obor názvů:: System.Net.Http

Sestavení:: System.Net.Http.dll

Sestavení:: netstandard.dll, System.Net.Http.dll

Sestavení:: netstandard.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

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

Přetížení

Name	Description
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í operací.
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í operací.
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

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

Task<HttpResponseMessage>

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

Výjimky

InvalidOperationException

Nejedná se requestUri o absolutní identifikátor URI a BaseAddress není nastavený.

HttpRequestException

Požadavek se nepovedl kvůli problému se získáním platné odpovědi HTTP, jako je selhání síťového připojení, selhání DNS, chyba ověření certifikátu serveru nebo neplatná odpověď serveru. Na .NET 8 a novějších verzích je důvod označen HttpRequestError

nebo

.NET Framework: Vypršel časový limit požadavku.

OperationCanceledException

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

UriFormatException

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

Poznámky

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

Note

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

HttpRequestException je vyvolán u všech použitelných verzí rozhraní .NET Framework.
OperationCanceledException bez vnitřní výjimky je vyvolán u všech použitelných verzí .NET Core.
OperationCanceledException, která vnořuje TimeoutException je vyvolán na .NET 5 a novějších verzích.

Platí pro

GetAsync(Uri)

Zdroj:: HttpClient.cs

Zdroj:: HttpClient.cs

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

Task<HttpResponseMessage>

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

Výjimky

InvalidOperationException

Nejedná se requestUri o absolutní identifikátor URI a BaseAddress není nastavený.

HttpRequestException

nebo

.NET Framework: Vypršel časový limit požadavku.

OperationCanceledException

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

Poznámky

Note

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

HttpRequestException je vyvolán u všech použitelných verzí rozhraní .NET Framework.
OperationCanceledException bez vnitřní výjimky je vyvolán u všech použitelných verzí .NET Core.
OperationCanceledException, která vnořuje TimeoutException je vyvolán na .NET 5 a novějších verzích.

Platí pro

GetAsync(String, HttpCompletionOption)

Zdroj:: HttpClient.cs

Zdroj:: HttpClient.cs

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í operací.

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á označuje, kdy má být operace považována za dokončenou.

Návraty

Task<HttpResponseMessage>

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

Výjimky

InvalidOperationException

Nejedná se requestUri o absolutní identifikátor URI a BaseAddress není nastavený.

HttpRequestException

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

OperationCanceledException

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

UriFormatException

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

Poznámky

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

Note

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

HttpRequestException je vyvolán u všech použitelných verzí rozhraní .NET Framework.
OperationCanceledException bez vnitřní výjimky je vyvolán u všech použitelných verzí .NET Core.
OperationCanceledException, která vnořuje TimeoutException je vyvolán na .NET 5 a novějších verzích.

Platí pro

GetAsync(String, CancellationToken)

Zdroj:: HttpClient.cs

Zdroj:: HttpClient.cs

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ý lze použít jinými objekty nebo vlákny k přijetí oznámení o zrušení.

Návraty

Task<HttpResponseMessage>

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

Výjimky

InvalidOperationException

Nejedná se requestUri o absolutní identifikátor URI a BaseAddress není nastavený.

HttpRequestException

nebo

.NET Framework: Vypršel časový limit požadavku.

UriFormatException

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

OperationCanceledException

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

nebo

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

Poznámky

Note

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

HttpRequestException je vyvolán u všech použitelných verzí rozhraní .NET Framework.
OperationCanceledException bez vnitřní výjimky je vyvolán u všech použitelných verzí .NET Core.
OperationCanceledException, která vnořuje TimeoutException je vyvolán na .NET 5 a novějších verzích.

Platí pro

GetAsync(Uri, HttpCompletionOption)

Zdroj:: HttpClient.cs

Zdroj:: HttpClient.cs

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í operací.

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á označuje, kdy má být operace považována za dokončenou.

Návraty

Task<HttpResponseMessage>

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

Výjimky

InvalidOperationException

Nejedná se requestUri o absolutní identifikátor URI a BaseAddress není nastavený.

HttpRequestException

nebo

.NET Framework: Vypršel časový limit požadavku.

OperationCanceledException

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

Poznámky

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

Note

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

HttpRequestException je vyvolán u všech použitelných verzí rozhraní .NET Framework.
OperationCanceledException bez vnitřní výjimky je vyvolán u všech použitelných verzí .NET Core.
OperationCanceledException, která vnořuje TimeoutException je vyvolán na .NET 5 a novějších verzích.

Platí pro

GetAsync(Uri, CancellationToken)

Zdroj:: HttpClient.cs

Zdroj:: HttpClient.cs

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ý lze použít jinými objekty nebo vlákny k přijetí oznámení o zrušení.

Návraty

Task<HttpResponseMessage>

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

Výjimky

InvalidOperationException

Nejedná se requestUri o absolutní identifikátor URI a BaseAddress není nastavený.

HttpRequestException

Požadavek selhal kvůli problému s získáním odpovědi HTTP, jako je připojení k síti, selhání DNS nebo ověření certifikátu serveru. Na .NET 8 a novějších verzích je důvod označen HttpRequestError

nebo

.NET Framework: Vypršel časový limit požadavku.

OperationCanceledException

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

nebo

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

Poznámky

Note

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

HttpRequestException je vyvolán u všech použitelných verzí rozhraní .NET Framework.
OperationCanceledException bez vnitřní výjimky je vyvolán u všech použitelných verzí .NET Core.
OperationCanceledException, která vnořuje TimeoutException je vyvolán na .NET 5 a novějších verzích.

Platí pro

GetAsync(String, HttpCompletionOption, CancellationToken)

Zdroj:: HttpClient.cs

Zdroj:: HttpClient.cs

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á označuje, kdy má být operace považována za dokončenou.

cancellationToken: CancellationToken

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

Návraty

Task<HttpResponseMessage>

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

Výjimky

InvalidOperationException

Nejedná se requestUri o absolutní identifikátor URI a BaseAddress není nastavený.

HttpRequestException

nebo

.NET Framework: Vypršel časový limit požadavku.

UriFormatException

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

OperationCanceledException

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

nebo

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

Poznámky

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

Note

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

HttpRequestException je vyvolán u všech použitelných verzí rozhraní .NET Framework.
OperationCanceledException bez vnitřní výjimky je vyvolán u všech použitelných verzí .NET Core.
OperationCanceledException, která vnořuje TimeoutException je vyvolán na .NET 5 a novějších verzích.

Platí pro

GetAsync(Uri, HttpCompletionOption, CancellationToken)

Zdroj:: HttpClient.cs

Zdroj:: HttpClient.cs

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á označuje, kdy má být operace považována za dokončenou.

cancellationToken: CancellationToken

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

Návraty

Task<HttpResponseMessage>

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

Výjimky

InvalidOperationException

Nejedná se requestUri o absolutní identifikátor URI a BaseAddress není nastavený.

HttpRequestException

nebo

.NET Framework: Vypršel časový limit požadavku.

OperationCanceledException

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

nebo

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

Poznámky

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

Note

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

HttpRequestException je vyvolán u všech použitelných verzí rozhraní .NET Framework.
OperationCanceledException bez vnitřní výjimky je vyvolán u všech použitelných verzí .NET Core.
OperationCanceledException, která vnořuje TimeoutException je vyvolán na .NET 5 a novějších verzích.

Platí pro

Váš názor

Byla tato stránka užitečná?