HttpClient.Send 方法

定义

命名空间:

System.Net.Http

程序集:

System.Net.Http.dll

重载

Send(HttpRequestMessage)	发送带有指定请求的 HTTP 请求。
Send(HttpRequestMessage, HttpCompletionOption)	发送 HTTP 请求。
Send(HttpRequestMessage, CancellationToken)	发送带有指定请求和取消标记的 HTTP 请求。
Send(HttpRequestMessage, HttpCompletionOption, CancellationToken)	发送带有指定请求、完成选项和取消标记的 HTTP 请求。

Send(HttpRequestMessage)

Source:

HttpClient.cs

发送带有指定请求的 HTTP 请求。

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

参数

request

HttpRequestMessage

要发送的 HTTP 请求消息。

返回

HttpResponseMessage

HTTP 响应消息。

属性

UnsupportedOSPlatformAttribute

例外

ArgumentNullException

request 为 null。

NotSupportedException

HTTP 版本为 2.0 或更高版本，或者版本策略设置为 RequestVersionOrHigher。

或

派生自 HttpContent 的自定义类不会重写 SerializeToStream(Stream, TransportContext, CancellationToken) 方法。

或

自定义 HttpMessageHandler 不会重写 Send(HttpRequestMessage, CancellationToken) 方法。

InvalidOperationException

请求消息已由 HttpClient 实例发送。

HttpRequestException

由于基础问题（如网络连接性、DNS 失败或服务器证书验证），请求失败。

TaskCanceledException

如果 TaskCanceledException 异常会嵌套 TimeoutException：请求因超时而失败。

Send(HttpRequestMessage, HttpCompletionOption)

Source:

HttpClient.cs

发送 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

参数

request

HttpRequestMessage

要发送的 HTTP 请求消息。

completionOption

HttpCompletionOption

枚举值之一，用于指定操作应完成的时间（在响应可用或在读取响应内容之后）。

返回

HttpResponseMessage

HTTP 响应消息。

属性

UnsupportedOSPlatformAttribute

例外

ArgumentNullException

request 为 null。

NotSupportedException

HTTP 版本为 2.0 或更高版本，或者版本策略设置为 RequestVersionOrHigher。

或

派生自 HttpContent 的自定义类不会重写 SerializeToStream(Stream, TransportContext, CancellationToken) 方法。

或

自定义 HttpMessageHandler 不会重写 Send(HttpRequestMessage, CancellationToken) 方法。

InvalidOperationException

请求消息已由 HttpClient 实例发送。

HttpRequestException

由于基础问题（如网络连接性、DNS 失败或服务器证书验证），请求失败。

TaskCanceledException

如果 TaskCanceledException 异常会嵌套 TimeoutException：请求因超时而失败。

Send(HttpRequestMessage, CancellationToken)

Source:

HttpClient.cs

发送带有指定请求和取消标记的 HTTP 请求。

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

参数

request

HttpRequestMessage

要发送的 HTTP 请求消息。

cancellationToken

CancellationToken

用于取消此操作的令牌。

返回

HttpResponseMessage

HTTP 响应消息。

属性

UnsupportedOSPlatformAttribute

例外

ArgumentNullException

request 为 null。

NotSupportedException

HTTP 版本为 2.0 或更高版本，或者版本策略设置为 RequestVersionOrHigher。

或

派生自 HttpContent 的自定义类不会重写 SerializeToStream(Stream, TransportContext, CancellationToken) 方法。

或

自定义 HttpMessageHandler 不会重写 Send(HttpRequestMessage, CancellationToken) 方法。

InvalidOperationException

请求消息已由 HttpClient 实例发送。

HttpRequestException

由于基础问题（如网络连接性、DNS 失败或服务器证书验证），请求失败。

TaskCanceledException

请求已被取消。

或

如果 TaskCanceledException 异常会嵌套 TimeoutException：请求因超时而失败。

OperationCanceledException

取消令牌已取消。 此异常存储在返回的任务中。

Send(HttpRequestMessage, HttpCompletionOption, CancellationToken)

Source:

HttpClient.cs

发送带有指定请求、完成选项和取消标记的 HTTP 请求。

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

参数

request

HttpRequestMessage

要发送的 HTTP 请求消息。

completionOption

HttpCompletionOption

枚举值之一，用于指定操作应完成的时间（在响应可用或在读取响应内容之后）。

cancellationToken

CancellationToken

用于取消此操作的令牌。

返回

HttpResponseMessage

HTTP 响应消息。

属性

UnsupportedOSPlatformAttribute

例外

ArgumentNullException

request 为 null。

NotSupportedException

HTTP 版本为 2.0 或更高版本，或者版本策略设置为 RequestVersionOrHigher。

或

派生自 HttpContent 的自定义类不会重写 SerializeToStream(Stream, TransportContext, CancellationToken) 方法。

或

自定义 HttpMessageHandler 不会重写 Send(HttpRequestMessage, CancellationToken) 方法。

InvalidOperationException

请求消息已由 HttpClient 实例发送。

HttpRequestException

由于基础问题（如网络连接性、DNS 失败或服务器证书验证），请求失败。

TaskCanceledException

请求已被取消。

或

如果 TaskCanceledException 异常会嵌套 TimeoutException：请求因超时而失败。

OperationCanceledException

取消令牌已取消。 此异常存储在返回的任务中。