StoreContext.DownloadAndInstallStorePackagesAsync 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.
Scarica e installa i pacchetti DLC (Downloadable Content) specificati per l'app corrente da Microsoft Store senza visualizzare una finestra di dialogo dell'interfaccia utente di notifica all'utente.
public:
virtual IAsyncOperationWithProgress<StorePackageUpdateResult ^, StorePackageUpdateStatus> ^ DownloadAndInstallStorePackagesAsync(IIterable<Platform::String ^> ^ storeIds) = DownloadAndInstallStorePackagesAsync;/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<StorePackageUpdateResult, StorePackageUpdateStatus> DownloadAndInstallStorePackagesAsync(IIterable<winrt::hstring> const& storeIds);[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperationWithProgress<StorePackageUpdateResult,StorePackageUpdateStatus> DownloadAndInstallStorePackagesAsync(IEnumerable<string> storeIds);function downloadAndInstallStorePackagesAsync(storeIds)Public Function DownloadAndInstallStorePackagesAsync (storeIds As IEnumerable(Of String)) As IAsyncOperationWithProgress(Of StorePackageUpdateResult, StorePackageUpdateStatus)Parametri
ID dello Store dei componenti aggiuntivi che corrispondono ai pacchetti DLC da installare per l'app corrente.
Restituisce
Oggetto che il chiamante può osservare per tenere traccia dello stato di avanzamento e del completamento dell'operazione. Al termine, il risultato è un oggetto StorePackageUpdateResult che fornisce informazioni sugli aggiornamenti del pacchetto.
- Attributi
Requisiti Windows
| Famiglia di dispositivi |
Windows 10, version 1803 (è stato introdotto in 10.0.17134.0)
|
| API contract |
Windows.Services.Store.StoreContract (è stato introdotto in v3.0)
|
| Funzionalità dell'app |
storePackageManagement
|
Commenti
Usa questo metodo per scaricare e installare nuovi pacchetti DLC per l'app corrente. Quando si chiama questo metodo, il sistema operativo scarica e installa automaticamente i pacchetti senza visualizzare una finestra di dialogo di notifica. Questo metodo richiede la funzionalità storePackageManagement con restrizioni per eseguire questa operazione. Se non si ha accesso a questa funzionalità con restrizioni, è possibile usare i metodi RequestDownloadAndInstallStorePackagesAsync (questi metodi visualizzano invece una finestra di dialogo di notifica che richiede l'autorizzazione dell'utente per installare il pacchetto).
Nota
I pacchetti DLC non sono disponibili per tutti gli account per sviluppatori.
Nota
La funzionalità storePackageManagement con restrizioni è disponibile solo per le applicazioni desktop e i giochi che usano il Desktop Bridge e per i giochi Xbox che usano pacchetti XVC e vengono sviluppati come parte di un programma partner gestito, ad esempio il programma ID@Xbox. Queste applicazioni e giochi hanno questa funzionalità per impostazione predefinita.
L'ID dello Store per un componente aggiuntivo è disponibile nel Centro per i partner e viene restituito anche dalla proprietà StoreId di StoreProduct che rappresenta il componente aggiuntivo DLC. Per altre informazioni, vedere ID dello Store.
Questa operazione non verrà bloccata. L'oggetto IAsyncOperationWithProgress restituito da questo metodo verrà completato dopo il download e l'installazione dei pacchetti.
Il metodo assegnato per gestire le notifiche di stato viene chiamato una volta per ogni passaggio del processo di download e installazione per ogni pacchetto in questa richiesta. Il gestore Progress riceve un argomento StorePackageUpdateStatus che fornisce informazioni sul pacchetto che ha generato la notifica di stato.