HttpClient.Send Metoda

Definicja

Przestrzeń nazw:

System.Net.Http

Zestawy:

netstandard.dll, System.Net.Http.dll

Przeciążenia

Nazwa	Opis
Send(HttpRequestMessage)	Wysyła żądanie HTTP z określonym żądaniem.
Send(HttpRequestMessage, HttpCompletionOption)	Wysyła żądanie HTTP.
Send(HttpRequestMessage, CancellationToken)	Wysyła żądanie HTTP z określonym żądaniem i tokenem anulowania.
Send(HttpRequestMessage, HttpCompletionOption, CancellationToken)	Wysyła żądanie HTTP z określonym żądaniem, opcją ukończenia i tokenem anulowania.

Send(HttpRequestMessage)

Źródło:

HttpClient.cs

Wysyła żądanie HTTP z określonym żądaniem.

public:
 System::Net::Http::HttpResponseMessage ^ Send(System::Net::Http::HttpRequestMessage ^ request);

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public System.Net.Http.HttpResponseMessage Send(System.Net.Http.HttpRequestMessage request);

[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
override this.Send : System.Net.Http.HttpRequestMessage -> System.Net.Http.HttpResponseMessage

Public Function Send (request As HttpRequestMessage) As HttpResponseMessage

Parametry

request

HttpRequestMessage

Komunikat żądania HTTP do wysłania.

Zwraca

HttpResponseMessage

Komunikat odpowiedzi HTTP.

Atrybuty

UnsupportedOSPlatformAttribute

Wyjątki

ArgumentNullException

request jest null.

NotSupportedException

Wersja HTTP to 2.0 lub nowsza lub ustawiona jest wartość RequestVersionOrHigher.

— lub —

Klasa niestandardowa pochodząca z HttpContent klasy nie zastępuje SerializeToStream(Stream, TransportContext, CancellationToken) metody .

— lub —

HttpMessageHandler Niestandardowa metoda nie zastępuje Send(HttpRequestMessage, CancellationToken) metody .

InvalidOperationException

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

HttpRequestException

Żądanie nie powiodło się z powodu problemu z uzyskaniem prawidłowej odpowiedzi HTTP, takiej jak błąd łączności sieciowej, błąd DNS, błąd weryfikacji certyfikatu serwera lub nieprawidłowa odpowiedź serwera. W .NET 8 lub nowszych wersjach przyczyną jest HttpRequestError.

OperationCanceledException

OperationCanceledException Jeśli wyjątek zagnieżdża TimeoutExceptionwartość : Żądanie nie powiodło się z powodu przekroczenia limitu czasu.

Send(HttpRequestMessage, HttpCompletionOption)

Źródło:

HttpClient.cs

Wysyła żądanie HTTP.

public:
 System::Net::Http::HttpResponseMessage ^ Send(System::Net::Http::HttpRequestMessage ^ request, System::Net::Http::HttpCompletionOption completionOption);

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public System.Net.Http.HttpResponseMessage Send(System.Net.Http.HttpRequestMessage request, System.Net.Http.HttpCompletionOption completionOption);

[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
override this.Send : System.Net.Http.HttpRequestMessage * System.Net.Http.HttpCompletionOption -> System.Net.Http.HttpResponseMessage

Public Function Send (request As HttpRequestMessage, completionOption As HttpCompletionOption) As HttpResponseMessage

Parametry

request

HttpRequestMessage

Komunikat żądania HTTP do wysłania.

completionOption

HttpCompletionOption

Jedna z wartości wyliczenia, która określa, kiedy operacja powinna zostać ukończona (gdy tylko odpowiedź jest dostępna lub po przeczytaniu zawartości odpowiedzi).

Zwraca

HttpResponseMessage

Komunikat odpowiedzi HTTP.

Atrybuty

UnsupportedOSPlatformAttribute

Wyjątki

ArgumentNullException

request jest null.

NotSupportedException

Wersja HTTP to 2.0 lub nowsza lub ustawiona jest wartość RequestVersionOrHigher.

— lub —

Klasa niestandardowa pochodząca z HttpContent klasy nie zastępuje SerializeToStream(Stream, TransportContext, CancellationToken) metody .

— lub —

HttpMessageHandler Niestandardowa metoda nie zastępuje Send(HttpRequestMessage, CancellationToken) metody .

InvalidOperationException

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

HttpRequestException

Żądanie nie powiodło się z powodu problemu z uzyskaniem prawidłowej odpowiedzi HTTP, takiej jak błąd łączności sieciowej, błąd DNS, błąd weryfikacji certyfikatu serwera lub nieprawidłowa odpowiedź serwera. W .NET 8 lub nowszych wersjach przyczyną jest HttpRequestError.

OperationCanceledException

OperationCanceledException Jeśli wyjątek zagnieżdża TimeoutExceptionwartość : Żądanie nie powiodło się z powodu przekroczenia limitu czasu.

Send(HttpRequestMessage, CancellationToken)

Źródło:

HttpClient.cs

Wysyła żądanie HTTP z określonym żądaniem i tokenem anulowania.

public:
 override System::Net::Http::HttpResponseMessage ^ Send(System::Net::Http::HttpRequestMessage ^ request, System::Threading::CancellationToken cancellationToken);

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public override System.Net.Http.HttpResponseMessage Send(System.Net.Http.HttpRequestMessage request, System.Threading.CancellationToken cancellationToken);

[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
override this.Send : System.Net.Http.HttpRequestMessage * System.Threading.CancellationToken -> System.Net.Http.HttpResponseMessage

Public Overrides Function Send (request As HttpRequestMessage, cancellationToken As CancellationToken) As HttpResponseMessage

Parametry

request

HttpRequestMessage

Komunikat żądania HTTP do wysłania.

cancellationToken

CancellationToken

Token umożliwiający anulowanie operacji.

Zwraca

HttpResponseMessage

Komunikat odpowiedzi HTTP.

Atrybuty

UnsupportedOSPlatformAttribute

Wyjątki

ArgumentNullException

request jest null.

NotSupportedException

Wersja HTTP to 2.0 lub nowsza lub ustawiona jest wartość RequestVersionOrHigher.

— lub —

Klasa niestandardowa pochodząca z HttpContent klasy nie zastępuje SerializeToStream(Stream, TransportContext, CancellationToken) metody .

— lub —

HttpMessageHandler Niestandardowa metoda nie zastępuje Send(HttpRequestMessage, CancellationToken) metody .

InvalidOperationException

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

HttpRequestException

Żądanie nie powiodło się z powodu problemu z uzyskaniem prawidłowej odpowiedzi HTTP, takiej jak błąd łączności sieciowej, błąd DNS, błąd weryfikacji certyfikatu serwera lub nieprawidłowa odpowiedź serwera. W .NET 8 lub nowszych wersjach przyczyną jest HttpRequestError.

OperationCanceledException

Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwracanym zadaniu.

— lub —

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

Send(HttpRequestMessage, HttpCompletionOption, CancellationToken)

Źródło:

HttpClient.cs

Wysyła żądanie HTTP z określonym żądaniem, opcją ukończenia i tokenem anulowania.

public:
 System::Net::Http::HttpResponseMessage ^ Send(System::Net::Http::HttpRequestMessage ^ request, System::Net::Http::HttpCompletionOption completionOption, System::Threading::CancellationToken cancellationToken);

[System.Runtime.Versioning.UnsupportedOSPlatform("browser")]
public System.Net.Http.HttpResponseMessage Send(System.Net.Http.HttpRequestMessage request, System.Net.Http.HttpCompletionOption completionOption, System.Threading.CancellationToken cancellationToken);

[<System.Runtime.Versioning.UnsupportedOSPlatform("browser")>]
override this.Send : System.Net.Http.HttpRequestMessage * System.Net.Http.HttpCompletionOption * System.Threading.CancellationToken -> System.Net.Http.HttpResponseMessage

Public Function Send (request As HttpRequestMessage, completionOption As HttpCompletionOption, cancellationToken As CancellationToken) As HttpResponseMessage

Parametry

request

HttpRequestMessage

Komunikat żądania HTTP do wysłania.

completionOption

HttpCompletionOption

Jedna z wartości wyliczenia, która określa, kiedy operacja powinna zostać ukończona (gdy tylko odpowiedź jest dostępna lub po przeczytaniu zawartości odpowiedzi).

cancellationToken

CancellationToken

Token umożliwiający anulowanie operacji.

Zwraca

HttpResponseMessage

Komunikat odpowiedzi HTTP.

Atrybuty

UnsupportedOSPlatformAttribute

Wyjątki

ArgumentNullException

request jest null.

NotSupportedException

Wersja HTTP to 2.0 lub nowsza lub ustawiona jest wartość RequestVersionOrHigher.

— lub —

Klasa niestandardowa pochodząca z HttpContent klasy nie zastępuje SerializeToStream(Stream, TransportContext, CancellationToken) metody .

— lub —

HttpMessageHandler Niestandardowa metoda nie zastępuje Send(HttpRequestMessage, CancellationToken) metody .

InvalidOperationException

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

HttpRequestException

Żądanie nie powiodło się z powodu problemu z uzyskaniem prawidłowej odpowiedzi HTTP, takiej jak błąd łączności sieciowej, błąd DNS, błąd weryfikacji certyfikatu serwera lub nieprawidłowa odpowiedź serwera. W .NET 8 lub nowszych wersjach przyczyną jest HttpRequestError.

OperationCanceledException

Token anulowania został anulowany. Ten wyjątek jest przechowywany w zwracanym zadaniu.

— lub —

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