StoreContext.RequestDownloadStorePackageUpdatesAsync 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.
Tenta di scaricare gli aggiornamenti del pacchetto specificati per l'app corrente da Microsoft Store. Questo metodo visualizza anche una finestra di dialogo dell'interfaccia utente che richiede l'autorizzazione per l'operazione.
Importante
Questo metodo deve essere chiamato nel thread dell'interfaccia utente.
public:
virtual IAsyncOperationWithProgress<StorePackageUpdateResult ^, StorePackageUpdateStatus> ^ RequestDownloadStorePackageUpdatesAsync(IIterable<StorePackageUpdate ^> ^ storePackageUpdates) = RequestDownloadStorePackageUpdatesAsync;/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<StorePackageUpdateResult, StorePackageUpdateStatus> RequestDownloadStorePackageUpdatesAsync(IIterable<StorePackageUpdate> const& storePackageUpdates);[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperationWithProgress<StorePackageUpdateResult,StorePackageUpdateStatus> RequestDownloadStorePackageUpdatesAsync(IEnumerable<StorePackageUpdate> storePackageUpdates);function requestDownloadStorePackageUpdatesAsync(storePackageUpdates)Public Function RequestDownloadStorePackageUpdatesAsync (storePackageUpdates As IEnumerable(Of StorePackageUpdate)) As IAsyncOperationWithProgress(Of StorePackageUpdateResult, StorePackageUpdateStatus)Parametri
- storePackageUpdates
Set di oggetti StorePackageUpdate che rappresentano i pacchetti aggiornati da scaricare.
Restituisce
Oggetto che il chiamante può osservare per tenere traccia dello stato di avanzamento e del completamento dell'operazione. Al termine del completamento, il risultato è un oggetto StorePackageUpdateResult che fornisce informazioni sugli aggiornamenti del pacchetto.
- Attributi
Eccezioni
Se la proprietà ErrorCode dell'eccezione ha il valore 0x80070578 (ERROR_INVALID_WINDOW_HANDLE), questo indica che il metodo non è stato chiamato nel thread dell'interfaccia utente. Se si chiama questo metodo in un'applicazione desktop che usa la Desktop Bridge, questo può anche indicare che non è stato configurato l'oggetto <xref:Windows.Services.Store.StoreContext?text=StoreContext> per specificare quale finestra dell'applicazione è la finestra proprietario per i dialoghi modali visualizzati da questo metodo. Per altre informazioni, vedi questo articolo.
Commenti
Per ottenere l'elenco di pacchetti che dispongono di aggiornamenti disponibili, usare il metodo GetAppAndOptionalStorePackageUpdatesAsync . Dopo aver scaricato i pacchetti, è possibile installarli usando il metodo RequestDownloadAndInstallStorePackageUpdatesAsync . Per altre informazioni sull'uso di questo metodo, incluso un esempio di codice, vedere Scaricare e installare gli aggiornamenti del pacchetto per l'app.
Questa operazione non verrà bloccata. L'oggetto IAsyncOperationWithProgress restituito da questo metodo verrà completato dopo il download dei pacchetti di aggiornamento.
Quando si chiama questo metodo, il sistema operativo visualizza una finestra di dialogo che indica all'utente che un aggiornamento dell'app è disponibile per scaricare e chiede all'utente l'autorizzazione per procedere con il download. Se l'utente non concede l'autorizzazione per avviare il download, la proprietà OverallState del valore restituito StorePackageUpdateResult ha il valore Annullato.
Il metodo assegnato per gestire le notifiche di stato viene chiamato una volta per ogni passaggio del processo di download per ogni pacchetto in questa richiesta. Il gestore Progress riceve un argomento StorePackageUpdateStatus che fornisce informazioni sul pacchetto di aggiornamento che ha generato la notifica dello stato.