HttpClient.SendAsync Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Wyślij żądanie HTTP jako operację asynchroniczną.
Przeciążenia
| SendAsync(HttpRequestMessage, HttpCompletionOption, CancellationToken) |
Wyślij żądanie HTTP jako operację asynchroniczną. |
| SendAsync(HttpRequestMessage) |
Wyślij żądanie HTTP jako operację asynchroniczną. |
| SendAsync(HttpRequestMessage, HttpCompletionOption) |
Wyślij żądanie HTTP jako operację asynchroniczną. |
| SendAsync(HttpRequestMessage, CancellationToken) |
Wyślij żądanie HTTP jako operację asynchroniczną. |
Uwagi
Ta operacja nie będzie blokować.
SendAsync(HttpRequestMessage, HttpCompletionOption, CancellationToken)
- Źródło:
- HttpClient.cs
- Źródło:
- HttpClient.cs
- Źródło:
- HttpClient.cs
Wyślij żądanie HTTP jako operację asynchroniczną.
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
Komunikat żądania HTTP do wysłania.
- completionOption
- HttpCompletionOption
Po zakończeniu operacji (gdy tylko jest dostępna odpowiedź lub po odczytaniu całej zawartości odpowiedzi).
- cancellationToken
- CancellationToken
Token anulowania do anulowania operacji.
Zwraca
Obiekt zadania reprezentujący operację asynchroniczną.
Wyjątki
Wartość request to null.
Komunikat żądania został już wysłany przez HttpClient wystąpienie.
Żądanie nie powiodło się z powodu podstawowego problemu, takiego jak łączność sieciowa, niepowodzenie DNS, walidacja certyfikatu serwera lub przekroczenie limitu czasu.
Tylko platformy .NET Core i .NET 5 i nowsze: żądanie nie powiodło się z powodu przekroczenia limitu czasu.
Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwracanym zadaniu.
Uwagi
Ta operacja nie będzie blokować. W zależności od wartości parametru completionOption zwrócony Task<TResult> obiekt zostanie ukończony natychmiast po udostępnieniu odpowiedzi lub odczytaniu całej odpowiedzi, w tym zawartości.
Uwaga
W przypadku przekroczenia limitu czasu różne wyjątki są zgłaszane w różnych implementacjach platformy .NET.
- HttpRequestExceptionjest zgłaszany we wszystkich odpowiednich wersjach .NET Framework.
- TaskCanceledException bez żadnego wyjątku wewnętrznego jest zgłaszany we wszystkich odpowiednich wersjach platformy .NET Core.
- TaskCanceledException zagnieżdża TimeoutException element , który jest zgłaszany na platformie .NET 5 i nowszych wersjach.
Ta metoda jest przechowywana w zadaniu, które zwraca wszystkie wyjątki nieużytowe, które może zgłosić synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwracanym zadaniu, ten wyjątek zostanie zgłoszony podczas oczekiwania zadania. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. W przypadku przechowywanych wyjątków zobacz wyjątki zgłoszone przez Send(HttpRequestMessage, HttpCompletionOption)usługę .
Dotyczy
SendAsync(HttpRequestMessage)
- Źródło:
- HttpClient.cs
- Źródło:
- HttpClient.cs
- Źródło:
- HttpClient.cs
Wyślij żądanie HTTP jako operację asynchroniczną.
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
Komunikat żądania HTTP do wysłania.
Zwraca
Obiekt zadania reprezentujący operację asynchroniczną.
Wyjątki
Wartość request to null.
Komunikat żądania został już wysłany przez HttpClient wystąpienie.
Żądanie nie powiodło się z powodu podstawowego problemu, takiego jak łączność sieciowa, niepowodzenie DNS, walidacja certyfikatu serwera lub przekroczenie limitu czasu.
Tylko platformy .NET Core i .NET 5 i nowsze: żądanie nie powiodło się z powodu przekroczenia limitu czasu.
Uwagi
Ta operacja nie będzie blokować. Zwrócony obiekt zostanie ukończony Task<TResult> po odczytaniu całej odpowiedzi wraz z zawartością. Zachowanie jest takie samo, jak w przypadku ResponseContentRead jawnego określenia.
Uwaga
W przypadku przekroczenia limitu czasu różne wyjątki są zgłaszane w różnych implementacjach platformy .NET.
- HttpRequestExceptionjest zgłaszany we wszystkich odpowiednich wersjach .NET Framework.
- TaskCanceledException bez żadnego wyjątku wewnętrznego jest zgłaszany we wszystkich odpowiednich wersjach platformy .NET Core.
- TaskCanceledException zagnieżdża TimeoutException element , który jest zgłaszany na platformie .NET 5 i nowszych wersjach.
Ta metoda jest przechowywana w zadaniu, które zwraca wszystkie wyjątki nieużytowe, które może zgłosić synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwracanym zadaniu, ten wyjątek zostanie zgłoszony podczas oczekiwania zadania. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. W przypadku przechowywanych wyjątków zobacz wyjątki zgłoszone przez Send(HttpRequestMessage)usługę .
Dotyczy
SendAsync(HttpRequestMessage, HttpCompletionOption)
- Źródło:
- HttpClient.cs
- Źródło:
- HttpClient.cs
- Źródło:
- HttpClient.cs
Wyślij żądanie HTTP jako operację asynchroniczną.
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
Komunikat żądania HTTP do wysłania.
- completionOption
- HttpCompletionOption
Po zakończeniu operacji (gdy tylko jest dostępna odpowiedź lub po odczytaniu całej zawartości odpowiedzi).
Zwraca
Obiekt zadania reprezentujący operację asynchroniczną.
Wyjątki
Wartość request to null.
Komunikat żądania został już wysłany przez HttpClient wystąpienie.
Żądanie nie powiodło się z powodu podstawowego problemu, takiego jak łączność sieciowa, niepowodzenie DNS, walidacja certyfikatu serwera lub przekroczenie limitu czasu.
Tylko platformy .NET Core i .NET 5 i nowsze: żądanie nie powiodło się z powodu przekroczenia limitu czasu.
Uwagi
Ta operacja nie będzie blokować. W zależności od wartości parametru completionOption zwrócony Task<TResult> obiekt zostanie ukończony natychmiast po udostępnieniu odpowiedzi lub odczytaniu całej odpowiedzi, w tym zawartości.
Uwaga
W przypadku przekroczenia limitu czasu różne wyjątki są zgłaszane w różnych implementacjach platformy .NET.
- HttpRequestExceptionjest zgłaszany we wszystkich odpowiednich wersjach .NET Framework.
- TaskCanceledException bez żadnego wyjątku wewnętrznego jest zgłaszany we wszystkich odpowiednich wersjach platformy .NET Core.
- TaskCanceledException zagnieżdża TimeoutException element , który jest zgłaszany na platformie .NET 5 i nowszych wersjach.
Ta metoda jest przechowywana w zadaniu, które zwraca wszystkie wyjątki nieużytowe, które może zgłosić synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwracanym zadaniu, ten wyjątek zostanie zgłoszony podczas oczekiwania zadania. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. W przypadku przechowywanych wyjątków zobacz wyjątki zgłoszone przez Send(HttpRequestMessage, HttpCompletionOption)usługę .
Dotyczy
SendAsync(HttpRequestMessage, CancellationToken)
- Źródło:
- HttpClient.cs
- Źródło:
- HttpClient.cs
- Źródło:
- HttpClient.cs
Wyślij żądanie HTTP jako operację asynchroniczną.
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
Komunikat żądania HTTP do wysłania.
- cancellationToken
- CancellationToken
Token anulowania do anulowania operacji.
Zwraca
Obiekt zadania reprezentujący operację asynchroniczną.
Wyjątki
Wartość request to null.
Komunikat żądania został już wysłany przez HttpClient wystąpienie.
Żądanie nie powiodło się z powodu podstawowego problemu, takiego jak łączność sieciowa, niepowodzenie DNS, walidacja certyfikatu serwera lub przekroczenie limitu czasu.
Tylko platformy .NET Core i .NET 5 i nowsze: żądanie nie powiodło się z powodu przekroczenia limitu czasu.
Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwracanym zadaniu.
Uwagi
Ta operacja nie będzie blokować. Zwrócony obiekt zostanie ukończony Task<TResult> po odczytaniu całej odpowiedzi wraz z zawartością. Zachowanie jest takie samo, jak w przypadku ResponseContentRead jawnego określenia.
Uwaga
W przypadku przekroczenia limitu czasu różne wyjątki są zgłaszane w różnych implementacjach platformy .NET.
- HttpRequestExceptionjest zgłaszany we wszystkich odpowiednich wersjach .NET Framework.
- TaskCanceledException bez żadnego wyjątku wewnętrznego jest zgłaszany we wszystkich odpowiednich wersjach platformy .NET Core.
- TaskCanceledException zagnieżdża TimeoutException element , który jest zgłaszany na platformie .NET 5 i nowszych wersjach.
Ta metoda jest przechowywana w zadaniu, które zwraca wszystkie wyjątki nieużytowe, które może zgłosić synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwracanym zadaniu, ten wyjątek zostanie zgłoszony podczas oczekiwania zadania. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. W przypadku przechowywanych wyjątków zobacz wyjątki zgłoszone przez Send(HttpRequestMessage)usługę .
