HttpClient.GetAsync Método

Definição

Namespace:

System.Net.Http

Assembly:

System.Net.Http.dll

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

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 ao qual a solicitação é enviada.

Retornos

Task<HttpResponseMessage>

O objeto de tarefa que representa a operação assíncrona.

Exceções

InvalidOperationException

O requestUri deve ser um URI absoluto ou BaseAddress deve ser definido.

HttpRequestException

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.

TaskCanceledException

Somente .NET Core e .NET 5 e posteriores: a solicitação falhou devido ao tempo limite.

UriFormatException

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.

GetAsync(Uri)

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);

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

Task<HttpResponseMessage>

O objeto de tarefa que representa a operação assíncrona.

Exceções

InvalidOperationException

O requestUri deve ser um URI absoluto ou BaseAddress deve ser definido.

HttpRequestException

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.

TaskCanceledException

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.

GetAsync(String, HttpCompletionOption)

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);

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

Task<HttpResponseMessage>

O objeto de tarefa que representa a operação assíncrona.

Exceções

InvalidOperationException

O requestUri deve ser um URI absoluto ou BaseAddress deve ser definido.

HttpRequestException

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.

TaskCanceledException

Somente .NET Core e .NET 5 e posteriores: a solicitação falhou devido ao tempo limite.

UriFormatException

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.

GetAsync(String, CancellationToken)

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);

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

Task<HttpResponseMessage>

O objeto de tarefa que representa a operação assíncrona.

Exceções

InvalidOperationException

O requestUri deve ser um URI absoluto ou BaseAddress deve ser definido.

HttpRequestException

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.

TaskCanceledException

Somente .NET Core e .NET 5 e posteriores: a solicitação falhou devido ao tempo limite.

UriFormatException

O URI de solicitação fornecido não é URI relativo ou absoluto válido.

OperationCanceledException

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.

GetAsync(Uri, HttpCompletionOption)

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);

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

Task<HttpResponseMessage>

O objeto de tarefa que representa a operação assíncrona.

Exceções

InvalidOperationException

O requestUri deve ser um URI absoluto ou BaseAddress deve ser definido.

HttpRequestException

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.

TaskCanceledException

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.

GetAsync(Uri, CancellationToken)

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);

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

Task<HttpResponseMessage>

O objeto de tarefa que representa a operação assíncrona.

Exceções

InvalidOperationException

O requestUri deve ser um URI absoluto ou BaseAddress deve ser definido.

HttpRequestException

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.

TaskCanceledException

Somente .NET Core e .NET 5 e posteriores: a solicitação falhou devido ao tempo limite.

OperationCanceledException

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.

GetAsync(String, HttpCompletionOption, CancellationToken)

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);

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

Task<HttpResponseMessage>

O objeto de tarefa que representa a operação assíncrona.

Exceções

InvalidOperationException

O requestUri deve ser um URI absoluto ou BaseAddress deve ser definido.

HttpRequestException

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.

TaskCanceledException

Somente .NET Core e .NET 5 e posterior: a solicitação falhou devido ao tempo limite.

UriFormatException

O URI de solicitação fornecido não é um URI relativo ou absoluto válido.

OperationCanceledException

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.

GetAsync(Uri, HttpCompletionOption, CancellationToken)

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);

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

Task<HttpResponseMessage>

O objeto de tarefa que representa a operação assíncrona.

Exceções

InvalidOperationException

O requestUri deve ser um URI absoluto ou BaseAddress deve ser definido.

HttpRequestException

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.

TaskCanceledException

Somente .NET Core e .NET 5 e posterior: a solicitação falhou devido ao tempo limite.

OperationCanceledException

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.