HttpClient.SendAsync Metoda

Definice

Obor názvů:

System.Net.Http

Sestavení:

System.Net.Http.dll

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

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

Task<HttpResponseMessage>

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

Výjimky

ArgumentNullException

Hodnota request je null.

InvalidOperationException

Instance již odeslala HttpClient zprávu požadavku.

HttpRequestException

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.

TaskCanceledException

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

OperationCanceledException

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).

SendAsync(HttpRequestMessage)

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

Task<HttpResponseMessage>

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

Výjimky

ArgumentNullException

Hodnota request je null.

InvalidOperationException

Instance již odeslala HttpClient zprávu požadavku.

HttpRequestException

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.

TaskCanceledException

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).

SendAsync(HttpRequestMessage, HttpCompletionOption)

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

Task<HttpResponseMessage>

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

Výjimky

ArgumentNullException

Hodnota request je null.

InvalidOperationException

Instance již odeslala HttpClient zprávu požadavku.

HttpRequestException

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.

TaskCanceledException

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).

SendAsync(HttpRequestMessage, CancellationToken)

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

Task<HttpResponseMessage>

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

Výjimky

ArgumentNullException

Hodnota request je null.

InvalidOperationException

Instance již odeslala HttpClient zprávu požadavku.

HttpRequestException

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.

TaskCanceledException

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

OperationCanceledException

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).