HttpClient.SendAsync Método
Definição
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.
Envie uma solicitação HTTP como uma operação assíncrona.
Sobrecargas
| SendAsync(HttpRequestMessage, HttpCompletionOption, CancellationToken) |
Envie uma solicitação HTTP como uma operação assíncrona. |
| SendAsync(HttpRequestMessage) |
Envie uma solicitação HTTP como uma operação assíncrona. |
| SendAsync(HttpRequestMessage, HttpCompletionOption) |
Envie uma solicitação HTTP como uma operação assíncrona. |
| SendAsync(HttpRequestMessage, CancellationToken) |
Envie uma solicitação HTTP como uma operação assíncrona. |
Comentários
Esta operação não será bloqueada.
SendAsync(HttpRequestMessage, HttpCompletionOption, CancellationToken)
- Origem:
- HttpClient.cs
- Origem:
- HttpClient.cs
- Origem:
- HttpClient.cs
Envie uma solicitação HTTP como uma operação assíncrona.
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)Parâmetros
- request
- HttpRequestMessage
A mensagem de solicitação HTTP a ser enviada.
- completionOption
- HttpCompletionOption
Quando a operação deve ser concluída (assim que uma resposta estiver disponível ou após a leitura de todo o conteúdo da resposta).
- cancellationToken
- CancellationToken
O token de cancelamento para cancelar a operação.
Retornos
O objeto de tarefa que representa a operação assíncrona.
Exceções
O request é null.
A mensagem de solicitação já foi enviada pela instância HttpClient.
A solicitação falhou devido a um problema subjacente, como conectividade de rede, falha de DNS, validação de certificado do servidor ou tempo limite.
Somente .NET Core e .NET 5 e posterior: a solicitação falhou devido ao tempo limite.
O token de cancelamento foi cancelado. Essa exceção é armazenada na tarefa retornada.
Comentários
Esta operação não será bloqueada. Dependendo do valor do completionOption parâmetro, o objeto retornado Task<TResult> será concluído assim que uma resposta estiver disponível ou toda a resposta, incluindo o conteúdo, for lida.
Observação
No caso de tempo limite, exceções diferentes são geradas em diferentes implementações do .NET.
- HttpRequestExceptioné lançado em todas as versões de .NET Framework aplicáveis.
- TaskCanceledException sem nenhuma exceção interna é gerada em todas as versões aplicáveis do .NET Core.
- TaskCanceledException que aninha um TimeoutException é lançado no .NET 5 e em versões posteriores.
Esse método armazena na tarefa que retorna todas as exceções de não uso que a contraparte síncrona do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas por Send(HttpRequestMessage, HttpCompletionOption).
Aplica-se a
SendAsync(HttpRequestMessage)
- Origem:
- HttpClient.cs
- Origem:
- HttpClient.cs
- Origem:
- HttpClient.cs
Envie uma solicitação HTTP como uma operação assíncrona.
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)Parâmetros
- request
- HttpRequestMessage
A mensagem de solicitação HTTP a ser enviada.
Retornos
O objeto de tarefa que representa a operação assíncrona.
Exceções
O request é null.
A mensagem de solicitação já foi enviada pela instância HttpClient.
A solicitação falhou devido a um problema subjacente, como conectividade de rede, falha de DNS, validação de certificado do servidor ou tempo limite.
Somente .NET Core e .NET 5 e posterior: a solicitação falhou devido ao tempo limite.
Comentários
Esta operação não será bloqueada. O objeto retornado Task<TResult> será concluído depois que toda a resposta, incluindo conteúdo, for lida. O comportamento é o mesmo que se ResponseContentRead tiver sido especificado explicitamente.
Observação
No caso de tempo limite, exceções diferentes são geradas em diferentes implementações do .NET.
- HttpRequestExceptioné lançado em todas as versões de .NET Framework aplicáveis.
- TaskCanceledException sem nenhuma exceção interna é gerada em todas as versões aplicáveis do .NET Core.
- TaskCanceledException que aninha um TimeoutException é lançado no .NET 5 e em versões posteriores.
Esse método armazena na tarefa que retorna todas as exceções de não uso que a contraparte síncrona do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas por Send(HttpRequestMessage).
Aplica-se a
SendAsync(HttpRequestMessage, HttpCompletionOption)
- Origem:
- HttpClient.cs
- Origem:
- HttpClient.cs
- Origem:
- HttpClient.cs
Envie uma solicitação HTTP como uma operação assíncrona.
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)Parâmetros
- request
- HttpRequestMessage
A mensagem de solicitação HTTP a ser enviada.
- completionOption
- HttpCompletionOption
Quando a operação deve ser concluída (assim que uma resposta estiver disponível ou após a leitura de todo o conteúdo da resposta).
Retornos
O objeto de tarefa que representa a operação assíncrona.
Exceções
O request é null.
A mensagem de solicitação já foi enviada pela instância HttpClient.
A solicitação falhou devido a um problema subjacente, como conectividade de rede, falha de DNS, validação de certificado do servidor ou tempo limite.
Somente .NET Core e .NET 5 e posterior: a solicitação falhou devido ao tempo limite.
Comentários
Esta operação não será bloqueada. Dependendo do valor do completionOption parâmetro, o objeto retornado Task<TResult> será concluído assim que uma resposta estiver disponível ou toda a resposta, incluindo o conteúdo, for lida.
Observação
No caso de tempo limite, exceções diferentes são geradas em diferentes implementações do .NET.
- HttpRequestExceptioné lançado em todas as versões de .NET Framework aplicáveis.
- TaskCanceledException sem nenhuma exceção interna é gerada em todas as versões aplicáveis do .NET Core.
- TaskCanceledException que aninha um TimeoutException é lançado no .NET 5 e em versões posteriores.
Esse método armazena na tarefa que retorna todas as exceções de não uso que a contraparte síncrona do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas por Send(HttpRequestMessage, HttpCompletionOption).
Aplica-se a
SendAsync(HttpRequestMessage, CancellationToken)
- Origem:
- HttpClient.cs
- Origem:
- HttpClient.cs
- Origem:
- HttpClient.cs
Envie uma solicitação HTTP como uma operação assíncrona.
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)Parâmetros
- request
- HttpRequestMessage
A mensagem de solicitação HTTP a ser enviada.
- cancellationToken
- CancellationToken
O token de cancelamento para cancelar a operação.
Retornos
O objeto de tarefa que representa a operação assíncrona.
Exceções
O request é null.
A mensagem de solicitação já foi enviada pela instância HttpClient.
A solicitação falhou devido a um problema subjacente, como conectividade de rede, falha de DNS, validação de certificado do servidor ou tempo limite.
Somente .NET Core e .NET 5 e posterior: a solicitação falhou devido ao tempo limite.
O token de cancelamento foi cancelado. Essa exceção é armazenada na tarefa retornada.
Comentários
Esta operação não será bloqueada. O objeto retornado Task<TResult> será concluído depois que toda a resposta, incluindo conteúdo, for lida. O comportamento é o mesmo que se ResponseContentRead tiver sido especificado explicitamente.
Observação
No caso de tempo limite, exceções diferentes são geradas em diferentes implementações do .NET.
- HttpRequestExceptioné lançado em todas as versões de .NET Framework aplicáveis.
- TaskCanceledException sem nenhuma exceção interna é gerada em todas as versões aplicáveis do .NET Core.
- TaskCanceledException que aninha um TimeoutException é lançado no .NET 5 e em versões posteriores.
Esse método armazena na tarefa que retorna todas as exceções de não uso que a contraparte síncrona do método pode gerar. Se uma exceção for armazenada na tarefa retornada, essa exceção será gerada quando a tarefa for aguardada. Exceções de uso, como ArgumentException, ainda são geradas de forma síncrona. Para as exceções armazenadas, consulte as exceções geradas por Send(HttpRequestMessage).
Aplica-se a
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de