Partilhar via


HttpClient.GetAsync Método

Definição

Sobrecargas

GetAsync(Uri)

Envie uma solicitação GET para o URI especificado como uma operação assíncrona. Para obter diretrizes de programação para a classe HttpClient e exemplos de código, consulte o tópico conceitual HttpClient .

GetAsync(Uri, HttpCompletionOption)

Envie uma solicitação GET para o Uri especificado com uma opção de conclusão HTTP como uma operação assíncrona. Para obter diretrizes de programação para a classe HttpClient e exemplos de código, consulte o tópico conceitual HttpClient .

GetAsync(Uri)

Envie uma solicitação GET para o URI especificado como uma operação assíncrona. Para obter diretrizes de programação para a classe HttpClient e exemplos de código, consulte o tópico conceitual HttpClient .

public:
 virtual IAsyncOperationWithProgress<HttpResponseMessage ^, HttpProgress> ^ GetAsync(Uri ^ uri) = GetAsync;
/// [Windows.Foundation.Metadata.Overload("GetAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<HttpResponseMessage, HttpProgress> GetAsync(Uri const& uri);
[Windows.Foundation.Metadata.Overload("GetAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperationWithProgress<HttpResponseMessage,HttpProgress> GetAsync(System.Uri uri);
function getAsync(uri)
Public Function GetAsync (uri As Uri) As IAsyncOperationWithProgress(Of HttpResponseMessage, HttpProgress)

Parâmetros

uri
Uri Uri

O Uri para o qual a solicitação deve ser enviada.

Retornos

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

Atributos

Comentários

Essa operação não será bloqueada. O IAsyncOperationWithProgress retornado (de HttpResponseMessage e HttpProgress) é concluído após a leitura de toda a resposta (incluindo conteúdo).

Para obter código de exemplo em C#/VB/C++ e XAML que mostra como usar HttpClient e GetAsync(Uri) para se conectar a um servidor HTTP e enviar uma solicitação GET, consulte HttpClient.

Para obter código de exemplo em JavaScript e HTML que mostra como usar HttpClient e GetAsync(Uri) para se conectar a um servidor HTTP e enviar uma solicitação GET, consulte Conectando-se a um servidor HTTP usando Windows.Web.Http.

Abaixo estão as exceções geradas por essa função.

COMException

Gerado quando um HRESULT específico do recurso é retornado de uma chamada de método.

Essa é a exceção mais comum gerada pelos métodos de rede. Um aplicativo deve usar o HRESULT da exceção para determinar a causa do erro.

AccessDeniedException

Gerada quando o acesso a um recurso é negado. Essa exceção ocorre quando um aplicativo não tem os recursos de rede necessários definidos no manifesto do aplicativo para a operação de rede solicitada.

InvalidArgumentException

Gerada quando um dos argumentos fornecidos a um método não é válido.

Se a entrada fornecida pelo usuário causou essa exceção, um aplicativo poderá informar o usuário e solicitar uma nova entrada.

ObjectDisposedException

Gerada quando uma operação é executada em um objeto descartado.

OutOfMemoryException

Gerado quando a memória insuficiente está disponível para concluir a operação.

Confira também

Aplica-se a

GetAsync(Uri, HttpCompletionOption)

Envie uma solicitação GET para o Uri especificado com uma opção de conclusão HTTP como uma operação assíncrona. Para obter diretrizes de programação para a classe HttpClient e exemplos de código, consulte o tópico conceitual HttpClient .

public:
 virtual IAsyncOperationWithProgress<HttpResponseMessage ^, HttpProgress> ^ GetAsync(Uri ^ uri, HttpCompletionOption completionOption) = GetAsync;
/// [Windows.Foundation.Metadata.Overload("GetWithOptionAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<HttpResponseMessage, HttpProgress> GetAsync(Uri const& uri, HttpCompletionOption const& completionOption);
[Windows.Foundation.Metadata.Overload("GetWithOptionAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperationWithProgress<HttpResponseMessage,HttpProgress> GetAsync(System.Uri uri, HttpCompletionOption completionOption);
function getAsync(uri, completionOption)
Public Function GetAsync (uri As Uri, completionOption As HttpCompletionOption) As IAsyncOperationWithProgress(Of HttpResponseMessage, HttpProgress)

Parâmetros

uri
Uri Uri

O Uri para o 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 que representa a operação assíncrona.

Atributos

Comentários

Essa operação não será bloqueada. O IAsyncOperationWithProgress retornado (de HttpResponseMessage e HttpProgress) é concluído com base no parâmetro completionOption depois que parte ou toda a resposta (incluindo conteúdo) é lida.

Abaixo estão as exceções que esse conteúdo gera.

COMException

Gerado quando um HRESULT específico do recurso é retornado de uma chamada de método.

Essa é a exceção mais comum gerada pelos métodos de rede. Um aplicativo deve usar o HRESULT da exceção para determinar a causa do erro.

AccessDeniedException

Gerada quando o acesso a um recurso é negado. Essa exceção ocorre quando um aplicativo não tem os recursos de rede necessários definidos no manifesto do aplicativo para a operação de rede solicitada.

InvalidArgumentException

Gerada quando um dos argumentos fornecidos a um método não é válido.

Se a entrada fornecida pelo usuário causou essa exceção, um aplicativo poderá informar o usuário e solicitar uma nova entrada.

ObjectDisposedException

Gerada quando uma operação é executada em um objeto descartado.

OutOfMemoryException

Gerado quando a memória insuficiente está disponível para concluir a operação.

Confira também

Aplica-se a