HttpClient.Send Método

Definição

Espaço de Nomes:: System.Net.Http

Assemblagens:: netstandard.dll, System.Net.Http.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Sobrecargas

Name	Description
Send(HttpRequestMessage)	Envia um pedido HTTP com o pedido especificado.
Send(HttpRequestMessage, HttpCompletionOption)	Envia um pedido HTTP.
Send(HttpRequestMessage, CancellationToken)	Envia um pedido HTTP com o token de pedido e cancelamento especificados.
Send(HttpRequestMessage, HttpCompletionOption, CancellationToken)	Envia um pedido HTTP com o pedido especificado, opção de conclusão e token de cancelamento.

Send(HttpRequestMessage)

Origem:: HttpClient.cs

Origem:: HttpClient.cs

Origem:: HttpClient.cs

Origem:: HttpClient.cs

Origem:: HttpClient.cs

Envia um pedido HTTP com o pedido especificado.

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")]
[System.Runtime.Versioning.UnsupportedOSPlatform("android")]
[System.Runtime.Versioning.UnsupportedOSPlatform("ios")]
[System.Runtime.Versioning.UnsupportedOSPlatform("tvos")]
public System.Net.Http.HttpResponseMessage Send(System.Net.Http.HttpRequestMessage request);

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

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

override this.Send : System.Net.Http.HttpRequestMessage -> System.Net.Http.HttpResponseMessage

Public Function Send (request As HttpRequestMessage) As HttpResponseMessage

Parâmetros

request: HttpRequestMessage

A mensagem de pedido HTTP para enviar.

Devoluções

HttpResponseMessage

Uma mensagem de resposta HTTP.

Atributos: UnsupportedOSPlatformAttribute

Exceções

ArgumentNullException

O request é null.

NotSupportedException

A versão HTTP é 2.0 ou superior ou a política de versão está definida para RequestVersionOrHigher.

-ou-

A classe personalizada derivada de HttpContent não sobrepõe o SerializeToStream(Stream, TransportContext, CancellationToken) método.

-ou-

O costume HttpMessageHandler não sobrepõe o Send(HttpRequestMessage, CancellationToken) método.

InvalidOperationException

A mensagem de pedido já tinha sido enviada pela HttpClient instância.

HttpRequestException

O pedido falhou devido a um problema em obter uma resposta HTTP válida, como falha de conectividade de rede, falha DNS, erro de validação de certificado do servidor ou resposta inválida do servidor. Nas versões .NET 8 e posteriores, a razão é indicada por HttpRequestError.

OperationCanceledException

Se a OperationCanceledException exceção aninhar o TimeoutException: O pedido falhou devido ao timeout.

Aplica-se a

Send(HttpRequestMessage, HttpCompletionOption)

Origem:: HttpClient.cs

Origem:: HttpClient.cs

Origem:: HttpClient.cs

Origem:: HttpClient.cs

Origem:: HttpClient.cs

Envia um pedido 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")]
[System.Runtime.Versioning.UnsupportedOSPlatform("android")]
[System.Runtime.Versioning.UnsupportedOSPlatform("ios")]
[System.Runtime.Versioning.UnsupportedOSPlatform("tvos")]
public System.Net.Http.HttpResponseMessage Send(System.Net.Http.HttpRequestMessage request, System.Net.Http.HttpCompletionOption completionOption);

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

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

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

Parâmetros

request: HttpRequestMessage

A mensagem de pedido HTTP para enviar.

completionOption: HttpCompletionOption

Um dos valores de enumeração que especifica quando a operação deve ser concluída (assim que uma resposta estiver disponível ou após ler o conteúdo da resposta).

Devoluções

HttpResponseMessage

A mensagem de resposta HTTP.

Atributos: UnsupportedOSPlatformAttribute

Exceções

ArgumentNullException

O request é null.

NotSupportedException

A versão HTTP é 2.0 ou superior ou a política de versão está definida para RequestVersionOrHigher.

-ou-

A classe personalizada derivada de HttpContent não sobrepõe o SerializeToStream(Stream, TransportContext, CancellationToken) método.

-ou-

O costume HttpMessageHandler não sobrepõe o Send(HttpRequestMessage, CancellationToken) método.

InvalidOperationException

A mensagem de pedido já tinha sido enviada pela HttpClient instância.

HttpRequestException

OperationCanceledException

Se a OperationCanceledException exceção aninhar o TimeoutException: O pedido falhou devido ao timeout.

Aplica-se a

Send(HttpRequestMessage, CancellationToken)

Origem:: HttpClient.cs

Origem:: HttpClient.cs

Origem:: HttpClient.cs

Origem:: HttpClient.cs

Origem:: HttpClient.cs

Envia um pedido HTTP com o token de pedido e cancelamento especificados.

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")]
[System.Runtime.Versioning.UnsupportedOSPlatform("android")]
[System.Runtime.Versioning.UnsupportedOSPlatform("ios")]
[System.Runtime.Versioning.UnsupportedOSPlatform("tvos")]
public override System.Net.Http.HttpResponseMessage Send(System.Net.Http.HttpRequestMessage request, System.Threading.CancellationToken cancellationToken);

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

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

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

Parâmetros

request: HttpRequestMessage

A mensagem de pedido HTTP para enviar.

cancellationToken: CancellationToken

O token para cancelar a operação.

Devoluções

HttpResponseMessage

A mensagem de resposta HTTP.

Atributos: UnsupportedOSPlatformAttribute

Exceções

ArgumentNullException

O request é null.

NotSupportedException

A versão HTTP é 2.0 ou superior ou a política de versão está definida para RequestVersionOrHigher.

-ou-

A classe personalizada derivada de HttpContent não sobrepõe o SerializeToStream(Stream, TransportContext, CancellationToken) método.

-ou-

O costume HttpMessageHandler não sobrepõe o Send(HttpRequestMessage, CancellationToken) método.

InvalidOperationException

A mensagem de pedido já tinha sido enviada pela HttpClient instância.

HttpRequestException

OperationCanceledException

O token de cancelamento foi cancelado. Esta exceção é armazenada na tarefa devolvida.

-ou-

.NET Core e .NET 5 e posteriores apenas: O pedido falhou devido ao timeout.

Aplica-se a

Send(HttpRequestMessage, HttpCompletionOption, CancellationToken)

Origem:: HttpClient.cs

Origem:: HttpClient.cs

Origem:: HttpClient.cs

Origem:: HttpClient.cs

Origem:: HttpClient.cs

Envia um pedido HTTP com o pedido especificado, opção de conclusão e token de cancelamento.

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")]
[System.Runtime.Versioning.UnsupportedOSPlatform("android")]
[System.Runtime.Versioning.UnsupportedOSPlatform("ios")]
[System.Runtime.Versioning.UnsupportedOSPlatform("tvos")]
public System.Net.Http.HttpResponseMessage Send(System.Net.Http.HttpRequestMessage request, System.Net.Http.HttpCompletionOption completionOption, System.Threading.CancellationToken cancellationToken);

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

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

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

Parâmetros

request: HttpRequestMessage

A mensagem de pedido HTTP para enviar.

completionOption: HttpCompletionOption

Um dos valores de enumeração que especifica quando a operação deve ser concluída (assim que uma resposta estiver disponível ou após ler o conteúdo da resposta).

cancellationToken: CancellationToken

O token para cancelar a operação.

Devoluções

HttpResponseMessage

A mensagem de resposta HTTP.

Atributos: UnsupportedOSPlatformAttribute

Exceções

ArgumentNullException

O request é null.

NotSupportedException

A versão HTTP é 2.0 ou superior ou a política de versão está definida para RequestVersionOrHigher.

-ou-

A classe personalizada derivada de HttpContent não sobrepõe o SerializeToStream(Stream, TransportContext, CancellationToken) método.

-ou-

O costume HttpMessageHandler não sobrepõe o Send(HttpRequestMessage, CancellationToken) método.

InvalidOperationException

A mensagem de pedido já tinha sido enviada pela HttpClient instância.

HttpRequestException

OperationCanceledException

O token de cancelamento foi cancelado. Esta exceção é armazenada na tarefa devolvida.

-ou-

.NET Core e .NET 5 e posteriores apenas: O pedido falhou devido ao timeout.

Aplica-se a

Comentários

Esta página foi útil?