Compartilhar via


HttpClient.GetStringAsync(Uri) Método

Definição

Envie uma solicitação GET para o URI especificado e retorne o corpo da resposta como uma cadeia de caracteres em 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<Platform::String ^, HttpProgress> ^ GetStringAsync(Uri ^ uri) = GetStringAsync;
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<winrt::hstring, HttpProgress> GetStringAsync(Uri const& uri);
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperationWithProgress<string,HttpProgress> GetStringAsync(System.Uri uri);
function getStringAsync(uri)
Public Function GetStringAsync (uri As Uri) As IAsyncOperationWithProgress(Of String, HttpProgress)

Parâmetros

uri
Uri Uri

O URI ao qual a solicitação é 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 cadeia de caracteres e HttpProgress) é concluído após a leitura de todo o corpo da resposta.

A classe HttpClient geralmente é usada por um aplicativo para baixar e, em seguida, analisar texto. É possível que a codificação de caracteres especificada no cabeçalho Tipo de Conteúdo por um servidor HTTP não corresponda à codificação de caracteres do corpo da resposta HTTP (a codificação XML em um documento XML, por exemplo). Uma maneira de usar HttpClient com texto é chamar o método GetStringAsync e passar a cadeia de caracteres retornada para o analisador de texto. No entanto, isso poderá resultar em erros se o Tipo de Conteúdo não for um tipo expressível como uma cadeia de caracteres. Uma maneira confiável de usar HttpClient com um analisador XML é chamar o método GetBufferAsync e analisar o buffer para o elemento "<?xml>". Em seguida, use a codificação de caracteres especificada ("<xmlversion="1.0" encoding="UTF-8"?>", por exemplo) para analisar o corpo da resposta HTTP. Para outros formatos de texto, métodos semelhantes podem ser usados em que o aplicativo examina a parte inicial do corpo da resposta HTTP para determinar a codificação de caracteres usada.

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

E_INVALIDARG

O parâmetro uri era uma referência nula (Nothing no Visual Basic).

Tratamento de exceção

Você deve escrever código para lidar com exceções ao chamar esse método. Exceções podem resultar de erros de validação de parâmetro, falhas de resolução de nomes e erros de rede. Exceções de erros de rede (perda de conectividade, falhas de conexão e falhas de servidor HTTP, por exemplo) podem ocorrer a qualquer momento. Esses erros geram exceções. Se não for tratada pelo aplicativo, uma exceção poderá fazer com que todo o aplicativo seja encerrado pelo runtime. Para obter mais informações sobre como lidar com exceções, consulte Tratamento de exceções em aplicativos de rede.

Aplica-se a

Confira também