Condividi tramite

StoreContext.RequestDownloadAndInstallStorePackagesAsync Metodo

  • Riferimento

Definizione

Spazio dei nomi:
Windows.Services.Store

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>)

Modifica

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

storeIds

IIterable<String>

IEnumerable<String>

IIterable<Platform::String>

IIterable<winrt::hstring>

ID dello Store dei pacchetti del componente aggiuntivo DLC da installare.

Restituisce

IAsyncOperationWithProgress<StorePackageUpdateResult,StorePackageUpdateStatus>

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
RemoteAsyncAttribute

Eccezioni

COMException

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

Si applica a

RequestDownloadAndInstallStorePackagesAsync(IIterable<String>, StorePackageInstallOptions)

Modifica

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

storeIds

IIterable<String>

IEnumerable<String>

IIterable<Platform::String>

IIterable<winrt::hstring>

ID dello Store dei pacchetti del componente aggiuntivo DLC da installare.

storePackageInstallOptions
StorePackageInstallOptions

Oggetto che specifica le opzioni di installazione per l'operazione.

Restituisce

IAsyncOperationWithProgress<StorePackageUpdateResult,StorePackageUpdateStatus>

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
OverloadAttribute RemoteAsyncAttribute

Eccezioni

COMException

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

Si applica a