StoreContext.RequestDownloadAndInstallStorePackagesAsync 方法

  • 參考

定義

命名空間:
Windows.Services.Store

多載

RequestDownloadAndInstallStorePackagesAsync(IIterable<String>)

嘗試從 Microsoft Store 下載並安裝目前應用程式的指定可下載內容 (DLC) 套件。 這個方法也會顯示要求作業許可權的 UI 對話方塊。

重要

這個方法必須在 UI 執行緒上呼叫。
RequestDownloadAndInstallStorePackagesAsync(IIterable<String>, StorePackageInstallOptions)

嘗試從 Microsoft Store 下載並安裝指定的可下載內容 (DLC) 套件，以及指定的安裝選項。 這個方法也會顯示要求作業許可權的 UI 對話方塊。

重要

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

RequestDownloadAndInstallStorePackagesAsync(IIterable<String>)

編輯

嘗試從 Microsoft Store 下載並安裝目前應用程式的指定可下載內容 (DLC) 套件。 這個方法也會顯示要求作業許可權的 UI 對話方塊。

重要

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

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)

參數

storeIds

IIterable<String>

IEnumerable<String>

IIterable<Platform::String>

IIterable<winrt::hstring>

要安裝的 DLC 附加元件套件存放區識別碼。

傳回

IAsyncOperationWithProgress<StorePackageUpdateResult,StorePackageUpdateStatus>

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

屬性
RemoteAsyncAttribute

例外狀況

COMException

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

備註

使用這個方法來下載並安裝目前應用程式的新 DLC 套件。 當您呼叫此方法時，OS 會顯示對話方塊，告知使用者應用程式套件可供下載並安裝，並要求使用者的許可權繼續進行作業。 如果使用者未授與許可權，StorePackageUpdateResult傳回值的OverallState屬性具有Canceled值。 若要以無訊息方式安裝應用程式套件而不顯示通知對話方塊，請使用 DownloadAndInstallStorePackagesAsync (此方法需要存取受限制的功能) 。

DLC 附加元件的市集識別碼可在合作夥伴中心取得，而且也會由代表 DLC 附加元件的StoreProduct 的 StoreId屬性傳回。 如需詳細資訊，請參閱 存放區識別碼。

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

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

注意

所有開發人員帳戶都無法使用可下載的內容 (DLC) 套件。

另請參閱

適用於

RequestDownloadAndInstallStorePackagesAsync(IIterable<String>, StorePackageInstallOptions)

編輯

嘗試從 Microsoft Store 下載並安裝指定的可下載內容 (DLC) 套件，以及指定的安裝選項。 這個方法也會顯示要求作業許可權的 UI 對話方塊。

重要

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

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)

參數

storeIds

IIterable<String>

IEnumerable<String>

IIterable<Platform::String>

IIterable<winrt::hstring>

要安裝的 DLC 附加元件套件存放區識別碼。

storePackageInstallOptions
StorePackageInstallOptions

物件，指定作業的安裝選項。

傳回

IAsyncOperationWithProgress<StorePackageUpdateResult,StorePackageUpdateStatus>

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

屬性
OverloadAttribute RemoteAsyncAttribute

例外狀況

COMException

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

Windows 需求

裝置系列
Windows 10, version 1803 (已於 10.0.17134.0 引進)
API contract
Windows.Services.Store.StoreContract (已於 v3.0 引進)

備註

使用這個方法來下載並安裝目前應用程式的新 DLC 套件。 此多載提供選項，指定 OS 是否可以藉由設定storePackageInstallOptions參數的AllowForcedAppRestart屬性，強制應用程式在安裝 DLC 套件之後重新開機。

當您呼叫此方法時，OS 會顯示對話方塊，告知使用者應用程式套件可供下載並安裝，並要求使用者的許可權繼續進行作業。 如果使用者未授與許可權，StorePackageUpdateResult傳回值的OverallState屬性具有Canceled值。 若要以無訊息方式安裝應用程式套件而不顯示通知對話方塊，請使用 DownloadAndInstallStorePackagesAsync (此方法需要存取受限制的功能) 。

DLC 附加元件的市集識別碼可在合作夥伴中心取得，而且也會由代表 DLC 附加元件的StoreProduct 的 StoreId屬性傳回。 如需詳細資訊，請參閱 存放區識別碼。

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

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

注意

DLC 套件不適用於所有開發人員帳戶。

另請參閱

適用於