HttpClient.TryGetBufferAsync(Uri) Método

Definición

Espacio de nombres:

Windows.Web.Http

Envíe una solicitud GET al URI especificado y devuelva el cuerpo de la respuesta como HttpGetBufferResult con un valor IBuffer en una operación asincrónica. Para obtener instrucciones de programación para la clase HttpClient y ejemplos de código, consulte el tema conceptual 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

URI al que se envía la solicitud.

Devoluciones

IAsyncOperationWithProgress<HttpGetBufferResult,HttpProgress>

Objeto que representa la operación asincrónica.

Atributos

RemoteAsyncAttribute

Requisitos de Windows

Familia de dispositivos	Windows 10, version 1903 (se introdujo en la versión 10.0.18362.0)
API contract	Windows.Foundation.UniversalApiContract (se introdujo en la versión v8.0)

Comentarios

Se suele llamar a este método al descargar contenido binario, como imágenes pequeñas y archivos comprimidos. El contenido binario muy grande debe descargarse como una secuencia con HttpClient.TryGetInputStreamAsync para evitar el almacenamiento en búfer innecesario.

Esta operación no se bloqueará. El IAsyncOperationWithProgress devuelto (de HttpGetBufferResult y HttpProgress) se completa después de leer todo el cuerpo de la respuesta.

La clase HttpClient suele usarse en una aplicación para descargar y, a continuación, analizar texto. Es posible que la codificación de caracteres especificada en el encabezado Content-Type por un servidor HTTP no coincida con la codificación de caracteres del cuerpo de la respuesta HTTP (la codificación XML en un documento XML, por ejemplo). Una manera de usar HttpClient con texto es llamar al método TryGetStringAsync y pasar la cadena devuelta al analizador de texto. Sin embargo, esto puede provocar errores si content-Type no es un tipo que se puede expresar como una cadena. Una manera confiable de usar HttpClient con un analizador XML es llamar al método TryGetBufferAsync y analizar el búfer del elemento "<?xml>". A continuación, use la codificación de caracteres especificada ("<xmlversion="1.0" codificación="UTF-8"?>", por ejemplo) para analizar el cuerpo de la respuesta HTTP. Para otros formatos de texto, se pueden usar métodos similares en los que la aplicación examina la parte inicial del cuerpo de la respuesta HTTP para determinar la codificación de caracteres usada.

Consulte también

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