HttpClient.SendAsync Método
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.
| 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. |
Essa operação não será bloqueada.
- 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 posteriores: a solicitação falhou devido ao tempo limite.
O token de cancelamento foi cancelado. Essa exceção é armazenada na tarefa retornada.
Comentários
Essa 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 conteúdo, for lida.
Nota
No caso de tempo limite, diferentes exceções são geradas em diferentes implementações do .NET.
- HttpRequestExceptioné gerado em todas as versões .NET Framework aplicáveis.
- TaskCanceledException sem qualquer 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 versões posteriores.
Esse método armazena na tarefa que retorna todas as exceções de não uso que o equivalente síncrono 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
.NET 9 e outras versões
| Produto | Versões |
|---|---|
| .NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
| .NET Framework | 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1 |
| UWP | 10.0 |
- 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 posteriores: a solicitação falhou devido ao tempo limite.
Comentários
Essa 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.
Nota
No caso de tempo limite, diferentes exceções são geradas em diferentes implementações do .NET.
- HttpRequestExceptioné gerado em todas as versões .NET Framework aplicáveis.
- TaskCanceledException sem qualquer 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 versões posteriores.
Esse método armazena na tarefa que retorna todas as exceções de não uso que o equivalente síncrono 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
.NET 9 e outras versões
| Produto | Versões |
|---|---|
| .NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
| .NET Framework | 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1 |
| UWP | 10.0 |
- 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 posteriores: a solicitação falhou devido ao tempo limite.
Comentários
Essa 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 conteúdo, for lida.
Nota
No caso de tempo limite, diferentes exceções são geradas em diferentes implementações do .NET.
- HttpRequestExceptioné gerado em todas as versões .NET Framework aplicáveis.
- TaskCanceledException sem qualquer 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 versões posteriores.
Esse método armazena na tarefa que retorna todas as exceções de não uso que o equivalente síncrono 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
.NET 9 e outras versões
| Produto | Versões |
|---|---|
| .NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
| .NET Framework | 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1 |
| UWP | 10.0 |
- 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 posteriores: a solicitação falhou devido ao tempo limite.
O token de cancelamento foi cancelado. Essa exceção é armazenada na tarefa retornada.
Comentários
Essa 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.
Nota
No caso de tempo limite, diferentes exceções são geradas em diferentes implementações do .NET.
- HttpRequestExceptioné gerado em todas as versões .NET Framework aplicáveis.
- TaskCanceledException sem qualquer 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 versões posteriores.
Esse método armazena na tarefa que retorna todas as exceções de não uso que o equivalente síncrono 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
.NET 9 e outras versões
| Produto | Versões |
|---|---|
| .NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9 |
| .NET Framework | 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1 |
| UWP | 10.0 |
Comentários do .NET
O .NET é um projeto código aberto. Selecione um link para fornecer comentários: