HttpClient.GetBufferAsync(Uri) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Envie uma solicitação GET para o URI especificado e retorne o corpo da resposta como um buffer 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<IBuffer ^, HttpProgress> ^ GetBufferAsync(Uri ^ uri) = GetBufferAsync;/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<IBuffer, HttpProgress> GetBufferAsync(Uri const& uri);[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperationWithProgress<IBuffer,HttpProgress> GetBufferAsync(System.Uri uri);function getBufferAsync(uri)Public Function GetBufferAsync (uri As Uri) As IAsyncOperationWithProgress(Of IBuffer, HttpProgress)Parâmetros
Retornos
O objeto que representa a operação assíncrona.
- Atributos
Comentários
Esse método geralmente é chamado ao baixar conteúdo binário, como imagens pequenas e arquivos compactados. O conteúdo binário muito grande deve ser baixado como um fluxo com HttpClient.GetInputStreamAsync para evitar buffer desnecessário.
Esta operação não será bloqueada. O IAsyncOperationWithProgress retornado (de IBuffer e HttpProgress) é concluído depois que todo o corpo da resposta é lido.
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 Content-Type 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 Content-Type 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).