HttpClient.Send Método

Definição

Namespace:: System.Net.Http

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

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Sobrecargas

Nome	Description
Send(HttpRequestMessage)	Envia uma solicitação HTTP com a solicitação especificada.
Send(HttpRequestMessage, HttpCompletionOption)	Envia uma solicitação HTTP.
Send(HttpRequestMessage, CancellationToken)	Envia uma solicitação HTTP com o token de solicitação e cancelamento especificados.
Send(HttpRequestMessage, HttpCompletionOption, CancellationToken)	Envia uma solicitação HTTP com a solicitação, a opção de conclusão e o token de cancelamento especificados.

Send(HttpRequestMessage)

Origem:: HttpClient.cs

Origem:: HttpClient.cs

Origem:: HttpClient.cs

Origem:: HttpClient.cs

Origem:: HttpClient.cs

Envia uma solicitação HTTP com a solicitação especificada.

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 solicitação HTTP a ser enviada.

Retornos

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 é definida como RequestVersionOrHigher.

- ou -

A classe personalizada derivada HttpContent não substitui o SerializeToStream(Stream, TransportContext, CancellationToken) método.

- ou -

O personalizado HttpMessageHandler não substitui o Send(HttpRequestMessage, CancellationToken) método.

InvalidOperationException

A mensagem de solicitação já foi enviada pela HttpClient instância.

HttpRequestException

A solicitação falhou devido a um problema ao obter uma resposta HTTP válida, como falha de conectividade de rede, falha de DNS, erro de validação de certificado do servidor ou resposta inválida do servidor. Em .NET 8 e versões posteriores, o motivo é indicado por HttpRequestError.

OperationCanceledException

Se a OperationCanceledException exceção aninhar : TimeoutExceptiona solicitação falhou devido ao tempo limite.

Aplica-se a

Send(HttpRequestMessage, HttpCompletionOption)

Origem:: HttpClient.cs

Origem:: HttpClient.cs

Origem:: HttpClient.cs

Origem:: HttpClient.cs

Origem:: HttpClient.cs

Envia uma solicitação 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 solicitação HTTP a ser enviada.

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 depois de ler o conteúdo da resposta).

Retornos

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 é definida como RequestVersionOrHigher.

- ou -

A classe personalizada derivada HttpContent não substitui o SerializeToStream(Stream, TransportContext, CancellationToken) método.

- ou -

O personalizado HttpMessageHandler não substitui o Send(HttpRequestMessage, CancellationToken) método.

InvalidOperationException

A mensagem de solicitação já foi enviada pela HttpClient instância.

HttpRequestException

OperationCanceledException

Se a OperationCanceledException exceção aninhar : TimeoutExceptiona solicitação falhou devido ao tempo limite.

Aplica-se a

Send(HttpRequestMessage, CancellationToken)

Origem:: HttpClient.cs

Origem:: HttpClient.cs

Origem:: HttpClient.cs

Origem:: HttpClient.cs

Origem:: HttpClient.cs

Envia uma solicitação HTTP com o token de solicitação 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 solicitação HTTP a ser enviada.

cancellationToken: CancellationToken

O token para cancelar a operação.

Retornos

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 é definida como RequestVersionOrHigher.

- ou -

A classe personalizada derivada HttpContent não substitui o SerializeToStream(Stream, TransportContext, CancellationToken) método.

- ou -

O personalizado HttpMessageHandler não substitui o Send(HttpRequestMessage, CancellationToken) método.

InvalidOperationException

A mensagem de solicitação já foi enviada pela HttpClient instância.

HttpRequestException

OperationCanceledException

O token de cancelamento foi cancelado. Essa exceção é armazenada na tarefa retornada.

- ou -

.NET Core e .NET 5 e posterior somente: a solicitação falhou devido ao tempo limite.

Aplica-se a

Send(HttpRequestMessage, HttpCompletionOption, CancellationToken)

Origem:: HttpClient.cs

Origem:: HttpClient.cs

Origem:: HttpClient.cs

Origem:: HttpClient.cs

Origem:: HttpClient.cs

Envia uma solicitação HTTP com a solicitação, a opção de conclusão e o token de cancelamento especificados.

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 solicitação HTTP a ser enviada.

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 depois de ler o conteúdo da resposta).

cancellationToken: CancellationToken

O token para cancelar a operação.

Retornos

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 é definida como RequestVersionOrHigher.

- ou -

A classe personalizada derivada HttpContent não substitui o SerializeToStream(Stream, TransportContext, CancellationToken) método.

- ou -

O personalizado HttpMessageHandler não substitui o Send(HttpRequestMessage, CancellationToken) método.

InvalidOperationException

A mensagem de solicitação já foi enviada pela HttpClient instância.

HttpRequestException

OperationCanceledException

O token de cancelamento foi cancelado. Essa exceção é armazenada na tarefa retornada.

- ou -

.NET Core e .NET 5 e posterior somente: a solicitação falhou devido ao tempo limite.

Aplica-se a

Comentários

Esta página foi útil?