Partilhar via


HttpClient.GetAsync Método

Definição

Envie uma solicitação GET para o URI especificado como uma operação assíncrona.

Sobrecargas

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.

Comentários

A operação não será bloqueada.

GetAsync(String)

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.

Aplica-se a

GetAsync(Uri)

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.

Aplica-se a

GetAsync(String, HttpCompletionOption)

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.

Aplica-se a

GetAsync(String, CancellationToken)

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.

Aplica-se a

GetAsync(Uri, HttpCompletionOption)

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.

Aplica-se a

GetAsync(Uri, CancellationToken)

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.

Aplica-se a

GetAsync(String, HttpCompletionOption, CancellationToken)

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.

Aplica-se a

GetAsync(Uri, HttpCompletionOption, CancellationToken)

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.

Aplica-se a