Sdílet prostřednictvím


HttpClient.SendAsync Metoda

Definice

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.

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.

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.

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.

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