共用方式為

StoreContext.RequestDownloadStorePackageUpdatesAsync 方法

  • 參考

定義

命名空間:
Windows.Services.Store
編輯

嘗試從 Microsoft Store 下載目前應用程式的指定套件更新。 這個方法也會顯示要求作業許可權的 UI 對話方塊。

重要

必須在 UI 執行緒上呼叫這個方法。

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)

參數

storePackageUpdates

IIterable<StorePackageUpdate>

IEnumerable<StorePackageUpdate>

一組 StorePackageUpdate物件，這些物件代表要下載的更新套件。

傳回

IAsyncOperationWithProgress<StorePackageUpdateResult,StorePackageUpdateStatus>

呼叫端可以觀察的物件，可追蹤作業的進度和完成。 成功完成時，結果是 StorePackageUpdateResult 物件，可提供套件更新的相關資訊。

屬性
RemoteAsyncAttribute

例外狀況

COMException

如果例外狀況的 ErrorCode 屬性具有值0x80070578 (ERROR_INVALID_WINDOW_HANDLE) ，這表示方法未在 UI 執行緒上呼叫。 如果您在使用傳統型橋接器的桌面應用程式中呼叫此方法，這也表示您未 < 設定 xref：Windows.Services.Store.StoreCoNtext？text=StoreCoNtext > 物件，以指定哪個應用程式視窗是此方法所顯示模式對話方塊的擁有者視窗。 如需詳細資訊，請參閱這篇文章。

備註

若要取得具有可用更新的套件清單，請使用 GetAppAndOptionalStorePackageUpdatesAsync 方法。 下載套件之後，您可以使用 RequestDownloadAndInstallStorePackageUpdatesAsync 方法來安裝這些套件。 如需使用此方法的詳細資訊，包括程式碼範例，請參閱 下載並安裝應用程式的套件更新。

這項作業不會封鎖。 此方法傳回的 IAsyncOperationWithProgress 物件會在下載更新套件之後完成。

當您呼叫此方法時，OS 會顯示對話方塊，告知使用者應用程式更新可供下載，並要求使用者的許可權繼續進行下載。 如果使用者未授與開始下載的許可權，StorePackageUpdateResult傳回值的OverallState屬性具有Canceled值。

您指派處理 Progress 通知的方法會針對此要求中每個套件的下載程式中的每個步驟呼叫一次。 Progress處理常式會接收StorePackageUpdateStatus引數，提供引發進度通知之更新套件的相關資訊。

適用於

另請參閱