HttpClient.GetAsync 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 GET para o URI especificado como uma operação assíncrona.
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 de 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 de 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 de 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 de HTTP e um token de cancelamento como uma operação assíncrona. |
A operação não será bloqueada.
- Origem:
- HttpClient.cs
- Origem:
- HttpClient.cs
- Origem:
- HttpClient.cs
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);
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 ao qual a solicitação é enviada.
Retornos
O objeto de tarefa que representa a operação assíncrona.
Exceções
O requestUri
deve ser um URI absoluto ou BaseAddress deve ser 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.
Somente .NET Core e .NET 5 e posteriores: 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 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, 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.
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 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);
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 ao qual a solicitação é enviada.
Retornos
O objeto de tarefa que representa a operação assíncrona.
Exceções
O requestUri
deve ser um URI absoluto ou BaseAddress deve ser 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.
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.
Observação
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.
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 GET para o URI especificado com uma opção de conclusão de 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);
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 ao qual a solicitação é enviada.
- completionOption
- HttpCompletionOption
Um valor de opção de conclusão de 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
deve ser um URI absoluto ou BaseAddress deve ser 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.
Somente .NET Core e .NET 5 e posteriores: 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 será 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.
Observação
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.
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 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);
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 ao qual a solicitação é enviada.
- cancellationToken
- CancellationToken
Um token de cancelamento que pode ser usado por outros objetos ou threads para receber um aviso de cancelamento.
Retornos
O objeto de tarefa que representa a operação assíncrona.
Exceções
O requestUri
deve ser um URI absoluto ou BaseAddress deve ser 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.
Somente .NET Core e .NET 5 e posteriores: a solicitação falhou devido ao 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.
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.
Observação
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.
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 GET para o URI especificado com uma opção de conclusão de 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);
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 ao qual a solicitação é enviada.
- completionOption
- HttpCompletionOption
Um valor de opção de conclusão de 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
deve ser um URI absoluto ou BaseAddress deve ser 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.
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 com base no completionOption
parâmetro depois que a parte ou toda a resposta (incluindo conteúdo) for lida.
Observação
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.
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 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);
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 ao qual a solicitação é enviada.
- cancellationToken
- CancellationToken
Um token de cancelamento que pode ser usado por outros objetos ou threads para receber um aviso de cancelamento.
Retornos
O objeto de tarefa que representa a operação assíncrona.
Exceções
O requestUri
deve ser um URI absoluto ou BaseAddress deve ser 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.
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
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.
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 GET para o URI especificado com uma opção de conclusão de 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);
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 ao qual a solicitação é enviada.
- completionOption
- HttpCompletionOption
Um valor de opção de conclusão de 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 um aviso de cancelamento.
Retornos
O objeto de tarefa que representa a operação assíncrona.
Exceções
O requestUri
deve ser um URI absoluto ou BaseAddress deve ser 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.
Somente .NET Core e .NET 5 e posterior: a solicitação falhou devido ao tempo limite.
O URI de solicitação fornecido não é um URI relativo ou absoluto válido.
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 com base no completionOption
parâmetro depois que a parte ou toda a resposta (incluindo 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.
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 GET para o URI especificado com uma opção de conclusão de 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);
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 ao qual a solicitação é enviada.
- completionOption
- HttpCompletionOption
Um valor de opção de conclusão de 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 um aviso de cancelamento.
Retornos
O objeto de tarefa que representa a operação assíncrona.
Exceções
O requestUri
deve ser um URI absoluto ou BaseAddress deve ser 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.
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 com base no completionOption
parâmetro depois que a parte ou toda a resposta (incluindo 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.
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: