HttpClient.TryGetBufferAsync(Uri) Método

Definição

Namespace:

Windows.Web.Http

Envie uma solicitação GET para o URI especificado e retorne o corpo da resposta como HttpGetBufferResult com um valor IBuffer 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<HttpGetBufferResult ^, HttpProgress> ^ TryGetBufferAsync(Uri ^ uri) = TryGetBufferAsync;

/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<HttpGetBufferResult, HttpProgress> TryGetBufferAsync(Uri const& uri);

[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperationWithProgress<HttpGetBufferResult,HttpProgress> TryGetBufferAsync(System.Uri uri);

function tryGetBufferAsync(uri)

Public Function TryGetBufferAsync (uri As Uri) As IAsyncOperationWithProgress(Of HttpGetBufferResult, HttpProgress)

Parâmetros

uri

Uri Uri

O URI ao qual a solicitação é enviada.

Retornos

IAsyncOperationWithProgress<HttpGetBufferResult,HttpProgress>

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

Atributos

RemoteAsyncAttribute

Requisitos do Windows

Família de dispositivos	Windows 10, version 1903 (introduzida na 10.0.18362.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v8.0)

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.TryGetInputStreamAsync para evitar buffer desnecessário.

Esta operação não será bloqueada. O IAsyncOperationWithProgress retornado (de HttpGetBufferResult 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 TryGetStringAsync 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 TryGetBufferAsync 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.

Confira também

• HttpGetBufferResult
• HttpProgress
• IBuffer
• TryGetInputStreamAsync(Uri)
• HttpClient