HttpClient.GetAsync Método

Definição

Espaço de Nomes:: System.Net.Http

Assemblagem:: System.Net.Http.dll

Assemblagem:: netstandard.dll

Importante

Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.

Enviar um pedido GET para o URI especificado como uma operação assíncrona.

Sobrecargas

Name	Description
GetAsync(String)	Enviar um pedido GET para o URI especificado como uma operação assíncrona.
GetAsync(Uri)	Enviar um pedido GET para o URI especificado como uma operação assíncrona.
GetAsync(String, HttpCompletionOption)	Enviar um pedido GET para o URI especificado com uma opção de conclusão HTTP como uma operação assíncrona.
GetAsync(String, CancellationToken)	Enviar um pedido GET para o URI especificado com um token de cancelamento como uma operação assíncrona.
GetAsync(Uri, HttpCompletionOption)	Enviar um pedido GET para o URI especificado com uma opção de conclusão HTTP como uma operação assíncrona.
GetAsync(Uri, CancellationToken)	Enviar um pedido GET para o URI especificado com um token de cancelamento como uma operação assíncrona.
GetAsync(String, HttpCompletionOption, CancellationToken)	Envie um pedido 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 um pedido GET para o URI especificado com uma opção de conclusão HTTP e um token de cancelamento como uma operação assíncrona.

Observações

A operação não vai bloquear.

GetAsync(String)

Enviar um pedido 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 onde o pedido é enviado.

Devoluções

Task<HttpResponseMessage>

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

Exceções

InvalidOperationException

Não requestUri é um URI absoluto e BaseAddress não está configurado.

HttpRequestException

O pedido falhou devido a um problema em obter uma resposta HTTP válida, como falha de conectividade de rede, falha DNS, erro de validação de certificado do servidor ou resposta inválida do servidor. Em versões .NET 8 e posteriores, a razão é indicada por HttpRequestError

-ou-

Framework .NET apenas: o pedido expirou.

OperationCanceledException

.NET Core e .NET 5 e posteriores apenas: O pedido falhou devido ao timeout.

UriFormatException

O URI de pedido fornecido não é válido relativo nem absoluto.

Observações

Esta operação não bloqueia. O objeto devolvido Task<TResult> será concluído depois de toda a resposta (incluindo o conteúdo) ser lida. O comportamento é o mesmo que se ResponseContentRead tivesse sido explicitamente especificado.

Note

Em caso de timeout, diferentes exceções são lançadas em diferentes implementações .NET.

HttpRequestException está incluído em todas as versões aplicáveis do .NET Framework.
OperationCanceledException sem exceção interna é aplicado em todas as versões .NET Core aplicáveis.
OperationCanceledException que aninham um TimeoutException é lançado em .NET versões 5 e posteriores.

Aplica-se a

GetAsync(Uri)

Enviar um pedido 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 onde o pedido é enviado.

Devoluções

Task<HttpResponseMessage>

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

Exceções

InvalidOperationException

Não requestUri é um URI absoluto e BaseAddress não está configurado.

HttpRequestException

-ou-

Framework .NET apenas: o pedido expirou.

OperationCanceledException

.NET Core e .NET 5 e posteriores apenas: O pedido falhou devido ao timeout.

Observações

Note

Em caso de timeout, diferentes exceções são lançadas em diferentes implementações .NET.

HttpRequestException está incluído em todas as versões aplicáveis do .NET Framework.
OperationCanceledException sem exceção interna é aplicado em todas as versões .NET Core aplicáveis.
OperationCanceledException que aninham um TimeoutException é lançado em .NET versões 5 e posteriores.

Aplica-se a

GetAsync(String, HttpCompletionOption)

Enviar um pedido 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 onde o pedido é enviado.

completionOption: HttpCompletionOption

Um valor de opção de conclusão HTTP que indica quando a operação deve ser considerada concluída.

Devoluções

Task<HttpResponseMessage>

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

Exceções

InvalidOperationException

Não requestUri é um URI absoluto e BaseAddress não está configurado.

HttpRequestException

O pedido falhou devido a um problema subjacente, como conectividade de rede, falha DNS, validação do certificado do servidor ou timeout.

OperationCanceledException

.NET Core e .NET 5 e posteriores apenas: O pedido falhou devido ao timeout.

UriFormatException

O URI de pedido fornecido não é válido relativo nem absoluto.

Observações

Esta operação não bloqueia. O objeto devolvido Task<TResult> será concluído com base no completionOption parâmetro após a parte ou toda a resposta (incluindo o conteúdo) ser lida.

Note

Em caso de timeout, diferentes exceções são lançadas em diferentes implementações .NET.

HttpRequestException está incluído em todas as versões aplicáveis do .NET Framework.
OperationCanceledException sem exceção interna é aplicado em todas as versões .NET Core aplicáveis.
OperationCanceledException que aninham um TimeoutException é lançado em .NET versões 5 e posteriores.

Aplica-se a

GetAsync(String, CancellationToken)

Enviar um pedido 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 onde o pedido é enviado.

cancellationToken: CancellationToken

Um token de cancelamento que pode ser usado por outros objetos ou threads para receber aviso de cancelamento.

Devoluções

Task<HttpResponseMessage>

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

Exceções

InvalidOperationException

Não requestUri é um URI absoluto e BaseAddress não está configurado.

HttpRequestException

-ou-

Framework .NET apenas: o pedido expirou.

UriFormatException

O URI de pedido fornecido não é válido relativo nem absoluto.

OperationCanceledException

O token de cancelamento foi cancelado. Esta exceção é armazenada na tarefa devolvida.

-ou-

.NET Core e .NET 5 e posteriores apenas: O pedido falhou devido ao timeout.

Observações

Note

Em caso de timeout, diferentes exceções são lançadas em diferentes implementações .NET.

HttpRequestException está incluído em todas as versões aplicáveis do .NET Framework.
OperationCanceledException sem exceção interna é aplicado em todas as versões .NET Core aplicáveis.
OperationCanceledException que aninham um TimeoutException é lançado em .NET versões 5 e posteriores.

Aplica-se a

GetAsync(Uri, HttpCompletionOption)

Enviar um pedido 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 onde o pedido é enviado.

completionOption: HttpCompletionOption

Um valor de opção de conclusão HTTP que indica quando a operação deve ser considerada concluída.

Devoluções

Task<HttpResponseMessage>

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

Exceções

InvalidOperationException

Não requestUri é um URI absoluto e BaseAddress não está configurado.

HttpRequestException

-ou-

Framework .NET apenas: o pedido expirou.

OperationCanceledException

.NET Core e .NET 5 e posteriores apenas: O pedido falhou devido ao timeout.

Observações

Esta operação não bloqueia. O objeto devolvido Task<TResult> será concluído com base no completionOption parâmetro após a parte ou toda a resposta (incluindo o conteúdo) ser lida.

Note

Em caso de timeout, diferentes exceções são lançadas em diferentes implementações .NET.

HttpRequestException está incluído em todas as versões aplicáveis do .NET Framework.
OperationCanceledException sem exceção interna é aplicado em todas as versões .NET Core aplicáveis.
OperationCanceledException que aninham um TimeoutException é lançado em .NET versões 5 e posteriores.

Aplica-se a

GetAsync(Uri, CancellationToken)

Enviar um pedido 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 onde o pedido é enviado.

cancellationToken: CancellationToken

Um token de cancelamento que pode ser usado por outros objetos ou threads para receber aviso de cancelamento.

Devoluções

Task<HttpResponseMessage>

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

Exceções

InvalidOperationException

Não requestUri é um URI absoluto e BaseAddress não está configurado.

HttpRequestException

O pedido falhou devido a um problema na obtenção de uma resposta HTTP, como conectividade de rede, falha DNS ou validação de certificado do servidor. Em versões .NET 8 e posteriores, a razão é indicada por HttpRequestError

-ou-

Framework .NET apenas: o pedido expirou.

OperationCanceledException

O token de cancelamento foi cancelado. Esta exceção é armazenada na tarefa devolvida.

-ou-

.NET Core e .NET 5 e posteriores apenas: O pedido falhou devido ao timeout.

Observações

Note

Em caso de timeout, diferentes exceções são lançadas em diferentes implementações .NET.

HttpRequestException está incluído em todas as versões aplicáveis do .NET Framework.
OperationCanceledException sem exceção interna é aplicado em todas as versões .NET Core aplicáveis.
OperationCanceledException que aninham um TimeoutException é lançado em .NET versões 5 e posteriores.

Aplica-se a

GetAsync(String, HttpCompletionOption, CancellationToken)

Envie um pedido 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 onde o pedido é enviado.

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.

Devoluções

Task<HttpResponseMessage>

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

Exceções

InvalidOperationException

Não requestUri é um URI absoluto e BaseAddress não está configurado.

HttpRequestException

-ou-

Framework .NET apenas: o pedido expirou.

UriFormatException

O URI de pedido fornecido não é válido relativo nem absoluto.

OperationCanceledException

O token de cancelamento foi cancelado. Esta exceção é armazenada na tarefa devolvida.

-ou-

.NET Core e .NET 5 e posteriores apenas: O pedido falhou devido ao timeout.

Observações

Esta operação não bloqueia. O objeto devolvido Task<TResult> será concluído com base no completionOption parâmetro após a parte ou toda a resposta (incluindo o conteúdo) ser lida.

Note

Em caso de timeout, diferentes exceções são lançadas em diferentes implementações .NET.

HttpRequestException está incluído em todas as versões aplicáveis do .NET Framework.
OperationCanceledException sem exceção interna é aplicado em todas as versões .NET Core aplicáveis.
OperationCanceledException que aninham um TimeoutException é lançado em .NET versões 5 e posteriores.

Aplica-se a

GetAsync(Uri, HttpCompletionOption, CancellationToken)

Envie um pedido 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 onde o pedido é enviado.

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.

Devoluções

Task<HttpResponseMessage>

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

Exceções

InvalidOperationException

Não requestUri é um URI absoluto e BaseAddress não está configurado.

HttpRequestException

-ou-

Framework .NET apenas: o pedido expirou.

OperationCanceledException

O token de cancelamento foi cancelado. Esta exceção é armazenada na tarefa devolvida.

-ou-

.NET Core e .NET 5 e posteriores apenas: O pedido falhou devido ao timeout.

Observações

Esta operação não bloqueia. O objeto devolvido Task<TResult> será concluído com base no completionOption parâmetro após a parte ou toda a resposta (incluindo o conteúdo) ser lida.

Note

Em caso de timeout, diferentes exceções são lançadas em diferentes implementações .NET.

HttpRequestException está incluído em todas as versões aplicáveis do .NET Framework.
OperationCanceledException sem exceção interna é aplicado em todas as versões .NET Core aplicáveis.
OperationCanceledException que aninham um TimeoutException é lançado em .NET versões 5 e posteriores.

Aplica-se a

Comentários

Esta página foi útil?