Freigeben über


StoreContext.RequestDownloadStorePackageUpdatesAsync Methode

Definition

Versucht, die angegebenen Paketupdates für die aktuelle App aus dem Microsoft Store herunterzuladen. Diese Methode zeigt auch ein Benutzeroberflächendialogfeld an, das die Berechtigung für den Vorgang anfordert.

Wichtig

Diese Methode muss im UI-Thread aufgerufen werden.

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)

Parameter

storePackageUpdates

IIterable<StorePackageUpdate>

IEnumerable<StorePackageUpdate>

Der Satz von StorePackageUpdate-Objekten , die die aktualisierten Pakete darstellen, die heruntergeladen werden sollen.

Gibt zurück

Ein Objekt, das der Aufrufer beobachten kann, um den Fortschritt und die Vervollständigung für den Vorgang nachzuverfolgen. Nach erfolgreicher Fertigstellung ist das Ergebnis ein StorePackageUpdateResult-Objekt , das Informationen zu den Paketupdates bereitstellt.

Attribute

Ausnahmen

Wenn die ErrorCode-Eigenschaft der Ausnahme den Wert 0x80070578 (ERROR_INVALID_WINDOW_HANDLE) aufweist, gibt dies an, dass die Methode im UI-Thread nicht aufgerufen wurde. Wenn Sie diese Methode in einer Desktopanwendung aufrufen, die die Desktop-Brücke verwendet, kann dies auch darauf hinweisen, dass Sie das <xref:Windows.Services.Store.StoreContext?text=StoreContext-Objekt> nicht konfiguriert haben, um anzugeben, welches Anwendungsfenster das Besitzerfenster für modale Dialoge ist, die von dieser Methode angezeigt werden. hier finden Sie weitere Informationen

Hinweise

Verwenden Sie die GetAppAndOptionalStorePackageUpdatesAsync-Methode , um die Liste der Verfügbaren Pakete abzurufen. Nachdem Sie die Pakete heruntergeladen haben, können Sie sie mithilfe der RequestDownloadAndInstallStorePackageUpdatesAsync-Methode installieren. Weitere Informationen zur Verwendung dieser Methode, einschließlich eines Codebeispiels, finden Sie unter Herunterladen und Installieren von Paketupdates für Ihre App.

Dieser Vorgang wird nicht blockiert. Das von dieser Methode zurückgegebene IAsyncOperationWithProgress-Objekt wird nach dem Herunterladen der Updatepakete abgeschlossen.

Wenn Sie diese Methode aufrufen, zeigt das Betriebssystem ein Dialogfeld an, das dem Benutzer mitteilt, dass ein App-Update zum Herunterladen verfügbar ist, und fragt die Berechtigung des Benutzers, mit dem Download fortzufahren. Wenn der Benutzer keine Berechtigung zum Starten des Downloads erteilt, weist die OverallState-Eigenschaft des StorePackageUpdateResult-Rückgabewerts den Wert Canceled auf.

Die Methode, die Sie zum Verarbeiten von Statusbenachrichtigungen zuweisen, wird für jeden Schritt im Downloadprozess für jedes Paket in dieser Anforderung einmal aufgerufen. Der Progress-Handler empfängt ein StorePackageUpdateStatus-Argument , das Informationen zum Updatepaket bereitstellt, das die Statusbenachrichtigung ausgelöst hat.

Gilt für:

Weitere Informationen