HttpClient.GetAsync 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 GET para o URI especificado como uma operação assíncrona.
Sobrecargas
| Nome | Description |
|---|---|
| GetAsync(String) |
Envie uma solicitação GET para o URI especificado como uma operação assíncrona. |
| GetAsync(Uri) |
Envie uma solicitação GET para o URI especificado como uma operação assíncrona. |
| GetAsync(String, HttpCompletionOption) |
Envie uma solicitação GET para o URI especificado com uma opção de conclusão HTTP como uma operação assíncrona. |
| GetAsync(String, CancellationToken) |
Envie uma solicitação GET para o URI especificado com um token de cancelamento como uma operação assíncrona. |
| GetAsync(Uri, HttpCompletionOption) |
Envie uma solicitação GET para o URI especificado com uma opção de conclusão HTTP como uma operação assíncrona. |
| GetAsync(Uri, CancellationToken) |
Envie uma solicitação GET para o URI especificado com um token de cancelamento como uma operação assíncrona. |
| GetAsync(String, HttpCompletionOption, CancellationToken) |
Envie uma solicitação GET para o URI especificado com uma opção de conclusão HTTP e um token de cancelamento como uma operação assíncrona. |
| GetAsync(Uri, HttpCompletionOption, CancellationToken) |
Envie uma solicitação GET para o URI especificado com uma opção de conclusão HTTP e um token de cancelamento como uma operação assíncrona. |
Comentários
A operação não será bloqueada.
GetAsync(String)
Envie uma solicitação GET para o URI especificado como uma operação assíncrona.
public:
System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ GetAsync(System::String ^ requestUri);public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync(string requestUri);member this.GetAsync : string -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>Public Function GetAsync (requestUri As String) As Task(Of HttpResponseMessage)Parâmetros
- requestUri
- String
O URI para o qual a solicitação é enviada.
Retornos
O objeto de tarefa que representa a operação assíncrona.
Exceções
O requestUri URI não é absoluto e BaseAddress não está definido.
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 versões .NET 8 e posteriores, o motivo é indicado por HttpRequestError
-ou-
somente .NET Framework: a solicitação atingiu o tempo limite.
.NET Core e .NET 5 e posterior somente: a solicitação falhou devido ao tempo limite.
O URI de solicitação fornecido não é URI relativo ou absoluto válido.
Comentários
Essa operação não é 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 foi especificado explicitamente.
Note
Em caso de tempo limite, exceções diferentes são geradas em diferentes implementações de .NET.
- HttpRequestException é lançada em todas as versões do .NET Framework aplicáveis.
- OperationCanceledException sem nenhuma exceção interna é lançada em todas as versões do .NET Core aplicáveis.
- OperationCanceledException que aninha um TimeoutException é lançado em versões .NET 5 e posteriores.
Aplica-se a
GetAsync(Uri)
Envie uma solicitação GET para o URI especificado como uma operação assíncrona.
public:
System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ GetAsync(Uri ^ requestUri);public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync(Uri requestUri);member this.GetAsync : Uri -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>Public Function GetAsync (requestUri As Uri) As Task(Of HttpResponseMessage)Parâmetros
- requestUri
- Uri
O URI para o qual a solicitação é enviada.
Retornos
O objeto de tarefa que representa a operação assíncrona.
Exceções
O requestUri URI não é absoluto e BaseAddress não está definido.
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 versões .NET 8 e posteriores, o motivo é indicado por HttpRequestError
-ou-
somente .NET Framework: a solicitação atingiu o tempo limite.
.NET Core e .NET 5 e posterior somente: a solicitação falhou devido ao tempo limite.
Comentários
Essa operação não é 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 foi especificado explicitamente.
Note
Em caso de tempo limite, exceções diferentes são geradas em diferentes implementações de .NET.
- HttpRequestException é lançada em todas as versões do .NET Framework aplicáveis.
- OperationCanceledException sem nenhuma exceção interna é lançada em todas as versões do .NET Core aplicáveis.
- OperationCanceledException que aninha um TimeoutException é lançado em versões .NET 5 e posteriores.
Aplica-se a
GetAsync(String, HttpCompletionOption)
Envie uma solicitação GET para o URI especificado com uma opção de conclusão HTTP como uma operação assíncrona.
public:
System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ GetAsync(System::String ^ requestUri, System::Net::Http::HttpCompletionOption completionOption);public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync(string requestUri, System.Net.Http.HttpCompletionOption completionOption);member this.GetAsync : string * System.Net.Http.HttpCompletionOption -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>Public Function GetAsync (requestUri As String, completionOption As HttpCompletionOption) As Task(Of HttpResponseMessage)Parâmetros
- requestUri
- String
O URI para o qual a solicitação é enviada.
- completionOption
- HttpCompletionOption
Um valor de opção de conclusão HTTP que indica quando a operação deve ser considerada concluída.
Retornos
O objeto de tarefa que representa a operação assíncrona.
Exceções
O requestUri URI não é absoluto e BaseAddress não está definido.
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.
.NET Core e .NET 5 e posterior somente: a solicitação falhou devido ao tempo limite.
O URI de solicitação fornecido não é URI relativo ou absoluto válido.
Comentários
Essa operação não é bloqueada. O objeto retornado Task<TResult> será concluído com base no completionOption parâmetro depois que a parte ou toda a resposta (incluindo conteúdo) for lida.
Note
Em caso de tempo limite, exceções diferentes são geradas em diferentes implementações de .NET.
- HttpRequestException é lançada em todas as versões do .NET Framework aplicáveis.
- OperationCanceledException sem nenhuma exceção interna é lançada em todas as versões do .NET Core aplicáveis.
- OperationCanceledException que aninha um TimeoutException é lançado em versões .NET 5 e posteriores.
Aplica-se a
GetAsync(String, CancellationToken)
Envie uma solicitação GET para o URI especificado com um token de cancelamento como uma operação assíncrona.
public:
System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ GetAsync(System::String ^ requestUri, System::Threading::CancellationToken cancellationToken);public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync(string requestUri, System.Threading.CancellationToken cancellationToken);member this.GetAsync : string * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>Public Function GetAsync (requestUri As String, cancellationToken As CancellationToken) As Task(Of HttpResponseMessage)Parâmetros
- requestUri
- String
O URI para o qual a solicitação é enviada.
- cancellationToken
- CancellationToken
Um token de cancelamento que pode ser usado por outros objetos ou threads para receber aviso de cancelamento.
Retornos
O objeto de tarefa que representa a operação assíncrona.
Exceções
O requestUri URI não é absoluto e BaseAddress não está definido.
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 versões .NET 8 e posteriores, o motivo é indicado por HttpRequestError
-ou-
somente .NET Framework: a solicitação atingiu o tempo limite.
O URI de solicitação fornecido não é URI relativo ou absoluto válido.
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.
Comentários
Essa operação não é 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 foi especificado explicitamente.
Note
Em caso de tempo limite, exceções diferentes são geradas em diferentes implementações de .NET.
- HttpRequestException é lançada em todas as versões do .NET Framework aplicáveis.
- OperationCanceledException sem nenhuma exceção interna é lançada em todas as versões do .NET Core aplicáveis.
- OperationCanceledException que aninha um TimeoutException é lançado em versões .NET 5 e posteriores.
Aplica-se a
GetAsync(Uri, HttpCompletionOption)
Envie uma solicitação GET para o URI especificado com uma opção de conclusão HTTP como uma operação assíncrona.
public:
System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ GetAsync(Uri ^ requestUri, System::Net::Http::HttpCompletionOption completionOption);public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync(Uri requestUri, System.Net.Http.HttpCompletionOption completionOption);member this.GetAsync : Uri * System.Net.Http.HttpCompletionOption -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>Public Function GetAsync (requestUri As Uri, completionOption As HttpCompletionOption) As Task(Of HttpResponseMessage)Parâmetros
- requestUri
- Uri
O URI para o qual a solicitação é enviada.
- completionOption
- HttpCompletionOption
Um valor de opção de conclusão HTTP que indica quando a operação deve ser considerada concluída.
Retornos
O objeto de tarefa que representa a operação assíncrona.
Exceções
O requestUri URI não é absoluto e BaseAddress não está definido.
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 versões .NET 8 e posteriores, o motivo é indicado por HttpRequestError
-ou-
somente .NET Framework: a solicitação atingiu o tempo limite.
.NET Core e .NET 5 e posterior somente: a solicitação falhou devido ao tempo limite.
Comentários
Essa operação não é bloqueada. O objeto retornado Task<TResult> será concluído com base no completionOption parâmetro depois que a parte ou toda a resposta (incluindo conteúdo) for lida.
Note
Em caso de tempo limite, exceções diferentes são geradas em diferentes implementações de .NET.
- HttpRequestException é lançada em todas as versões do .NET Framework aplicáveis.
- OperationCanceledException sem nenhuma exceção interna é lançada em todas as versões do .NET Core aplicáveis.
- OperationCanceledException que aninha um TimeoutException é lançado em versões .NET 5 e posteriores.
Aplica-se a
GetAsync(Uri, CancellationToken)
Envie uma solicitação GET para o URI especificado com um token de cancelamento como uma operação assíncrona.
public:
System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ GetAsync(Uri ^ requestUri, System::Threading::CancellationToken cancellationToken);public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync(Uri requestUri, System.Threading.CancellationToken cancellationToken);member this.GetAsync : Uri * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>Public Function GetAsync (requestUri As Uri, cancellationToken As CancellationToken) As Task(Of HttpResponseMessage)Parâmetros
- requestUri
- Uri
O URI para o qual a solicitação é enviada.
- cancellationToken
- CancellationToken
Um token de cancelamento que pode ser usado por outros objetos ou threads para receber aviso de cancelamento.
Retornos
O objeto de tarefa que representa a operação assíncrona.
Exceções
O requestUri URI não é absoluto e BaseAddress não está definido.
A solicitação falhou devido a um problema ao obter uma resposta HTTP, como conectividade de rede, falha de DNS ou validação de certificado de servidor. Em versões .NET 8 e posteriores, o motivo é indicado por HttpRequestError
-ou-
somente .NET Framework: a solicitação atingiu o tempo limite.
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.
Comentários
Essa operação não é 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 foi especificado explicitamente.
Note
Em caso de tempo limite, exceções diferentes são geradas em diferentes implementações de .NET.
- HttpRequestException é lançada em todas as versões do .NET Framework aplicáveis.
- OperationCanceledException sem nenhuma exceção interna é lançada em todas as versões do .NET Core aplicáveis.
- OperationCanceledException que aninha um TimeoutException é lançado em versões .NET 5 e posteriores.
Aplica-se a
GetAsync(String, HttpCompletionOption, CancellationToken)
Envie uma solicitação GET para o URI especificado com uma opção de conclusão HTTP e um token de cancelamento como uma operação assíncrona.
public:
System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ GetAsync(System::String ^ requestUri, System::Net::Http::HttpCompletionOption completionOption, System::Threading::CancellationToken cancellationToken);public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync(string requestUri, System.Net.Http.HttpCompletionOption completionOption, System.Threading.CancellationToken cancellationToken);member this.GetAsync : string * System.Net.Http.HttpCompletionOption * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>Public Function GetAsync (requestUri As String, completionOption As HttpCompletionOption, cancellationToken As CancellationToken) As Task(Of HttpResponseMessage)Parâmetros
- requestUri
- String
O URI para o qual a solicitação é enviada.
- completionOption
- HttpCompletionOption
Um valor de opção de conclusão HTTP que indica quando a operação deve ser considerada concluída.
- cancellationToken
- CancellationToken
Um token de cancelamento que pode ser usado por outros objetos ou threads para receber aviso de cancelamento.
Retornos
O objeto de tarefa que representa a operação assíncrona.
Exceções
O requestUri URI não é absoluto e BaseAddress não está definido.
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 versões .NET 8 e posteriores, o motivo é indicado por HttpRequestError
-ou-
somente .NET Framework: a solicitação atingiu o tempo limite.
O URI de solicitação fornecido não é URI relativo ou absoluto válido.
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.
Comentários
Essa operação não é bloqueada. O objeto retornado Task<TResult> será concluído com base no completionOption parâmetro depois que a parte ou toda a resposta (incluindo conteúdo) for lida.
Note
Em caso de tempo limite, exceções diferentes são geradas em diferentes implementações de .NET.
- HttpRequestException é lançada em todas as versões do .NET Framework aplicáveis.
- OperationCanceledException sem nenhuma exceção interna é lançada em todas as versões do .NET Core aplicáveis.
- OperationCanceledException que aninha um TimeoutException é lançado em versões .NET 5 e posteriores.
Aplica-se a
GetAsync(Uri, HttpCompletionOption, CancellationToken)
Envie uma solicitação GET para o URI especificado com uma opção de conclusão HTTP e um token de cancelamento como uma operação assíncrona.
public:
System::Threading::Tasks::Task<System::Net::Http::HttpResponseMessage ^> ^ GetAsync(Uri ^ requestUri, System::Net::Http::HttpCompletionOption completionOption, System::Threading::CancellationToken cancellationToken);public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync(Uri requestUri, System.Net.Http.HttpCompletionOption completionOption, System.Threading.CancellationToken cancellationToken);member this.GetAsync : Uri * System.Net.Http.HttpCompletionOption * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage>Public Function GetAsync (requestUri As Uri, completionOption As HttpCompletionOption, cancellationToken As CancellationToken) As Task(Of HttpResponseMessage)Parâmetros
- requestUri
- Uri
O URI para o qual a solicitação é enviada.
- completionOption
- HttpCompletionOption
Um valor de opção de conclusão HTTP que indica quando a operação deve ser considerada concluída.
- cancellationToken
- CancellationToken
Um token de cancelamento que pode ser usado por outros objetos ou threads para receber aviso de cancelamento.
Retornos
O objeto de tarefa que representa a operação assíncrona.
Exceções
O requestUri URI não é absoluto e BaseAddress não está definido.
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 versões .NET 8 e posteriores, o motivo é indicado por HttpRequestError
-ou-
somente .NET Framework: a solicitação atingiu o tempo limite.
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.
Comentários
Essa operação não é bloqueada. O objeto retornado Task<TResult> será concluído com base no completionOption parâmetro depois que a parte ou toda a resposta (incluindo conteúdo) for lida.
Note
Em caso de tempo limite, exceções diferentes são geradas em diferentes implementações de .NET.
- HttpRequestException é lançada em todas as versões do .NET Framework aplicáveis.
- OperationCanceledException sem nenhuma exceção interna é lançada em todas as versões do .NET Core aplicáveis.
- OperationCanceledException que aninha um TimeoutException é lançado em versões .NET 5 e posteriores.