StoreContext.RequestDownloadAndInstallStorePackagesAsync 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
| RequestDownloadAndInstallStorePackagesAsync(IIterable<String>) |
Tenta di scaricare e installare i pacchetti DLC (Downloadable Content) 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. |
| RequestDownloadAndInstallStorePackagesAsync(IIterable<String>, StorePackageInstallOptions) |
Tenta di scaricare e installare i pacchetti DLC (Downloadable Content) specificati per l'app corrente da Microsoft Store, con le opzioni di installazione specificate. 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. |
RequestDownloadAndInstallStorePackagesAsync(IIterable<String>)
Tenta di scaricare e installare i pacchetti DLC (Downloadable Content) 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> ^ RequestDownloadAndInstallStorePackagesAsync(IIterable<Platform::String ^> ^ storeIds) = RequestDownloadAndInstallStorePackagesAsync;/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<StorePackageUpdateResult, StorePackageUpdateStatus> RequestDownloadAndInstallStorePackagesAsync(IIterable<winrt::hstring> const& storeIds);[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperationWithProgress<StorePackageUpdateResult,StorePackageUpdateStatus> RequestDownloadAndInstallStorePackagesAsync(IEnumerable<string> storeIds);function requestDownloadAndInstallStorePackagesAsync(storeIds)Public Function RequestDownloadAndInstallStorePackagesAsync (storeIds As IEnumerable(Of String)) As IAsyncOperationWithProgress(Of StorePackageUpdateResult, StorePackageUpdateStatus)Parametri
ID dello Store dei pacchetti del componente aggiuntivo DLC da installare.
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
Usare questo metodo per scaricare e installare nuovi pacchetti DLC per l'app corrente. Quando si chiama questo metodo, il sistema operativo visualizza una finestra di dialogo che indica all'utente che un pacchetto dell'app è disponibile per scaricare e installare e chiede all'utente l'autorizzazione per procedere con l'operazione. Se l'utente non concede l'autorizzazione, la proprietà OverallState del valore restituito StorePackageUpdateResult ha il valore Annullato. Per installare in modo automatico un pacchetto di app senza visualizzare una finestra di dialogo di notifica, usare DownloadAndInstallStorePackagesAsync (questo metodo richiede l'accesso a una funzionalità con restrizioni).
L'ID dello Store per un componente aggiuntivo DLC è 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 Archiviare gli ID.
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.
Nota
I pacchetti DLC (Downloadable Content) non sono disponibili per tutti gli account sviluppatore.
Vedi anche
- DownloadAndInstallStorePackagesAsync(IIterable<String>)
- Pacchetti facoltativi e creazione di set correlati
Si applica a
RequestDownloadAndInstallStorePackagesAsync(IIterable<String>, StorePackageInstallOptions)
Tenta di scaricare e installare i pacchetti DLC (Downloadable Content) specificati per l'app corrente da Microsoft Store, con le opzioni di installazione specificate. 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> ^ RequestDownloadAndInstallStorePackagesAsync(IIterable<Platform::String ^> ^ storeIds, StorePackageInstallOptions ^ storePackageInstallOptions) = RequestDownloadAndInstallStorePackagesAsync;/// [Windows.Foundation.Metadata.Overload("RequestDownloadAndInstallStorePackagesWithInstallOptionsAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperationWithProgress<StorePackageUpdateResult, StorePackageUpdateStatus> RequestDownloadAndInstallStorePackagesAsync(IIterable<winrt::hstring> const& storeIds, StorePackageInstallOptions const& storePackageInstallOptions);[Windows.Foundation.Metadata.Overload("RequestDownloadAndInstallStorePackagesWithInstallOptionsAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperationWithProgress<StorePackageUpdateResult,StorePackageUpdateStatus> RequestDownloadAndInstallStorePackagesAsync(IEnumerable<string> storeIds, StorePackageInstallOptions storePackageInstallOptions);function requestDownloadAndInstallStorePackagesAsync(storeIds, storePackageInstallOptions)Public Function RequestDownloadAndInstallStorePackagesAsync (storeIds As IEnumerable(Of String), storePackageInstallOptions As StorePackageInstallOptions) As IAsyncOperationWithProgress(Of StorePackageUpdateResult, StorePackageUpdateStatus)Parametri
ID dello Store dei pacchetti del componente aggiuntivo DLC da installare.
- storePackageInstallOptions
- StorePackageInstallOptions
Oggetto che specifica le opzioni di installazione per l'operazione.
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.
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)
|
Commenti
Usare questo metodo per scaricare e installare nuovi pacchetti DLC per l'app corrente. Questo overload consente di specificare se il sistema operativo può forzare il riavvio dell'app dopo aver installato i pacchetti DLC impostando la proprietà AllowForcedAppRestart del parametro storePackageInstallOptions .
Quando si chiama questo metodo, il sistema operativo visualizza una finestra di dialogo che indica all'utente che un pacchetto dell'app è disponibile per scaricare e installare e chiede all'utente l'autorizzazione per procedere con l'operazione. Se l'utente non concede l'autorizzazione, la proprietà OverallState del valore restituito StorePackageUpdateResult ha il valore Annullato. Per installare in modo automatico un pacchetto di app senza visualizzare una finestra di dialogo di notifica, usare DownloadAndInstallStorePackagesAsync (questo metodo richiede l'accesso a una funzionalità con restrizioni).
L'ID dello Store per un componente aggiuntivo DLC è 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 Archiviare gli ID.
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.
Nota
I pacchetti DLC non sono disponibili per tutti gli account per sviluppatori.
Vedi anche
- DownloadAndInstallStorePackagesAsync(IIterable<String>)
- Pacchetti facoltativi e creazione di set correlati
Si applica a
Commenti e suggerimenti
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedere https://aka.ms/ContentUserFeedback.
Invia e visualizza il feedback per