HttpClient.GetAsync 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.
Overload
GetAsync(Uri) |
Inviare una richiesta GET all'URI specificato come operazione asincrona. Per indicazioni sulla programmazione per la classe HttpClient ed esempi di codice, vedere l'argomento concettuale HttpClient . |
GetAsync(Uri, HttpCompletionOption) |
Inviare una richiesta GET all'URI specificato con un'opzione di completamento HTTP come operazione asincrona. Per indicazioni sulla programmazione per la classe HttpClient ed esempi di codice, vedere l'argomento concettuale HttpClient . |
GetAsync(Uri)
Inviare una richiesta GET all'URI specificato come operazione asincrona. Per indicazioni sulla programmazione per la classe HttpClient ed esempi di codice, vedere l'argomento concettuale HttpClient .
public:
virtual IAsyncOperationWithProgress<HttpResponseMessage ^, HttpProgress> ^ GetAsync(Uri ^ uri) = GetAsync;
/// [Windows.Foundation.Metadata.Overload("GetAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<HttpResponseMessage, HttpProgress> GetAsync(Uri const& uri);
[Windows.Foundation.Metadata.Overload("GetAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperationWithProgress<HttpResponseMessage,HttpProgress> GetAsync(System.Uri uri);
function getAsync(uri)
Public Function GetAsync (uri As Uri) As IAsyncOperationWithProgress(Of HttpResponseMessage, HttpProgress)
Parametri
Restituisce
Oggetto che rappresenta l'operazione asincrona.
- Attributi
Commenti
Questa operazione non verrà bloccata. Il valore restituito IAsyncOperationWithProgress (di HttpResponseMessage e HttpProgress) viene completato dopo la lettura dell'intera risposta (incluso il contenuto).
Per il codice di esempio in C#/VB/C++ e XAML che illustra come usare HttpClient e GetAsync(Uri) per connettersi a un server HTTP e inviare una richiesta GET, vedere HttpClient.
Per codice di esempio in JavaScript e HTML che illustra come usare HttpClient e GetAsync(Uri) per connettersi a un server HTTP e inviare una richiesta GET, vedere Connessione a un server HTTP tramite Windows.Web.Http.
Di seguito sono riportate le eccezioni generate da questa funzione.
COMException
Generato quando viene restituito un HRESULT specifico della funzionalità da una chiamata al metodo.
Si tratta dell'eccezione più comune generata dai metodi di rete. Un'app deve usare HRESULT dall'eccezione per determinare la causa dell'errore.
AccessDeniedException
Generata quando viene negato l'accesso a una risorsa o a una funzionalità. Questa eccezione si verifica quando un'app non dispone delle funzionalità di rete necessarie impostate nel manifesto dell'app per l'operazione di rete richiesta.
InvalidArgumentException
Generata quando uno degli argomenti forniti a un metodo non è valido.
Se l'input fornito dall'utente ha causato questa eccezione, un'app potrebbe informare l'utente e richiedere un nuovo input.
ObjectDisposedException
Generata quando viene eseguita un'operazione su un oggetto eliminato.
OutOfMemoryException
Generato quando è disponibile memoria insufficiente per completare l'operazione.
Vedi anche
- GetAsync(Uri, HttpCompletionOption)
- IAsyncOperationWithProgress<TResult,TProgress>
- Uri
- Windows.Web.Http
- Connessione a un server HTTP tramite Windows.Web.Http
- Gestione delle eccezioni nelle app di rete
- HttpResponseMessage
- HttpProgress
- System.Uri
- HttpClient
Si applica a
GetAsync(Uri, HttpCompletionOption)
Inviare una richiesta GET all'URI specificato con un'opzione di completamento HTTP come operazione asincrona. Per indicazioni sulla programmazione per la classe HttpClient ed esempi di codice, vedere l'argomento concettuale HttpClient .
public:
virtual IAsyncOperationWithProgress<HttpResponseMessage ^, HttpProgress> ^ GetAsync(Uri ^ uri, HttpCompletionOption completionOption) = GetAsync;
/// [Windows.Foundation.Metadata.Overload("GetWithOptionAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<HttpResponseMessage, HttpProgress> GetAsync(Uri const& uri, HttpCompletionOption const& completionOption);
[Windows.Foundation.Metadata.Overload("GetWithOptionAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperationWithProgress<HttpResponseMessage,HttpProgress> GetAsync(System.Uri uri, HttpCompletionOption completionOption);
function getAsync(uri, completionOption)
Public Function GetAsync (uri As Uri, completionOption As HttpCompletionOption) As IAsyncOperationWithProgress(Of HttpResponseMessage, HttpProgress)
Parametri
- completionOption
- HttpCompletionOption
Valore di opzione di completamento HTTP che indica quando l'operazione deve essere considerata completata.
Restituisce
Oggetto che rappresenta l'operazione asincrona.
- Attributi
Commenti
Questa operazione non verrà bloccata. Il valore restituito IAsyncOperationWithProgress (di HttpResponseMessage e HttpProgress) viene completato in base al parametro completeOption dopo parte o a tutte le risposte (incluso il contenuto).
Di seguito sono riportate le eccezioni generate da questo contenuto.
COMException
Generato quando viene restituito un HRESULT specifico della funzionalità da una chiamata al metodo.
Si tratta dell'eccezione più comune generata dai metodi di rete. Un'app deve usare HRESULT dall'eccezione per determinare la causa dell'errore.
AccessDeniedException
Generata quando viene negato l'accesso a una risorsa o a una funzionalità. Questa eccezione si verifica quando un'app non dispone delle funzionalità di rete necessarie impostate nel manifesto dell'app per l'operazione di rete richiesta.
InvalidArgumentException
Generata quando uno degli argomenti forniti a un metodo non è valido.
Se l'input fornito dall'utente ha causato questa eccezione, un'app potrebbe informare l'utente e richiedere un nuovo input.
ObjectDisposedException
Generata quando viene eseguita un'operazione su un oggetto eliminato.
OutOfMemoryException
Generato quando è disponibile memoria insufficiente per completare l'operazione.
Vedi anche
- GetAsync(Uri)
- HttpCompletionOption
- IAsyncOperationWithProgress<TResult,TProgress>
- Uri
- Windows.Web.Http
- Connessione a un server HTTP tramite Windows.Web.Http
- Gestione delle eccezioni nelle app di rete
- HttpResponseMessage
- HttpProgress
- System.Uri
- HttpClient