HttpClient.SendAsync Metoda
Definice
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 HTTP jako asynchronní operaci.
Přetížení
| SendAsync(HttpRequestMessage, HttpCompletionOption, CancellationToken) |
Odešle požadavek HTTP jako asynchronní operaci. |
| SendAsync(HttpRequestMessage) |
Odešle požadavek HTTP jako asynchronní operaci. |
| SendAsync(HttpRequestMessage, HttpCompletionOption) |
Odešle požadavek HTTP jako asynchronní operaci. |
| SendAsync(HttpRequestMessage, CancellationToken) |
Odešle požadavek HTTP jako asynchronní operaci. |
Poznámky
Tato operace nebude blokována.
SendAsync(HttpRequestMessage, HttpCompletionOption, CancellationToken)
- Zdroj:
- HttpClient.cs
- Zdroj:
- HttpClient.cs
- Zdroj:
- HttpClient.cs
Odešle požadavek HTTP jako asynchronní operaci.
public:
System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ SendAsync(System::Net::Http::HttpRequestMessage ^ request, System::Net::Http::HttpCompletionOption completionOption, System::Threading::CancellationToken cancellationToken);public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> SendAsync (System.Net.Http.HttpRequestMessage request, System.Net.Http.HttpCompletionOption completionOption, System.Threading.CancellationToken cancellationToken);override this.SendAsync : System.Net.Http.HttpRequestMessage * System.Net.Http.HttpCompletionOption * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>Public Function SendAsync (request As HttpRequestMessage, completionOption As HttpCompletionOption, cancellationToken As CancellationToken) As Task(Of HttpResponseMessage)Parametry
- request
- HttpRequestMessage
Zpráva požadavku HTTP, která se má odeslat.
- completionOption
- HttpCompletionOption
Kdy by se měla operace dokončit (jakmile je k dispozici odpověď, nebo po přečtení celého obsahu odpovědi)
- cancellationToken
- CancellationToken
Token zrušení pro zrušení operace.
Návraty
Objekt úlohy představující asynchronní operaci.
Výjimky
Hodnota request je null.
Instance již odeslala HttpClient zprávu požadavku.
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. V závislosti na hodnotě parametru completionOption se vrácený Task<TResult> objekt dokončí, jakmile bude k dispozici odpověď nebo se přečte celá odpověď 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.
- HttpRequestException je vyvolán ve všech použitelných verzích rozhraní .NET Framework.
- TaskCanceledException ve všech příslušných verzích .NET Core se nevyvolá žádná vnitřní výjimka.
- TaskCanceledException vnořování TimeoutException je vyvoláno v .NET 5 a novějších verzích.
Tato metoda ukládá do úlohy, která vrací všechny výjimky nepouužování, které může vyvolat synchronní protějšek metody. Pokud je do vrácené úlohy uložena výjimka, bude tato výjimka vyvolána, když je úloha očekávána. Výjimky použití, jako ArgumentExceptionje , se stále vyvolává synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem Send(HttpRequestMessage, HttpCompletionOption).
Platí pro
SendAsync(HttpRequestMessage)
- Zdroj:
- HttpClient.cs
- Zdroj:
- HttpClient.cs
- Zdroj:
- HttpClient.cs
Odešle požadavek HTTP jako asynchronní operaci.
public:
System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ SendAsync(System::Net::Http::HttpRequestMessage ^ request);public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> SendAsync (System.Net.Http.HttpRequestMessage request);override this.SendAsync : System.Net.Http.HttpRequestMessage -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>Public Function SendAsync (request As HttpRequestMessage) As Task(Of HttpResponseMessage)Parametry
- request
- HttpRequestMessage
Zpráva požadavku HTTP, která se má odeslat.
Návraty
Objekt úlohy představující asynchronní operaci.
Výjimky
Hodnota request je null.
Instance již odeslala HttpClient zprávu požadavku.
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čí, jakmile se přečte celá odpověď 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.
- HttpRequestException je vyvolán ve všech použitelných verzích rozhraní .NET Framework.
- TaskCanceledException ve všech příslušných verzích .NET Core se nevyvolá žádná vnitřní výjimka.
- TaskCanceledException vnořování TimeoutException je vyvoláno v .NET 5 a novějších verzích.
Tato metoda ukládá do úlohy, která vrací všechny výjimky nepouužování, které může vyvolat synchronní protějšek metody. Pokud je do vrácené úlohy uložena výjimka, bude tato výjimka vyvolána, když je úloha očekávána. Výjimky použití, jako ArgumentExceptionje , se stále vyvolává synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem Send(HttpRequestMessage).
Platí pro
SendAsync(HttpRequestMessage, HttpCompletionOption)
- Zdroj:
- HttpClient.cs
- Zdroj:
- HttpClient.cs
- Zdroj:
- HttpClient.cs
Odešle požadavek HTTP jako asynchronní operaci.
public:
System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ SendAsync(System::Net::Http::HttpRequestMessage ^ request, System::Net::Http::HttpCompletionOption completionOption);public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> SendAsync (System.Net.Http.HttpRequestMessage request, System.Net.Http.HttpCompletionOption completionOption);override this.SendAsync : System.Net.Http.HttpRequestMessage * System.Net.Http.HttpCompletionOption -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>Public Function SendAsync (request As HttpRequestMessage, completionOption As HttpCompletionOption) As Task(Of HttpResponseMessage)Parametry
- request
- HttpRequestMessage
Zpráva požadavku HTTP, která se má odeslat.
- completionOption
- HttpCompletionOption
Kdy by se měla operace dokončit (jakmile je k dispozici odpověď, nebo po přečtení celého obsahu odpovědi)
Návraty
Objekt úlohy představující asynchronní operaci.
Výjimky
Hodnota request je null.
Instance již odeslala HttpClient zprávu požadavku.
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. V závislosti na hodnotě parametru completionOption se vrácený Task<TResult> objekt dokončí, jakmile bude k dispozici odpověď nebo se přečte celá odpověď 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.
- HttpRequestException je vyvolán ve všech použitelných verzích rozhraní .NET Framework.
- TaskCanceledException ve všech příslušných verzích .NET Core se nevyvolá žádná vnitřní výjimka.
- TaskCanceledException vnořování TimeoutException je vyvoláno v .NET 5 a novějších verzích.
Tato metoda ukládá do úlohy, která vrací všechny výjimky nepouužování, které může vyvolat synchronní protějšek metody. Pokud je do vrácené úlohy uložena výjimka, bude tato výjimka vyvolána, když je úloha očekávána. Výjimky použití, jako ArgumentExceptionje , se stále vyvolává synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem Send(HttpRequestMessage, HttpCompletionOption).
Platí pro
SendAsync(HttpRequestMessage, CancellationToken)
- Zdroj:
- HttpClient.cs
- Zdroj:
- HttpClient.cs
- Zdroj:
- HttpClient.cs
Odešle požadavek HTTP jako asynchronní operaci.
public:
override System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ SendAsync(System::Net::Http::HttpRequestMessage ^ request, System::Threading::CancellationToken cancellationToken);public override System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> SendAsync (System.Net.Http.HttpRequestMessage request, System.Threading.CancellationToken cancellationToken);override this.SendAsync : System.Net.Http.HttpRequestMessage * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>Public Overrides Function SendAsync (request As HttpRequestMessage, cancellationToken As CancellationToken) As Task(Of HttpResponseMessage)Parametry
- request
- HttpRequestMessage
Zpráva požadavku HTTP, která se má odeslat.
- cancellationToken
- CancellationToken
Token zrušení pro zrušení operace.
Návraty
Objekt úlohy představující asynchronní operaci.
Výjimky
Hodnota request je null.
Instance již odeslala HttpClient zprávu požadavku.
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čí, jakmile se přečte celá odpověď 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.
- HttpRequestException je vyvolán ve všech použitelných verzích rozhraní .NET Framework.
- TaskCanceledException ve všech příslušných verzích .NET Core se nevyvolá žádná vnitřní výjimka.
- TaskCanceledException vnořování TimeoutException je vyvoláno v .NET 5 a novějších verzích.
Tato metoda ukládá do úlohy, která vrací všechny výjimky nepouužování, které může vyvolat synchronní protějšek metody. Pokud je do vrácené úlohy uložena výjimka, bude tato výjimka vyvolána, když je úloha očekávána. Výjimky použití, jako ArgumentExceptionje , se stále vyvolává synchronně. Informace o uložených výjimkách najdete v tématu Výjimky vyvolané nástrojem Send(HttpRequestMessage).
