HttpClient.GetStringAsync(Uri) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Inviare una richiesta GET all'URI specificato e restituisce il corpo della risposta come stringa in un'operazione asincrona. Per indicazioni sulla programmazione per la classe HttpClient ed esempi di codice, vedere l'argomento concettuale 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)Parametri
Restituisce
IAsyncOperationWithProgress<Platform::String,HttpProgress>
IAsyncOperationWithProgress<winrt::hstring,HttpProgress>
Oggetto che rappresenta l'operazione asincrona.
- Attributi
Commenti
Questa operazione non verrà bloccata. Il valore restituito IAsyncOperationWithProgress (di stringa e HttpProgress) viene completato dopo la lettura dell'intero corpo della risposta.
La classe HttpClient viene spesso usata da un'app per scaricare e quindi analizzare il testo. È possibile che la codifica dei caratteri specificata nell'intestazione Content-Type da un server HTTP non corrisponda alla codifica dei caratteri del corpo della risposta HTTP (la codifica XML in un documento XML, ad esempio). Un modo per usare HttpClient con testo consiste nel chiamare il metodo GetStringAsync e passare la stringa restituita al parser di testo. Tuttavia, questo può causare errori se il tipo di contenuto non è un tipo expressible come stringa. Un modo affidabile per usare HttpClient con un parser XML consiste nel chiamare il metodo GetBufferAsync e analizzare il buffer per l'elemento "<?xml>". Usare quindi la codifica dei caratteri specificata ("<xmlversion="1.0" encoding="UTF-8"?>", ad esempio) per analizzare il corpo della risposta HTTP. Per altri formati di testo, è possibile usare metodi simili in cui l'app analizza la parte iniziale del corpo della risposta HTTP per determinare la codifica dei caratteri usata.
Di seguito sono riportate le eccezioni generate da questa funzione.
E_INVALIDARG
Il parametro URI è un riferimento Null (Nothing in Visual Basic).
Gestione delle eccezioni
È necessario scrivere codice per gestire le eccezioni quando si chiama questo metodo. Le eccezioni possono causare errori di convalida dei parametri, errori di risoluzione dei nomi e errori di rete. Eccezioni da errori di rete (perdita di connettività, errori di connessione e errori del server HTTP, ad esempio) possono verificarsi in qualsiasi momento. Questi errori causano la generazione di eccezioni. Se non gestito dall'app, un'eccezione può causare la chiusura dell'intera app dal runtime. Per altre informazioni su come gestire le eccezioni, vedere Gestione delle eccezioni nelle app di rete.