Ler em inglês

Compartilhar 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.

C#
public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync (string requestUri);
C#
public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync (string? requestUri);

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

.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

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.

C#
public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync (Uri requestUri);
C#
public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync (Uri? requestUri);

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

.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

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.

C#
public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync (string requestUri, System.Net.Http.HttpCompletionOption completionOption);
C#
public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync (string? requestUri, System.Net.Http.HttpCompletionOption completionOption);

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

.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

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.

C#
public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync (string requestUri, System.Threading.CancellationToken cancellationToken);
C#
public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync (string? requestUri, System.Threading.CancellationToken cancellationToken);

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

.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

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.

C#
public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync (Uri requestUri, System.Net.Http.HttpCompletionOption completionOption);
C#
public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync (Uri? requestUri, System.Net.Http.HttpCompletionOption completionOption);

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

.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

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.

C#
public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync (Uri requestUri, System.Threading.CancellationToken cancellationToken);
C#
public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync (Uri? requestUri, System.Threading.CancellationToken cancellationToken);

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

.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

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.

C#
public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync (string requestUri, System.Net.Http.HttpCompletionOption completionOption, System.Threading.CancellationToken cancellationToken);
C#
public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync (string? requestUri, System.Net.Http.HttpCompletionOption completionOption, System.Threading.CancellationToken cancellationToken);

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

.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

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.

C#
public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync (Uri requestUri, System.Net.Http.HttpCompletionOption completionOption, System.Threading.CancellationToken cancellationToken);
C#
public System.Threading.Tasks.Task<System.Net.Http.HttpResponseMessage> GetAsync (Uri? requestUri, System.Net.Http.HttpCompletionOption completionOption, System.Threading.CancellationToken cancellationToken);

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

.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