Udostępnij za pośrednictwem


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)

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

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.

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.

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.

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