HttpClient.SendAsync Metoda
Definice
Odeslat požadavek HTTP jako asynchronní operaci.Send an HTTP request as an asynchronous operation.
Přetížení
| SendAsync(HttpRequestMessage, HttpCompletionOption, CancellationToken) |
Odeslat požadavek HTTP jako asynchronní operaci.Send an HTTP request as an asynchronous operation. |
| SendAsync(HttpRequestMessage) |
Odeslat požadavek HTTP jako asynchronní operaci.Send an HTTP request as an asynchronous operation. |
| SendAsync(HttpRequestMessage, HttpCompletionOption) |
Odeslat požadavek HTTP jako asynchronní operaci.Send an HTTP request as an asynchronous operation. |
| SendAsync(HttpRequestMessage, CancellationToken) |
Odeslat požadavek HTTP jako asynchronní operaci.Send an HTTP request as an asynchronous operation. |
Poznámky
Tato operace se neblokuje.This operation will not block.
SendAsync(HttpRequestMessage, HttpCompletionOption, CancellationToken)
Odeslat požadavek HTTP jako asynchronní operaci.Send an HTTP request as an asynchronous operation.
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á odeslatThe HTTP request message to send.
- completionOption
- HttpCompletionOption
Po dokončení operace (jakmile bude odpověď k dispozici nebo po přečtení obsahu celé odpovědi).When the operation should complete (as soon as a response is available or after reading the whole response content).
- cancellationToken
- CancellationToken
Token zrušení pro zrušení operace.The cancellation token to cancel operation.
Návraty
Objekt úlohy reprezentující asynchronní operaci.The task object representing the asynchronous operation.
Výjimky
requestJe null .The request is null.
Tato zpráva požadavku byla již odeslána HttpClient instancí.The request message was already sent by the HttpClient instance.
Požadavek se nezdařil z důvodu základního problému, například připojení k síti, selhání služby DNS, ověřování certifikátu serveru nebo vypršení časového limitu.The request failed due to an underlying issue such as network connectivity, DNS failure, server certificate validation or timeout.
.NET Core a .NET 5,0 a novější: požadavek se nezdařil z důvodu vypršení časového limitu..NET Core and .NET 5.0 and later only: The request failed due to timeout.
Poznámky
Tato operace se neblokuje.This operation will not block. V závislosti na hodnotě completionOption parametru se vrácený Task<TResult> objekt dokončí, jakmile bude k dispozici odpověď, nebo když se načte celá odpověď včetně obsahu.Depending on the value of the completionOption parameter, the returned Task<TResult> object will complete as soon as a response is available or the entire response including content is read.
Poznámka
V případě časového limitu jsou v různých implementacích rozhraní .NET vyvolány různé výjimky.In case of timeout, different exceptions are thrown on different .NET implementations.
- HttpRequestException je vyvolána ve všech platných .NET Framework verzích.HttpRequestException is thrown on all applicable .NET Framework versions.
- TaskCanceledException bez vnitřních výjimek je vyvolána ve všech platných verzích .NET Core.TaskCanceledException without any inner exception is thrown on all applicable .NET Core versions.
- TaskCanceledException vnoření a TimeoutException je vyvoláno v rozhraní .net 5,0 a novějších verzích.TaskCanceledException that nests a TimeoutException is thrown on .NET 5.0 and later versions.
Platí pro
SendAsync(HttpRequestMessage)
Odeslat požadavek HTTP jako asynchronní operaci.Send an HTTP request as an asynchronous operation.
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á odeslatThe HTTP request message to send.
Návraty
Objekt úlohy reprezentující asynchronní operaci.The task object representing the asynchronous operation.
Výjimky
requestJe null .The request is null.
Tato zpráva požadavku byla již odeslána HttpClient instancí.The request message was already sent by the HttpClient instance.
Požadavek se nezdařil z důvodu základního problému, například připojení k síti, selhání služby DNS, ověřování certifikátu serveru nebo vypršení časového limitu.The request failed due to an underlying issue such as network connectivity, DNS failure, server certificate validation or timeout.
.NET Core a .NET 5,0 a novější: požadavek se nezdařil z důvodu vypršení časového limitu..NET Core and .NET 5.0 and later only: The request failed due to timeout.
Poznámky
Tato operace se neblokuje.This operation will not block. Vrácený Task<TResult> objekt se dokončí, jakmile se načte celá odpověď včetně obsahu.The returned Task<TResult> object will complete once the entire response including content is read.
Poznámka
V případě časového limitu jsou v různých implementacích rozhraní .NET vyvolány různé výjimky.In case of timeout, different exceptions are thrown on different .NET implementations.
- HttpRequestException je vyvolána ve všech platných .NET Framework verzích.HttpRequestException is thrown on all applicable .NET Framework versions.
- TaskCanceledException bez vnitřních výjimek je vyvolána ve všech platných verzích .NET Core.TaskCanceledException without any inner exception is thrown on all applicable .NET Core versions.
- TaskCanceledException vnoření a TimeoutException je vyvoláno v rozhraní .net 5,0 a novějších verzích.TaskCanceledException that nests a TimeoutException is thrown on .NET 5.0 and later versions.
Platí pro
SendAsync(HttpRequestMessage, HttpCompletionOption)
Odeslat požadavek HTTP jako asynchronní operaci.Send an HTTP request as an asynchronous operation.
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á odeslatThe HTTP request message to send.
- completionOption
- HttpCompletionOption
Po dokončení operace (jakmile bude odpověď k dispozici nebo po přečtení obsahu celé odpovědi).When the operation should complete (as soon as a response is available or after reading the whole response content).
Návraty
Objekt úlohy reprezentující asynchronní operaci.The task object representing the asynchronous operation.
Výjimky
requestJe null .The request is null.
Tato zpráva požadavku byla již odeslána HttpClient instancí.The request message was already sent by the HttpClient instance.
Požadavek se nezdařil z důvodu základního problému, například připojení k síti, selhání služby DNS, ověřování certifikátu serveru nebo vypršení časového limitu.The request failed due to an underlying issue such as network connectivity, DNS failure, server certificate validation or timeout.
.NET Core a .NET 5,0 a novější: požadavek se nezdařil z důvodu vypršení časového limitu..NET Core and .NET 5.0 and later only: The request failed due to timeout.
Poznámky
Tato operace se neblokuje.This operation will not block. V závislosti na hodnotě completionOption parametru se vrácený Task<TResult> objekt dokončí, jakmile bude k dispozici odpověď, nebo když se načte celá odpověď včetně obsahu.Depending on the value of the completionOption parameter, the returned Task<TResult> object will complete as soon as a response is available or the entire response including content is read.
Poznámka
V případě časového limitu jsou v různých implementacích rozhraní .NET vyvolány různé výjimky.In case of timeout, different exceptions are thrown on different .NET implementations.
- HttpRequestException je vyvolána ve všech platných .NET Framework verzích.HttpRequestException is thrown on all applicable .NET Framework versions.
- TaskCanceledException bez vnitřních výjimek je vyvolána ve všech platných verzích .NET Core.TaskCanceledException without any inner exception is thrown on all applicable .NET Core versions.
- TaskCanceledException vnoření a TimeoutException je vyvoláno v rozhraní .net 5,0 a novějších verzích.TaskCanceledException that nests a TimeoutException is thrown on .NET 5.0 and later versions.
Platí pro
SendAsync(HttpRequestMessage, CancellationToken)
Odeslat požadavek HTTP jako asynchronní operaci.Send an HTTP request as an asynchronous operation.
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á odeslatThe HTTP request message to send.
- cancellationToken
- CancellationToken
Token zrušení pro zrušení operace.The cancellation token to cancel operation.
Návraty
Objekt úlohy reprezentující asynchronní operaci.The task object representing the asynchronous operation.
Výjimky
requestJe null .The request is null.
Tato zpráva požadavku byla již odeslána HttpClient instancí.The request message was already sent by the HttpClient instance.
Požadavek se nezdařil z důvodu základního problému, například připojení k síti, selhání služby DNS, ověřování certifikátu serveru nebo vypršení časového limitu.The request failed due to an underlying issue such as network connectivity, DNS failure, server certificate validation or timeout.
.NET Core a .NET 5,0 a novější: požadavek se nezdařil z důvodu vypršení časového limitu..NET Core and .NET 5.0 and later only: The request failed due to timeout.
Poznámky
Tato operace se neblokuje.This operation will not block. Vrácený Task<TResult> objekt se dokončí, jakmile se načte celá odpověď včetně obsahu.The returned Task<TResult> object will complete once the entire response including content is read.
Poznámka
V případě časového limitu jsou v různých implementacích rozhraní .NET vyvolány různé výjimky.In case of timeout, different exceptions are thrown on different .NET implementations.
- HttpRequestException je vyvolána ve všech platných .NET Framework verzích.HttpRequestException is thrown on all applicable .NET Framework versions.
- TaskCanceledException bez vnitřních výjimek je vyvolána ve všech platných verzích .NET Core.TaskCanceledException without any inner exception is thrown on all applicable .NET Core versions.
- TaskCanceledException vnoření a TimeoutException je vyvoláno v rozhraní .net 5,0 a novějších verzích.TaskCanceledException that nests a TimeoutException is thrown on .NET 5.0 and later versions.