HttpClient.SendAsync Metoda

Definicja

Przestrzeń nazw:

System.Net.Http

Zestaw:

System.Net.Http.dll

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

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

Task<HttpResponseMessage>

Obiekt zadania reprezentujący operację asynchroniczną.

Wyjątki

ArgumentNullException

Wartość request to null.

InvalidOperationException

Komunikat żądania został już wysłany przez HttpClient wystąpienie.

HttpRequestException

Żądanie nie powiodło się z powodu podstawowego problemu, takiego jak łączność sieciowa, niepowodzenie DNS, walidacja certyfikatu serwera lub przekroczenie limitu czasu.

TaskCanceledException

Tylko platformy .NET Core i .NET 5 i nowsze: żądanie nie powiodło się z powodu przekroczenia limitu czasu.

OperationCanceledException

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

SendAsync(HttpRequestMessage)

Ź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

Task<HttpResponseMessage>

Obiekt zadania reprezentujący operację asynchroniczną.

Wyjątki

ArgumentNullException

Wartość request to null.

InvalidOperationException

Komunikat żądania został już wysłany przez HttpClient wystąpienie.

HttpRequestException

Żądanie nie powiodło się z powodu podstawowego problemu, takiego jak łączność sieciowa, niepowodzenie DNS, walidacja certyfikatu serwera lub przekroczenie limitu czasu.

TaskCanceledException

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

SendAsync(HttpRequestMessage, HttpCompletionOption)

Ź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

Task<HttpResponseMessage>

Obiekt zadania reprezentujący operację asynchroniczną.

Wyjątki

ArgumentNullException

Wartość request to null.

InvalidOperationException

Komunikat żądania został już wysłany przez HttpClient wystąpienie.

HttpRequestException

Żądanie nie powiodło się z powodu podstawowego problemu, takiego jak łączność sieciowa, niepowodzenie DNS, walidacja certyfikatu serwera lub przekroczenie limitu czasu.

TaskCanceledException

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

SendAsync(HttpRequestMessage, CancellationToken)

Ź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

Task<HttpResponseMessage>

Obiekt zadania reprezentujący operację asynchroniczną.

Wyjątki

ArgumentNullException

Wartość request to null.

InvalidOperationException

Komunikat żądania został już wysłany przez HttpClient wystąpienie.

HttpRequestException

Żądanie nie powiodło się z powodu podstawowego problemu, takiego jak łączność sieciowa, niepowodzenie DNS, walidacja certyfikatu serwera lub przekroczenie limitu czasu.

TaskCanceledException

Tylko platformy .NET Core i .NET 5 i nowsze: żądanie nie powiodło się z powodu przekroczenia limitu czasu.

OperationCanceledException

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