HttpClient.SendAsync Metoda

Definicja

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)

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 odpowiedź jest dostępna lub po odczytaniu całej zawartości odpowiedzi).

cancellationToken
CancellationToken

Token anulowania do anulowania operacji.

Zwraca

Obiekt zadania reprezentujący operację asynchroniczną.

Wyjątki

Element 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, awaria DNS, walidacja certyfikatu serwera lub przekroczenie limitu czasu.

Tylko programy .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 zwróconym 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 zaraz po udostępnieniu odpowiedzi lub 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.

Ta metoda przechowuje w zadaniu wszystkie wyjątki inne niż użycie, które mogą zgłaszać synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony po oczekiwaniu na zadanie. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. Aby uzyskać informacje o przechowywanych wyjątkach, zobacz wyjątki zgłaszane przez Send(HttpRequestMessage, HttpCompletionOption)usługę .

Dotyczy

SendAsync(HttpRequestMessage)

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

Element 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, awaria DNS, walidacja certyfikatu serwera lub przekroczenie limitu czasu.

Tylko programy .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, w tym 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.

Ta metoda przechowuje w zadaniu wszystkie wyjątki inne niż użycie, które mogą zgłaszać synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony po oczekiwaniu na zadanie. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. Aby uzyskać informacje o przechowywanych wyjątkach, zobacz wyjątki zgłaszane przez Send(HttpRequestMessage)usługę .

Dotyczy

SendAsync(HttpRequestMessage, HttpCompletionOption)

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 odpowiedź jest dostępna lub po odczytaniu całej zawartości odpowiedzi).

Zwraca

Obiekt zadania reprezentujący operację asynchroniczną.

Wyjątki

Element 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, awaria DNS, walidacja certyfikatu serwera lub przekroczenie limitu czasu.

Tylko programy .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 zaraz po udostępnieniu odpowiedzi lub 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.

Ta metoda przechowuje w zadaniu wszystkie wyjątki inne niż użycie, które mogą zgłaszać synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony po oczekiwaniu na zadanie. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. Aby uzyskać informacje o przechowywanych wyjątkach, zobacz wyjątki zgłaszane przez Send(HttpRequestMessage, HttpCompletionOption)usługę .

Dotyczy

SendAsync(HttpRequestMessage, CancellationToken)

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

Element 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, awaria DNS, walidacja certyfikatu serwera lub przekroczenie limitu czasu.

Tylko programy .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 zwróconym zadaniu.

Uwagi

Ta operacja nie będzie blokować. Zwrócony obiekt zostanie ukończony Task<TResult> po odczytaniu całej odpowiedzi, w tym 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.

Ta metoda przechowuje w zadaniu wszystkie wyjątki inne niż użycie, które mogą zgłaszać synchroniczna odpowiednik metody. Jeśli wyjątek jest przechowywany w zwróconym zadaniu, ten wyjątek zostanie zgłoszony po oczekiwaniu na zadanie. Wyjątki użycia, takie jak ArgumentException, są nadal zgłaszane synchronicznie. Aby uzyskać informacje o przechowywanych wyjątkach, zobacz wyjątki zgłaszane przez Send(HttpRequestMessage)usługę .

Dotyczy