HttpClient.GetStringAsync(Uri) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Envía una solicitud GET al URI especificado y devuelve el cuerpo de la respuesta como una cadena 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<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
Devoluciones
IAsyncOperationWithProgress<Platform::String,HttpProgress>
IAsyncOperationWithProgress<winrt::hstring,HttpProgress>
Objeto que representa la operación asincrónica.
- Atributos
Comentarios
Esta operación no se bloqueará. El IAsyncOperationWithProgress devuelto (de cadena 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 GetStringAsync 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 GetBufferAsync y analizar el búfer para el 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.
A continuación se muestran las excepciones que produce esta función.
E_INVALIDARG
El parámetro URI era una referencia nula (Nothing en Visual Basic).
Control de excepciones.
Debe escribir código para controlar las excepciones al llamar a este método. Las excepciones pueden deberse a errores de validación de parámetros, errores de resolución de nombres y errores de red. Las excepciones de los errores de red (pérdida de conectividad, errores de conexión y errores de servidor HTTP, por ejemplo) pueden producirse en cualquier momento. Estos errores hacen que se arrojen excepciones. Si la aplicación no la controla, una excepción puede hacer que el tiempo de ejecución finalice toda la aplicación. Para obtener más información sobre cómo controlar las excepciones, consulte Control de excepciones en aplicaciones de red.